Amazon Elastic Compute Cloud (Amazon EC2) is a web service that provides resizable compute capacity in the cloud. It is designed to make web-scale cloud computing easier for developers.
Enable this integration to see in Datadog all your EC2 metrics, and additional events like scheduled maintenances.
If you haven’t already, set up the Amazon Web Services integration first.
In the AWS integration tile, navigate to the Configuration tab and ensure that EC2 is checked under Limit metric collection by AWS Service.
Add the following permissions to your Datadog IAM policy in order to collect Amazon EC2 metrics. For more information on EC2 policies, review the documentation on the AWS website.
| AWS Permission | Description |
|---|---|
ec2:DescribeInstanceStatus | Used by the ELB integration to assert the health of an instance. Used by the EC2 integration to describe the health of all instances. |
ec2:DescribeSecurityGroups | Adds SecurityGroup names and custom tags to ec2 instances. |
ec2:DescribeInstances | Adds tags to ec2 instances and ec2 cloudwatch metrics. |
Install the Datadog - AWS EC2 integration.
Note: If you want to monitor a subset of your EC2 instances with Datadog, assign an AWS tag, such as datadog:true, to those EC2 instances. Then specify that tag in the Optionally limit metrics collection textbox in your Datadog AWS integration tile.
Datadog can proactively mute monitors related to the manual shutdown of EC2 instances and instance termination triggered by AWS autoscaling based on host statuses from the Cloudwatch API. Automuted EC2 instances are listed on the Monitor Downtime page by checking Show automatically muted hosts.
Note, the EC2 integration must be installed for automuting to take effect. If metrics collection is limited to hosts with tags, only instances matching the tags are automuted.
To silence monitors for expected EC2 instance shutdowns, check the EC2 automuting box in the AWS integration tile:
Follow the steps below to install the Datadog Agent on an EC2 instance with AWS Systems Manager. See Why should I install the Datadog Agent on my cloud instances? to learn the benefit of installing the Agent on your AWS EC2 instances.
In the Parameter Store, create a parameter with:
dd-api-key-for-ssmSecureStringMy current accountIn the Systems Manager, create a new Document:
dd-agent-installCommand documentJSONIf you are in Datadog US site, use the file dd-agent-install-us-site.json updated with your <AWS_REGION> under runCommand (e.g. us-east-1). If you are in Datadog EU site, use the dd-agent-install-eu-site.json instead.
Under Run Command, click the Run command button and follow the steps below:
Click the Run button and a confirmation page displays showing the status. Wait for it to finish, then check the Infrastructure list in Datadog.
Use the Datadog Agent or another log shipper to send your logs to Datadog.
| aws.ec2.cpucredit_balance (gauge) | Number of CPU credits that an instance has accumulated. Shown as unit |
| aws.ec2.cpucredit_usage (gauge) | Number of CPU credits consumed. Shown as unit |
| aws.ec2.cpusurplus_credit_balance (gauge) | The number of surplus credits that have been spent by an unlimited instance when its CPUCreditBalance value is zero. Shown as unit |
| aws.ec2.cpusurplus_credits_charged (gauge) | The number of spent surplus credits that are not paid down by earned CPU credits, and which thus incur an additional charge. Shown as unit |
| aws.ec2.cpuutilization (gauge) | Average percentage of allocated EC2 compute units that are currently in use on the instance. Shown as percent |
| aws.ec2.cpuutilization.maximum (gauge) | Maximum percentage of allocated EC2 compute units that are currently in use on the instance. Shown as percent |
| aws.ec2.disk_read_bytes (gauge) | Bytes read from all ephemeral disks available to the instance. Shown as byte |
| aws.ec2.disk_read_ops (gauge) | Completed read operations from all ephemeral disks available to the instance. Shown as operation |
| aws.ec2.disk_write_bytes (gauge) | Bytes written to all ephemeral disks available to the instance. Shown as byte |
| aws.ec2.disk_write_ops (gauge) | Completed write operations to all ephemeral disks available to the instance. Shown as operation |
| aws.ec2.ebsbyte_balance (gauge) | Available only for the smaller instance sizes. Provides information about the percentage of throughput credits remaining in the burst bucket. This metric is available for basic monitoring only. Shown as percent |
| aws.ec2.ebsiobalance (gauge) | Available only for the smaller instance sizes. Provides information about the percentage of I/O credits remaining in the burst bucket. This metric is available for basic monitoring only. Shown as percent |
| aws.ec2.ebsread_bytes (gauge) | Bytes read from all EBS volumes attached to the instance in a specified period of time. Shown as byte |
| aws.ec2.ebsread_ops (count) | Completed read operations from all Amazon EBS volumes attached to the instance in a specified period of time. Shown as operation |
| aws.ec2.ebswrite_bytes (gauge) | Bytes written to all EBS volumes attached to the instance in a specified period of time. Shown as byte |
| aws.ec2.ebswrite_ops (count) | Completed write operations to all EBS volumes attached to the instance in a specified period of time. Shown as operation |
| aws.ec2.host_ok (gauge) | 1 if the instance's system status is ok. |
| aws.ec2.instance_age (gauge) | Time since instance launch Shown as second |
| aws.ec2.network_in (gauge) | Average number of bytes received on all network interfaces by the instance. Shown as byte |
| aws.ec2.network_in.maximum (gauge) | Maximum number of bytes received on all network interfaces by the instance. Shown as byte |
| aws.ec2.network_out (gauge) | Average number of bytes sent out on all network interfaces by the instance. Shown as byte |
| aws.ec2.network_out.maximum (gauge) | Maximum number of bytes sent out on all network interfaces by the instance. Shown as byte |
| aws.ec2.network_packets_in (gauge) | Number of packets received on all network interfaces by the instance Shown as packet |
| aws.ec2.network_packets_out (gauge) | Number of packets sent out on all network interfaces by the instance Shown as packet |
| aws.ec2.status_check_failed_instance (gauge) | 0 if the instance has passed the EC2 instance status check. |
| aws.ec2.status_check_failed_system (gauge) | 0 if the instance has passed the EC2 system status check. |
| aws.ec2.status_check_failed (gauge) | 1 if one of the status checks failed. |
Each of the metrics retrieved from AWS is assigned the same tags that appear in the AWS console, including but not limited to host name, security-groups, and more.
Note: aws.ec2.instance_age is not collected by default with Datadog - EC2 integration. Contact us to enable this metric collection.
aws.ec2.host_status
Returns your EC2 instance status as reported by the AWS console. Returns CRITICAL when there is a problem with your instance. Returns UNKNOWN when AWS does not have sufficient data to run a status check. Returns OK when your instance is running or is shut down properly.
The AWS EC2 integration includes events for scheduled and upcoming maintenance along with instance warnings. See example events below:
Need help? Contact Datadog support.
