Amazon FSx

Overview

Amazon FSx is a fully managed service that provides scalable storage for Windows File Server or Lustre.

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

Setup

Installation

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

Metric collection

  1. In the AWS integration page, ensure that FSx is enabled under the Metric Collection tab.

  2. Add the following permissions to your Datadog IAM policy in order to collect AWS FSx metrics.

    AWS PermissionDescription
    fsx:ListTagsForResourceUsed to add FSx custom tags.
    fsx:DescribeFileSystemsUsed to provide storage and throughput capacity.

  3. Install the Datadog - Amazon FSx integration.

Log collection

Audit event logs for FSx for Windows File Server

To track all user accesses of individual files, folders, and file shares, integrate the audit event logs from your FSx for Windows File Server:

  1. Enable the file access auditing feature for your file systems and send the logs to CloudWatch.
  2. If you haven’t already, set up the Datadog log collection AWS Lambda function (version 3.35.0+).
  3. Once the Lambda function is installed, manually add a trigger on the /aws/fsx/windows CloudWatch log group in the AWS console:
    cloudwatch log group
    Select the corresponding CloudWatch Log group, add a filter name (or leave the filter empty), and add the trigger:
    cloudwatch trigger
  4. Go to the Datadog Log section to start exploring your logs!

Note: You can also send these logs to Datadog with Kinesis Data Firehose, but you must create a custom log processor to get the same log parsing functionality and search experience.

FSx API activity

Amazon FSx is integrated with AWS CloudTrail which tracks every FSx action taken by a user, role, or AWS service. Enable Datadog’s CloudTrail Integration to monitor all FSx API calls in your AWS account.

Metrics

aws.fsx.data_read_bytes
(count)		The total number of bytes for file system read operations.
Shown as byte
aws.fsx.data_read_bytes.average
(gauge)		The average number of bytes associated with read operations per disk.
Shown as byte
aws.fsx.data_read_bytes.maximum
(gauge)		The maximum number of bytes associated with read operations on a single disk.
Shown as byte
aws.fsx.data_read_bytes.minimum
(gauge)		The minimum number of bytes associated with read operations on a single disk.
Shown as byte
aws.fsx.data_read_bytes.samplecount
(count)		The number of disks on the file system.
aws.fsx.data_read_operations
(count)		The number of read operations.
Shown as operation
aws.fsx.data_read_operations.average
(gauge)		The average number of read operations per disk.
Shown as operation
aws.fsx.data_read_operations.maximum
(gauge)		The maximum number of read operations on a single disk.
Shown as operation
aws.fsx.data_read_operations.minimum
(gauge)		The minimum number of read operations on a single disk.
Shown as operation
aws.fsx.data_read_operations.samplecount
(count)		The number of disks on the file system.
aws.fsx.data_write_bytes
(count)		The total number of bytes for file system write operations.
Shown as byte
aws.fsx.data_write_bytes.average
(gauge)		The average number of bytes for file system write operations per disk.
Shown as byte
aws.fsx.data_write_bytes.maximum
(gauge)		The maximum number of bytes for file system write operations on a single disk.
Shown as byte
aws.fsx.data_write_bytes.minimum
(gauge)		The minimum number of bytes for file system write operations on a single disk.
Shown as byte
aws.fsx.data_write_bytes.samplecount
(count)		The number of disks on the file system.
aws.fsx.data_write_operations
(count)		The number of write operations.
Shown as operation
aws.fsx.data_write_operations.average
(gauge)		The average number of write operations per disk.
Shown as operation
aws.fsx.data_write_operations.maximum
(gauge)		The maximum number of write operations on a single disk.
Shown as operation
aws.fsx.data_write_operations.minimum
(gauge)		The minimum number of write operations on a single disk.
Shown as operation
aws.fsx.data_write_operations.samplecount
(count)		The number of disks on the file system.
aws.fsx.free_data_storage_capacity
(gauge)		The average number of bytes available per disk.
Shown as byte
aws.fsx.free_data_storage_capacity.maximum
(gauge)		The total number of bytes available in the disk with the most remaining available storage.
Shown as byte
aws.fsx.free_data_storage_capacity.minimum
(gauge)		The total number bytes available in the fullest disk.
Shown as byte
aws.fsx.free_data_storage_capacity.samplecount
(count)		The number of disks on the file system.
aws.fsx.free_data_storage_capacity.sum
(count)		The total number of bytes available in the file system.
Shown as byte
aws.fsx.free_storage_capacity
(gauge)		The average amount of available storage capacity.
Shown as byte
aws.fsx.free_storage_capacity.minimum
(gauge)		The minimum amount of available storage capacity.
Shown as byte
aws.fsx.metadata_operations
(count)		The number of metadata operations.
Shown as operation
aws.fsx.metadata_operations.average
(gauge)		The average number of metadata operations per disk.
Shown as operation
aws.fsx.metadata_operations.maximum
(gauge)		The maximum number of metadata operations per disk.
Shown as operation
aws.fsx.metadata_operations.minimum
(gauge)		The minimum number of metadata operations per disk.
Shown as operation
aws.fsx.metadata_operations.samplecount
(count)		The number of disks on the file system.
aws.fsx.storage_capacity
(gauge)		The total storage capacity.
Shown as byte
aws.fsx.throughput_capacity
(gauge)		The throughput capacity of your storage.
Shown as byte

Events

The Amazon FSx integration does not include any events.

Service Checks

The Amazon FSx integration does not include any service checks.

Troubleshooting

Need help? Contact Datadog support.