Amazon CloudWatch
User Guide

Create a Storage Throughput Alarm that Sends Email

You can set up an SNS notification and configure an alarm that sends email when Amazon EBS exceeds 100 MB throughput.

Set Up a Storage Throughput Alarm Using the AWS Management Console

To create a storage throughput alarm that sends email

  1. Open the CloudWatch console at

  2. In the navigation pane, choose Alarms, Create Alarm.

  3. Under EBS Metrics, choose a metric category.

  4. Select the row with the volume and the VolumeWriteBytes metric.

  5. For the statistic, choose Average. For the period, choose 5 Minutes. Choose Next.

  6. Under Alarm Threshold, type a unique name for the alarm (for example, myHighWriteAlarm) and a description of the alarm (for example, VolumeWriteBytes exceeds 100,000 KiB/s). Alarm names must contain only ASCII characters.

  7. Under Whenever, for is, choose > and type 100000. For for, type 15 consecutive periods.

    A graphical representation of the threshold is shown under Alarm Preview.

  8. Under Additional settings, for Treat missing data as, choose ignore (maintain alarm state) so that missing data points do not trigger alarm state changes.

  9. Under Actions, for Whenever this alarm, choose State is ALARM. For Send notification to, chose an existing SNS topic or create one.

    To create an SNS topic, choose New list. For Send notification to, type a name for the SNS topic (for example, myHighCpuAlarm), and for Email list, type a comma-separated list of email addresses to be notified when the alarm changes to the ALARM state. Each email address is sent a topic subscription confirmation email. You must confirm the subscription before notifications can be sent to an email address.

  10. Choose Create Alarm.

Set Up a Storage Throughput Alarm Using the AWS CLI

To create a storage throughput alarm that sends email

  1. Create an SNS topic. For more information, see Set Up Amazon SNS Notifications.

  2. Create the alarm.

    aws cloudwatch put-metric-alarm --alarm-name ebs-mon --alarm-description "Alarm when EBS volume exceeds 100MB throughput" --metric-name VolumeReadBytes --namespace AWS/EBS --statistic Average --period 300 --threshold 100000000 --comparison-operator GreaterThanThreshold --dimensions Name=VolumeId,Value=my-volume-id --evaluation-periods 3 --alarm-actions arn:aws:sns:us-east-1:111122223333:my-alarm-topic --insufficient-data-actions arn:aws:sns:us-east-1:111122223333:my-insufficient-data-topic
  3. Test the alarm by forcing an alarm state change using the set-alarm-state command.

    1. Change the alarm state from INSUFFICIENT_DATA to OK:

      aws cloudwatch set-alarm-state --alarm-name ebs-mon --state-reason "initializing" --state-value OK
    2. Change the alarm state from OK to ALARM:

      aws cloudwatch set-alarm-state --alarm-name ebs-mon --state-reason "initializing" --state-value ALARM
    3. Change the alarm state from ALARM to INSUFFICIENT_DATA:

      aws cloudwatch set-alarm-state --alarm-name ebs-mon --state-reason "initializing" --state-value INSUFFICIENT_DATA
    4. Check that you have received an email notification about the alarm.