The Service Map for APM is here!

AWS Elastic File System

Crawler Crawler

Overview

Amazon EFS provides simple, scalable file storage for use with Amazon EC2 instances in the AWS Cloud.

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

Setup

Installation

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

Configuration

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

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

    • elasticfilesystem:DescribeTags: Gets custom tags applied to file systems
    • elasticfilesystem:DescribeFileSystems: Provides a list of active file systems

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

  3. Install the Datadog - AWS EFS integration.

Data Collected

Metrics

aws.efs.client_connections
(count)
Number of Amazon EC2 instances that are connected to a file system
aws.efs.data_write_iobytes
(count)
Sum of the number bytes associated with write operations.
shown as byte
aws.efs.data_write_iobytes.minimum
(count)
Size of the smallest write operation during the period.
shown as byte
aws.efs.data_write_iobytes.maximum
(count)
Size of the largest write operation during the period.
shown as byte
aws.efs.data_write_iobytes.average
(count)
Average size of write operations during the period.
shown as byte
aws.efs.data_read_iobytes
(count)
Total number of bytes associated with read operations.
shown as byte
aws.efs.data_read_iobytes.minimum
(count)
Size of the smallest read operation during the period.
shown as byte
aws.efs.data_read_iobytes.maximum
(count)
Size of the largest read operation during the period.
shown as byte
aws.efs.data_read_iobytes.average
(count)
Average size of read operations during the period.
shown as byte
aws.efs.total_iobytes
(count)
Total number of bytes associated with all file system operations
shown as byte
aws.efs.total_iobytes.minimum
(count)
Size of the smallest operation during a period.
shown as byte
aws.efs.total_iobytes.maximum
(count)
Size of the largest operation during the period.
shown as byte
aws.efs.total_iobytes.average
(count)
Average size of an operation during the period
shown as byte
aws.efs.metadata_iobytes
(count)
Total number of bytes associated with metadata operations.
shown as byte
aws.efs.metadata_iobytes.minimum
(count)
Size of the smallest metadata operation during the period.
shown as byte
aws.efs.metadata_iobytes.maximum
(count)
Size of the largest metadata operation during the period.
shown as byte
aws.efs.metadata_iobytes
(count)
Size of the average metadata operation during the period.
shown as byte
aws.efs.burst_credit_balance.minimum
(gauge)
Smallest burst credit balance for any minute during the period.
shown as byte
aws.efs.burst_credit_balance.maximum
(gauge)
Largest burst credit balance for any minute during the period.
shown as byte
aws.efs.burst_credit_balance
(gauge)
Average burst credit balance during the period.
shown as byte
aws.efs.permitted_throughput.minimum
(gauge)
Smallest throughput permitted for any minute during the period.
shown as byte
aws.efs.permitted_throughput.maximum
(gauge)
Highest throughput permitted for any minute during the period.
shown as byte
aws.efs.permitted_throughput
(gauge)
Average throughput permitted during the period.
shown as byte
aws.efs.percent_io_limit
(gauge)
How close a file system is to reaching the I/O limit of the General Purpose performance mode.
shown as percent

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.

Events

The AWS Elastic File System integration does not include any event at this time.

Service Checks

The AWS Elastic File System integration does not include any service check at this time.

Troubleshooting

Need help? Contact Datadog Support.