Menu
AWS CodeDeploy
User Guide (API Version 2014-10-06)

Monitoring Deployments in AWS CodeDeploy

Monitoring is an important part of maintaining the reliability, availability, and performance of AWS CodeDeploy and your AWS solutions. You should collect monitoring data from all of the parts of your AWS solution so that you can more easily debug a multi-point failure if one occurs. Before you start monitoring AWS CodeDeploy; however, you should create a monitoring plan that includes answers to the following questions:

  • What are your monitoring goals?

  • What resources will you monitor?

  • How often will you monitor these resources?

  • What monitoring tools will you use?

  • Who will perform the monitoring tasks?

  • Who should be notified when something goes wrong?

The next step is to establish a baseline for normal AWS CodeDeploy performance in your environment, by measuring performance at various times and under different load conditions. As you monitor AWS CodeDeploy, store historical monitoring data so that you can compare it with current performance data, identify normal performance patterns and performance anomalies, and devise methods to address issues.

For example, if you're using AWS CodeDeploy, you can monitor the status of deployments and target instances. When deployments or instances fail, you might need to reconfigure an application specification file, reinstall or update the AWS CodeDeploy agent, update settings in an application or deployment group, or make changes to instance settings or an AppSpec file.

To establish a baseline, you should, at a minimum, monitor the following items:

  • Deployment events and status

  • Instance events and status

Automated Monitoring Tools

AWS provides various tools that you can use to monitor AWS CodeDeploy. You can configure some of these tools to do the monitoring for you, while some of the tools require manual intervention. We recommend that you automate monitoring tasks as much as possible.

You can use the following automated monitoring tools to watch AWS CodeDeploy and report when something is wrong:

Manual Monitoring Tools

Another important part of monitoring AWS CodeDeploy involves manually monitoring those items that the CloudWatch alarms don't cover. The AWS CodeDeploy, CloudWatch, and other AWS console dashboards provide an at-a-glance view of the state of your AWS environment. We recommend that you also check the log files on AWS CodeDeploy deployments.

  • AWS CodeDeploy console shows:

    • The status of deployments

    • The date and time of each last attempted and last successful deployment of a revision

    • The number of instances that succeeded, failed, were skipped, or are in progress in a deployment

    • The status of on-premises instances

    • The date and time when on-premises instances were registered or deregistered

  • CloudWatch home page shows:

    • Current alarms and status

    • Graphs of alarms and resources

    • Service health status

    In addition, you can use CloudWatch to do the following:

    • Create customized dashboards to monitor the services you care about

    • Graph metric data to troubleshoot issues and discover trends

    • Search and browse all your AWS resource metrics

    • Create and edit alarms to be notified of problems

Topics