Logging is here!

AWS EC2

Crawler Crawler

Overview

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.

Setup

Installation

If you haven’t already, set up the Amazon Web Services integration first.

Configuration

  1. In the AWS integration tile, ensure that EC2 is checked under metric collection.

  2. Add those permissions to your Datadog IAM policy in order to collect Amazon EC2 metrics:

    • 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.

    For more information on EC2 policies, review the documentation on the AWS website.

  3. Install the Datadog - AWS EC2 integration.

Note: If you want to only monitor a subset of your EC2 instances on AWS, tag them and specify the tag in the limit textbox in your AWS integration tile.

Log collection

Use the Datadog Agent or another log shipper to send your logs to Datadog.

Data Collected

Metrics

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.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.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
(gauge)
1 if one of the status checks failed.
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.host_ok
(gauge)
1 if the instance's system status is ok.
aws.ec2.instance_age
(gauge)
Time since instance launch
shown as second

Each of the metrics retrieved from AWS will be 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.

Events

The AWS EC2 integration does not include any event at this time.

Service Checks

aws.ec2.host_status
Returns your EC2 instance statuses 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.

Troubleshooting

Need help? Contact Datadog Support.

Further Reading