---
title: Amazon FSx
description: >-
  Amazon FSx is a fully managed service that provides scalable storage for
  Windows File Server or Lustre.
breadcrumbs: Docs > Integrations > Amazon FSx
---

# Amazon FSx
Integration version1.0.0
## Overview{% #overview %}

Amazon FSx is a fully managed service that provides scalable storage for NetApp ONTAP, OpenZFS, Windows File Server, and Lustre file systems.

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

## Setup{% #setup %}

### Installation{% #installation %}

If you haven't already, set up the [Amazon Web Services integration](https://docs.datadoghq.com/integrations/amazon_web_services/) first.

### Metric collection{% #metric-collection %}

1. In the [AWS integration page](https://app.datadoghq.com/integrations/amazon-web-services), ensure that `FSx` is enabled under the `Metric Collection` tab.

1. Add the following permissions to your [Datadog IAM policy](https://docs.datadoghq.com/integrations/amazon_web_services/#installation) in order to collect Amazon FSx metrics.

| AWS Permission            | Description                                      |
| ------------------------- | ------------------------------------------------ |
| `fsx:ListTagsForResource` | Used to add FSx custom tags.                     |
| `fsx:DescribeFileSystems` | Used to provide storage and throughput capacity. |

1. Install the [Datadog - Amazon FSx integration](https://app.datadoghq.com/integrations/amazon-fsx).

### Log collection{% #log-collection %}

#### Audit event logs for FSx for Windows File Server{% #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](https://docs.aws.amazon.com/fsx/latest/WindowsGuide/file-access-auditing.html#faa-log-destinations) for your file systems and send the logs to CloudWatch.
1. If you haven't already, set up the [Datadog log collection AWS Lambda function](https://app.datadoghq.com/integrations/amazon-fsx) (version 3.35.0+).
1. Once the Lambda function is installed, manually add a trigger on the `/aws/fsx/windows` CloudWatch log group in the AWS console:  Select the corresponding CloudWatch Log group, add a filter name (or leave the filter empty), and add the trigger:
1. Go to the [Datadog Log section](https://app.datadoghq.com/logs) to start exploring your logs!

**Note**: You can also send these logs to Datadog with [Amazon Data Firehose](https://docs.datadoghq.com/logs/guide/send-aws-services-logs-with-the-datadog-kinesis-firehose-destination/?tab=amazondatafirehosedeliverystream), but you must create a custom log [processor](https://docs.datadoghq.com/logs/log_configuration/processors/?tab=ui) to get the same log parsing functionality and search experience.

#### FSx API activity{% #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](https://docs.datadoghq.com/integrations/amazon_cloudtrail/#log-collection) to monitor all FSx API calls in your AWS account.

### Metrics{% #metrics %}

|  |
|  |
| **aws.fsx.age\_of\_oldest\_queued\_message**(gauge)                    | The average age of the oldest message waiting to be exported.*Shown as second*                                             |
| **aws.fsx.age\_of\_oldest\_queued\_message.maximum**(gauge)            | The maximum number of seconds a message lived in the export queue.*Shown as second*                                        |
| **aws.fsx.age\_of\_oldest\_queued\_message.minimum**(gauge)            | The minimum number of seconds a message lived in the export queue.*Shown as second*                                        |
| **aws.fsx.capacity\_pool\_read\_bytes**(count)                         | The total number of bytes read from the file system's capacity pool tier over a specified period.*Shown as byte*           |
| **aws.fsx.capacity\_pool\_read\_operations**(count)                    | The total number of read operations from the file system's capacity pool tier over a specified period.*Shown as operation* |
| **aws.fsx.capacity\_pool\_write\_bytes**(count)                        | The total number of bytes written to the file system's capacity pool tier over a specified period.*Shown as byte*          |
| **aws.fsx.capacity\_pool\_write\_operations**(count)                   | The total number of write operations to the file system's capacity pool tier over a specified period.*Shown as operation*  |
| **aws.fsx.client\_connections**(count)                                 | The number of active connections between clients and the file server.*Shown as connection*                                 |
| **aws.fsx.compression\_ratio**(gauge)                                  | Ratio of compressed storage usage to uncompressed storage usage.                                                           |
| **aws.fsx.cpuutilization**(gauge)                                      | The average CPU utilization of the file system over a specified period.*Shown as percent*                                  |
| **aws.fsx.cpuutilization.maximum**(gauge)                              | The highest CPU utilization of the file system over a specified period.*Shown as percent*                                  |
| **aws.fsx.cpuutilization.minimum**(gauge)                              | The lowest CPU utilization of the file system over a specified period.*Shown as percent*                                   |
| **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\_read\_operation\_time**(count)                         | The total number of seconds spent by read operations during the specified period.*Shown as second*                         |
| **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.data\_write\_operation\_time**(count)                        | The total number of seconds spent by write operations during the specified period.*Shown as second*                        |
| **aws.fsx.deduplication\_saved\_storage**(gauge)                       | The amount of storage space saved by data deduplication, if it is enabled.*Shown as byte*                                  |
| **aws.fsx.disk\_iops\_utilization**(gauge)                             | The average disk IOPS utilization of the file system over a specified period.*Shown as percent*                            |
| **aws.fsx.disk\_iops\_utilization.maximum**(gauge)                     | The maximum disk IOPS utilization of the file system over a specified period.*Shown as percent*                            |
| **aws.fsx.disk\_iops\_utilization.minimum**(gauge)                     | The minimum disk IOPS utilization of the file system over a specified period.*Shown as percent*                            |
| **aws.fsx.disk\_read\_bytes**(count)                                   | The total number of bytes read from the file system over a specified period.*Shown as byte*                                |
| **aws.fsx.disk\_read\_operations**(count)                              | The total number of read operations from the primary tier over a specified period.*Shown as operation*                     |
| **aws.fsx.disk\_throughput\_balance**(gauge)                           | The percentage of available burst credits for disk throughput for the storage volumes.*Shown as percent*                   |
| **aws.fsx.disk\_throughput\_utilization**(gauge)                       | The average disk throughput between your file server and its storage volumes.*Shown as percent*                             |
| **aws.fsx.disk\_throughput\_utilization.maximum**(gauge)               | The maximum disk throughput between your file server and its storage volumes.*Shown as percent*                             |
| **aws.fsx.disk\_throughput\_utilization.minimum**(gauge)               | The minimum disk throughput between your file server and its storage volumes.*Shown as percent*                             |
| **aws.fsx.disk\_write\_bytes**(count)                                  | The total number of bytes written from the file system over a specified period.*Shown as byte*                             |
| **aws.fsx.disk\_write\_operations**(count)                             | The total number of write operations from the primary tier over a specified period.*Shown as operation*                    |
| **aws.fsx.file\_server\_cache\_hit\_ratio**(gauge)                     | The average cache hit percent for the file system over a specified period.*Shown as percent*                               |
| **aws.fsx.file\_server\_disk\_iops\_balance**(gauge)                   | The average burst balance available for disk IOPS over a specified period.*Shown as percent*                               |
| **aws.fsx.file\_server\_disk\_iops\_balance.maximum**(gauge)           | The maximum burst balance available for disk IOPS over a specified period.*Shown as percent*                               |
| **aws.fsx.file\_server\_disk\_iops\_balance.minimum**(gauge)           | The minimum burst balance available for disk IOPS over a specified period.*Shown as percent*                               |
| **aws.fsx.file\_server\_disk\_iops\_utilization**(gauge)               | The average disk IOPS utilization of the file system over a specified period.*Shown as percent*                            |
| **aws.fsx.file\_server\_disk\_iops\_utilization.maximum**(gauge)       | The maximum disk IOPS utilization of the file system over a specified period.*Shown as percent*                            |
| **aws.fsx.file\_server\_disk\_iops\_utilization.minimum**(gauge)       | The minimum disk IOPS utilization of the file system over a specified period.*Shown as percent*                            |
| **aws.fsx.file\_server\_disk\_throughput\_balance**(gauge)             | The average burst balance available for disk throughput over a specified period.*Shown as percent*                         |
| **aws.fsx.file\_server\_disk\_throughput\_balance.maximum**(gauge)     | The maximum burst balance available for disk throughput over a specified period.*Shown as percent*                         |
| **aws.fsx.file\_server\_disk\_throughput\_balance.minimum**(gauge)     | The minimum burst balance available for disk throughput over a specified period.*Shown as percent*                         |
| **aws.fsx.file\_server\_disk\_throughput\_utilization**(gauge)         | The average percent utilization of the file servers' disk throughput over a specified period.*Shown as percent*            |
| **aws.fsx.file\_server\_disk\_throughput\_utilization.maximum**(gauge) | The highest percent utilization of the file servers' disk throughput over a specified period.*Shown as percent*            |
| **aws.fsx.file\_server\_disk\_throughput\_utilization.minimum**(gauge) | The lowest percent utilization of the file servers' disk throughput over a specified period.*Shown as percent*             |
| **aws.fsx.files\_capacity**(gauge)                                     | The total number of inodes that can be created on the volume.*Shown as file*                                               |
| **aws.fsx.files\_used**(count)                                         | The used files (number of files or inodes) on the volume.*Shown as file*                                                   |
| **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.logical\_data\_stored**(count)                               | The total amount of logical data stored on the file system.*Shown as byte*                                                 |
| **aws.fsx.logical\_disk\_usage**(count)                                | The total number of logical bytes stored in the file system.*Shown as byte*                                                |
| **aws.fsx.logical\_disk\_usage.average**(gauge)                        | The average number of logical bytes stored per disk.*Shown as byte*                                                        |
| **aws.fsx.logical\_disk\_usage.maximum**(gauge)                        | The largest number of logical bytes stored in a disk in the file system.*Shown as byte*                                    |
| **aws.fsx.logical\_disk\_usage.minimum**(gauge)                        | The least number of logical bytes stored in a disk in the file system.*Shown as byte*                                      |
| **aws.fsx.memory\_utilization**(gauge)                                 | The average utilization of your file server's memory resources.*Shown as percent*                                          |
| **aws.fsx.memory\_utilization.maximum**(gauge)                         | The highest utilization of your file server's memory resources.*Shown as percent*                                          |
| **aws.fsx.memory\_utilization.minimum**(gauge)                         | The lowest utilization of your file server's memory resources.*Shown as percent*                                           |
| **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\_operation\_time**(count)                           | The total number of seconds spent by read operations during the specified period.*Shown as second*                         |
| **aws.fsx.network\_throughput\_utilization**(gauge)                    | The average network throughput utilization of the file system.*Shown as percent*                                           |
| **aws.fsx.network\_throughput\_utilization.maximum**(gauge)            | The highest network throughput utilization of the file system.*Shown as percent*                                           |
| **aws.fsx.network\_throughput\_utilization.minimum**(gauge)            | The lowest network throughput utilization of the file system.*Shown as percent*                                            |
| **aws.fsx.network\_sent\_bytes**(count)                                | The total number of bytes sent by the file system over a specified period.*Shown as byte*                                  |
| **aws.fsx.network\_received\_bytes**(count)                            | The total number of bytes received by the file system over a specified period.*Shown as byte*                              |
| **aws.fsx.nfs\_bad\_calls**(count)                                     | Number of calls rejected by NFS server Remote Procedure Call (RPC) mechanism.*Shown as unit*                               |
| **aws.fsx.physical\_disk\_usage**(count)                               | The total number of bytes occupied in disks in the file system.*Shown as byte*                                             |
| **aws.fsx.physical\_disk\_usage.average**(gauge)                       | The average number of bytes occupied per disk.*Shown as byte*                                                              |
| **aws.fsx.physical\_disk\_usage.maximum**(gauge)                       | The total number of bytes occupied in the fullest disk.*Shown as byte*                                                     |
| **aws.fsx.physical\_disk\_usage.minimum**(gauge)                       | The total number of bytes occupied in the emptiest disk.*Shown as byte*                                                    |
| **aws.fsx.repository\_rename\_operations**(count)                      | The total number of rename operations that result from a directory rename.*Shown as operation*                             |
| **aws.fsx.repository\_rename\_operations.average**(gauge)              | The average number of rename operations for the file system.*Shown as operation*                                           |
| **aws.fsx.storage\_capacity**(gauge)                                   | The total storage capacity of the primary (SSD) tier.*Shown as byte*                                                       |
| **aws.fsx.storage\_capacity.average**(count)                           | Total storage capacity, equal to the sum of used and available storage capacity.*Shown as byte*                            |
| **aws.fsx.storage\_capacity\_utilization**(gauge)                      | The percentage of the volume's used physical disk space.*Shown as percent*                                                 |
| **aws.fsx.storage\_capacity\_utilization.average**(gauge)              | Average of the percentages of the volumes' used physical disk space.*Shown as percent*                                     |
| **aws.fsx.storage\_efficiency\_savings**(gauge)                        | The average storage efficiency savings over a specified period.*Shown as byte*                                             |
| **aws.fsx.storage\_used**(count)                                       | The total amount of physical data stored on the file system.*Shown as byte*                                                |
| **aws.fsx.used\_storage\_capacity**(gauge)                             | The amount of storage used.*Shown as byte*                                                                                 |
| **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{% #events %}

The Amazon FSx integration does not include any events.

### Service Checks{% #service-checks %}

The Amazon FSx integration does not include any service checks.

## Troubleshooting{% #troubleshooting %}

Need help? Contact [Datadog support](https://docs.datadoghq.com/help/).