Amazon Elastic Block Store

Docs > Integrations > Amazon Elastic Block Store

Overview

Amazon EBS provides persistent block storage volumes for use with Amazon EC2 instances in the AWS Cloud.

Enable this integration to see in Datadog all your EBS metrics.

Setup

Installation

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

Metric collection

In the AWS integration page, ensure that EBS is enabled under the Metric Collection tab.
Install the Datadog - Amazon EBS integration.

Note: This integration collects metrics for EBS volumes attached to a monitored EC2. To collect all EBS metrics, make sure that EC2 is checked in the AWS integration page and that the EC2 is not excluded from monitoring with the limit resource collection setting.

Log collection

Enable logging

Configure Amazon EBS to send logs either to a S3 bucket or to CloudWatch.

Note: If you log to a S3 bucket, make sure that amazon_ebs is set as Target prefix.

Send logs to Datadog

If you haven’t already, set up the Datadog Forwarder Lambda function.
Once the Lambda function is installed, manually add a trigger on the S3 bucket or CloudWatch log group that contains your Amazon EBS logs in the AWS console:
- Add a manual trigger on the S3 bucket
- Add a manual trigger on the CloudWatch Log Group

Data Collected

Metrics

aws.ebs.burst_balance (gauge)	Balance available in the burst bucket. This metric contains values for all volume types including io1. Shown as percent
aws.ebs.burst_balance.io1 (gauge)	Balance available in the burst bucket. Better granularity but only for io1 volumes. Shown as percent
aws.ebs.snapshot_age (gauge)	Time since the most recent complete snapshot was created Shown as second
aws.ebs.status.impaired (gauge)	The number of EBS volumes with the impaired status.
aws.ebs.status.insufficient_data (gauge)	The number of EBS volumes with the insufficient-data status.
aws.ebs.status.ok (gauge)	The number of EBS volumes with the ok status.
aws.ebs.status.warning (gauge)	The number of EBS volumes with the warning status.
aws.ebs.volume_consumed_read_write_ops (count)	The total amount of read and write operations (normalized to 256K capacity units). Only for io1 volume types.
aws.ebs.volume_idle_time (gauge)	The total number of seconds in a specified period of time when no read or write operations were submitted. This metric contains values for all volume types including io1. Shown as second
aws.ebs.volume_idle_time.io1 (gauge)	The total number of seconds in a specified period of time when no read or write operations were submitted. Better granularity but only for io1 volumes. Shown as second
aws.ebs.volume_queue_length (gauge)	The number of read and write operation requests waiting to be completed. This metric contains values for all volume types including io1.
aws.ebs.volume_queue_length.io1 (gauge)	The number of read and write operation requests waiting to be completed. Better granularity but only for io1 volumes.
aws.ebs.volume_read_bytes (gauge)	Average size of each read operation. This metric contains values for all volume types including io1. Shown as byte
aws.ebs.volume_read_bytes.io1 (gauge)	Average size of each read operation. Better granularity but only for io1 volumes. Shown as byte
aws.ebs.volume_read_bytes.sum (gauge)	Total number of bytes read by read operations. This metric contains values for all volume types including io1. Shown as byte
aws.ebs.volume_read_bytes.sum.io1 (gauge)	Total number of bytes read by read operations. Better granularity but only for io1 volumes. Shown as byte
aws.ebs.volume_read_ops (count)	The total number of read operations. This metric contains values for all volume types including io1. Shown as operation
aws.ebs.volume_read_ops.io1 (count)	The total number of read operations. Better granularity but only for io1 volumes. Shown as operation
aws.ebs.volume_throughput_percentage (gauge)	The percentage of I/O operations per second (IOPS) delivered of the total IOPS provisioned for an Amazon EBS volume. Only for io1 volume types. Shown as percent
aws.ebs.volume_total_read_time (gauge)	The Average time spent by read operations. This metric contains values for all volume types including io1. Shown as second
aws.ebs.volume_total_read_time.io1 (gauge)	The Average time spent by read operations. Better granularity but only for io1 volumes. Shown as second
aws.ebs.volume_total_read_time.sum (gauge)	The total number of seconds spent for read operations. This metric contains values for all volume types including io1. Shown as second
aws.ebs.volume_total_read_time.sum.io1 (gauge)	The total number of seconds spent for read operations. Better granularity but only for io1 volumes. Shown as second
aws.ebs.volume_total_write_time (gauge)	The average time spent by write operations. This metric contains values for all volume types including io1. Shown as second
aws.ebs.volume_total_write_time.io1 (gauge)	The average time spent by write operations. Better granularity but only for io1 volumes. Shown as second
aws.ebs.volume_total_write_time.sum (gauge)	The total number of seconds spent for write operations. This metric contains values for all volume types including io1. Shown as second
aws.ebs.volume_total_write_time.sum.io1 (gauge)	The total number of seconds spent for write operations. Better granularity but only for io1 volumes. Shown as second
aws.ebs.volume_write_bytes (gauge)	Average size of each write operation. This metric contains values for all volume types including io1. Shown as byte
aws.ebs.volume_write_bytes.io1 (gauge)	Average size of each write operation. Better granularity but only for io1 volumes. Shown as byte
aws.ebs.volume_write_bytes.sum (gauge)	Total amount of bytes written by write operations. This metric contains values for all volume types including io1. Shown as byte
aws.ebs.volume_write_bytes.sum.io1 (gauge)	Total amount of bytes written by write operations. Better granularity but only for io1 volumes. Shown as byte
aws.ebs.volume_write_ops (count)	The total number of write operations. This metric contains values for all volume types including io1. Shown as operation
aws.ebs.volume_write_ops.io1 (count)	The total number of write operations. Better granularity but only for io1 volumes. Shown as operation

Each of the metrics retrieved from AWS are assigned the same tags that appear in the AWS console, including but not limited to host name, security-groups, and more.

Events

The Amazon EBS integration does not include any events.

Service Checks

The Amazon EBS integration does not include any service checks.

Troubleshooting

Need help? Contact Datadog support.