Monitoring deployments with CloudWatch alarms in CodeDeploy
You can create a CloudWatch alarm for an instance or Amazon EC2 Auto Scaling group you are using in your CodeDeploy
operations. An alarm
watches a single metric over a time period you specify and performs one or more actions based
on the value of the metric relative to a given threshold over a number of time periods.
CloudWatch alarms invoke actions when their state changes (for example, from OK
to
ALARM
).
Using native CloudWatch alarm functionality, you can specify any of the actions supported by CloudWatch when an instance you are using in a deployment fails, such as sending an Amazon SNS notification or stopping, terminating, rebooting, or recovering an instance. For your CodeDeploy operations, you can configure a deployment group to stop a deployment whenever any CloudWatch alarm you associate with the deployment group is activated.
You can associate up to ten CloudWatch alarms with a CodeDeploy deployment group. If any of the specified alarms are activated, the deployment stops, and the status is updated to Stopped. To use this option, you must grant CloudWatch permissions to your CodeDeploy service role.
For information about setting up CloudWatch alarms in the CloudWatch console, see Creating Amazon CloudWatch alarms in the Amazon CloudWatch User Guide.
For information about associating a CloudWatch alarm with a deployment group in CodeDeploy, see Create a deployment group with CodeDeploy and Change deployment group settings with CodeDeploy.