Introduction
Amazon FSx makes it easy and cost effective to launch, run, and scale feature-rich, high-performance file systems in the cloud. It supports a wide range of workloads with its reliability, security, scalability, and broad set of capabilities. With Amazon FSx, you can choose between four widely used file systems: Lustre, NetApp ONTAP, OpenZFS, and Windows File Server. Amazon File Cache is a high-speed cache on AWS that makes it easier to process file data, regardless of where the data is stored.
Resource Information:
- Type of Resource: Generic monitorable resource
- Discovery type: AWS SDK discovery type
- Discovery profile selection: Resource can be discovered by “FSX File System” in the profiler
- ResourceTag: AWS_FSX_FILE_SYSTEM
- Resource Unique Identification: FileSystemId (fsx.fileSystemId())
- Dependencies: FSX File System may depend on VPC, subnets, and security groups for network access
Use OpsRamp AWS Public Cloud Integration to discover and collect metrics against FSx File Systems.
Setup
To set up the AWS integration and discover the FSX File Systems resources, do the following:
- Create an AWS Integration if not available in your installed integrations.
- Select
FSX File Systemsunder Filter by Resource Type to discover AWS AppSync. - Save the discovery profile to make them available in the list of Discovery Profiles.
- Scan to discover the resources at any time independent of the predefined schedule.
- Once the scan is completed, you can view the FSX File Systems resources under Infrastructure > Resources > AWS category.
Event support
CloudTrail Event support
OpsRamp supports AWS Cloud trail events for the FSX File Systems. Configure Stream CloudTrail messages in Opsramp AWS integration discovery profile.
CloudWatch Alarm support
OpsRamp supports AWS Cloud Watch Alarms for the FSX File Systems.
Supported metrics
| OpsRamp Metric | AWS Metric | Metric Display Name | Unit | Aggregation Type | Description |
|---|---|---|---|---|---|
| aws_fsx_DataReadBytes | DataReadBytes | Data Read Bytes | Bytes | Sum | The number of bytes for read operations for clients that access the file system. |
| aws_fsx_DataWriteBytes | DataWriteBytes | Data Write Bytes | Bytes | Sum | The number of bytes for write operations for clients that access the file system. |
| aws_fsx_DataReadOperations | DataReadOperations | Data Read Operations | Count | Sum | The number of read operations for clients that access the file system. |
| aws_fsx_DataWriteOperations | DataWriteOperations | Data Write Operations | Count | Sum | The number of write operations for clients that access the file system. |
| aws_fsx_ClientConnections | ClientConnections | Client Connections(LUSTRE,OPENZFS,WINDOWS) | Count | Average | The number of active connections between clients and the file server. |
| aws_fsx_MetadataOperations | MetadataOperations | Metadata Operations | Count | Sum | The number of metadata operations for clients that access the file system. |
| aws_fsx_NfsBadCalls | NfsBadCalls | Nfs Bad Calls(OPENZFS) | Count | Sum | The number of calls rejected by the NFS server remote procedure call (RPC) mechanism. |
| aws_fsx_NetworkThroughputUtilization | NetworkThroughputUtilization | Network Throughput Utilization(WINDOWS,OPENZFS,ONTAP) | Percent | Average | The network throughput for clients that access the file system, as a percentage of the provisioned limit. For Multi-AZ file systems, this includes replication traffic. |
| aws_fsx_CPUUtilization | CPUUtilization | CPU Utilization(WINDOWS,ONTAP,OPENZFS) | Percent | Average | The percentage utilization of your file server's CPU resources. |
| aws_fsx_FileServerDiskThroughputUtilization | FileServerDiskThroughputUtilization | File Server Disk Throughput Utilization(WINDOWS,OPENZFS,ONTAP) | Percent | Average | The disk throughput between your file server and its storage volumes, as a percentage of the provisioned limit determined by throughput capacity. |
| aws_fsx_FileServerDiskThroughputBalance | FileServerDiskThroughputBalance | File Server Disk Throughput Balance(WINDOWS,OPENZFS,ONTAP) | Percent | Average | The percentage of available burst credits for disk throughput between your file server and its storage volumes. |
| aws_fsx_FileServerDiskIopsUtilization | FileServerDiskIopsUtilization | File Server Disk Iops Utilization(WINDOWS,OPENZFS,ONTAP) | Percent | Average | The disk IOPS between your file server and storage volumes, as a percentage of the provisioned limit determined by throughput capacity. |
| aws_fsx_FileServerDiskIopsBalance | FileServerDiskIopsBalance | File Server Disk Iops Balance(WINDOWS,OPENZFS,ONTAP) | Percent | Average | The percentage of available burst credits for disk IOPS between your file server and its storage volumes. |
| aws_fsx_MemoryUtilization | MemoryUtilization | Memory Utilization(WINDOWS,OPENZFS) | Percent | Average | The percentage of your file server's memory resources that are utilized. |
| aws_fsx_FileServerCacheHitRatio | FileServerCacheHitRatio | File Server Cache Hit Ratio(OPENZFS,ONTAP) | Percent | Average | The percentage of cache hits. Reports cache hit ratio for both in-memory (ARC) and NVMe (L2ARC) caches. |
| aws_fsx_DiskReadBytes | DiskReadBytes | Disk Read Bytes(WINDOWS,OPENZFS,ONTAP) | Bytes | Sum | The number of bytes for read operations that access storage volumes. |
| aws_fsx_DiskWriteBytes | DiskWriteBytes | Disk Write Bytes(WINDOWS,OPENZFS,ONTAP) | Bytes | Sum | The number of bytes for write operations that access storage volumes. |
| aws_fsx_DiskReadOperations | DiskReadOperations | Disk Read Operations(WINDOWS,OPENZFS,ONTAP) | Count | Sum | The number of read operations for the file server that accesses storage volumes. |
| aws_fsx_DiskWriteOperations | DiskWriteOperations | Disk Write Operations(WINDOWS,OPENZFS,ONTAP) | Count | Sum | The number of write operations for the file server that accesses storage volumes. |
| aws_fsx_DiskThroughputBalance | DiskThroughputBalance | Disk Throughput Balance(WINDOWS,OPENZFS) | Percent | Average | The percentage of available burst credits for disk throughput for the storage volumes. |
| aws_fsx_DiskIopsUtilization | DiskIopsUtilization | Disk Iops Utilization(WINDOWS,OPENZFS,ONTAP) | Percent | Average | The disk IOPS between your file server and storage volumes, as a percentage of the provisioned IOPS limit determined by the storage volumes. |
| aws_fsx_StorageCapacity | StorageCapacity | Storage Capacity(OPENZFS,ONTAP) | Bytes | Maximum | The total storage capacity of the primary (SSD) tier. |
| aws_fsx_UsedStorageCapacity | UsedStorageCapacity | Used Storage Capacity(OPENZFS) | Bytes | Average | The amount of storage that is used. |
| aws_fsx_CompressionRatio | CompressionRatio | Compression Ratio(OPENZFS) | None | Average | The ratio of compressed storage usage to uncompressed storage usage. |
| aws_fsx_NetworkSentBytes | NetworkSentBytes | Network Sent Bytes(ONTAP) | Bytes | Sum | The number of bytes sent by the file system, including data movement to/from linked data repositories. |
| aws_fsx_NetworkReceivedBytes | NetworkReceivedBytes | Network Received Bytes(ONTAP) | Bytes | Sum | The number of bytes received by the file system, including data movement to/from linked data repositories. |
| aws_fsx_FileCreateOperations | FileCreateOperations | File Create Operations(LUSTRE) | Count | Sum | Total number of file create operations. |
| aws_fsx_FileOpenOperations | FileOpenOperations | File Open Operations(LUSTRE) | Count | Sum | Total number of file open operations. |
| aws_fsx_FileDeleteOperations | FileDeleteOperations | File Delete Operations(LUSTRE) | Count | Sum | Total number of file delete operations. |
| aws_fsx_StatOperations | StatOperations | Stat Operations(LUSTRE) | Count | Sum | Total number of stat operations. |
| aws_fsx_RenameOperations | RenameOperations | Rename Operations(LUSTRE) | Count | Sum | Total number of directory renames, whether in-place directory renames or cross directory renames. |
| aws_fsx_FreeDataStorageCapacity | FreeDataStorageCapacity | Free Data Storage Capacity(LUSTRE) | Bytes | Sum | The amount of available storage capacity in this OST. |
| aws_fsx_StorageCapacityUtilization | StorageCapacityUtilization | Storage Capacity Utilization(ONTAP) | Percent | Average | The storage capacity utilization for a given file system OST. |
| aws_fsx_StorageCapacityUtilizationWithCachedWrites | StorageCapacityUtilizationWithCachedWrites | Storage Capacity Utilization With Cached Writes(LUSTRE) | Percent | Average | The storage capacity utilization for a given file system OST including space reserved for cached writes on the client. |
| aws_fsx_LogicalDiskUsage | LogicalDiskUsage | Logical Disk Usage(LUSTRE) | Bytes | Sum | The amount of logical data stored (uncompressed). |
| aws_fsx_PhysicalDiskUsage | PhysicalDiskUsage | Physical Disk Usage(LUSTRE) | Bytes | Sum | The amount of storage physically occupied by file system data (compressed). |
| aws_fsx_lustre_AgeOfOldestQueuedMessage_AutoExport | AgeOfOldestQueuedMessage_AutoExport | Age Of Oldest Queued Message Auto Export(Lustre) | Seconds | Average | The age, in seconds, of the oldest message waiting to be exported. A value of zero indicates no messages are waiting to be exported. |
| aws_fsx_lustre_RepositoryRenameOperations | RepositoryRenameOperations | Repository Rename Operations(Lustre) | Count | Sum | The number of renames processed by the file system in response to a larger directory rename. |
| aws_fsx_lustre_AgeOfOldestQueuedMessage_AutoImport | AgeOfOldestQueuedMessage_AutoImport | Age Of Oldest Queued Message Auto Import(Lustre) | Seconds | Average | The age, in seconds, of the oldest message waiting to be imported. A value of zero indicates no messages are waiting to be imported. |
| aws_fsx_DataReadOperationTime | DataReadOperationTime | Data Read Operation Time(ONTAP) | Seconds | Sum | The sum of total time spent within the file system for read operations. Divide by DataReadOperations for average read latency. |
| aws_fsx_DataWriteOperationTime | DataWriteOperationTime | Data Write Operation Time(ONTAP) | Seconds | Sum | The sum of total time spent within the file system for fulfilling write operations. Divide by DataWriteOperations for average write latency. |
| aws_fsx_CapacityPoolReadBytes | CapacityPoolReadBytes | Capacity Pool Read Bytes(ONTAP) | Bytes | Sum | The number of bytes read (network I/O) from the file system's capacity pool tier. |
| aws_fsx_CapacityPoolReadOperations | CapacityPoolReadOperations | Capacity Pool Read Operations(ONTAP) | Count | Sum | The number of read operations (network I/O) from the file system's capacity pool tier. |
| aws_fsx_CapacityPoolWriteBytes | CapacityPoolWriteBytes | Capacity Pool Write Bytes(ONTAP) | Bytes | Sum | The number of bytes written (network I/O) to the file system's capacity pool tier. |
| aws_fsx_CapacityPoolWriteOperations | CapacityPoolWriteOperations | Capacity Pool Write Operations(ONTAP) | Count | Sum | The number of write operations (network I/O) to the file system from the capacity pool tier. |
| aws_fsx_StorageEfficiencySavings | StorageEfficiencySavings | Storage Efficiency Savings(ONTAP) | Bytes | Average | The bytes saved from storage efficiency features (compression, deduplication, and compaction). |
| aws_fsx_StorageUsed | StorageUsed | Storage Used(ONTAP) | Bytes | Average | The total amount of physical data stored on the file system, on both the primary (SSD) tier and the capacity pool tier. |
| aws_fsx_LogicalDataStored | LogicalDataStored | Logical Data Stored(ONTAP) | Bytes | Average | The total amount of logical data stored on the file system (SSD + capacity pool tier). Includes total logical size of snapshots and FlexClones. |
| aws_fsx_StorageUsed_Detailed | StorageUsed_Detailed | Storage Used Detailed(ONTAP) | Bytes | Average | The used physical storage capacity in bytes, specific to the storage tier. Valid StorageTier values: SSD and StandardCapacityPool. |
| aws_fsx_DiskThroughputUtilization | DiskThroughputUtilization | Disk Throughput Utilization(WINDOWS) | Percent | Average | The disk throughput between your file server and its storage volumes, as a percentage of the provisioned limit determined by the storage volumes. HDD only. |
| aws_fsx_FreeStorageCapacity | FreeStorageCapacity | Free Storage Capacity(WINDOWS) | Bytes | Average | The amount of available storage capacity. |
| aws_fsx_DeduplicationSavedStorage | DeduplicationSavedStorage | Deduplication Saved Storage(WINDOWS) | Bytes | Average | The amount of storage space saved by data deduplication, if it is enabled. |
| aws_fsx_lustre_CPUUtilization | CPUUtilization | CPU Utilization(LUSTRE) | Percent | Average | The percentage utilization of your file server's CPU resources. |
| aws_fsx_lustre_DiskIopsUtilization | DiskIopsUtilization | Disk Iops Utilization(LUSTRE) | Percent | Average | The disk IOPS between your file server and storage volumes, as a percentage of the provisioned IOPS limit determined by the storage volumes. |
| aws_fsx_lustre_DiskReadBytes | DiskReadBytes | Disk Read Bytes(LUSTRE) | Bytes | Sum | The number of bytes for read operations that access storage volumes. |
| aws_fsx_lustre_DiskReadOperations | DiskReadOperations | Disk Read Operations(LUSTRE) | Count | Sum | The number of read operations for the file server that accesses storage volumes. |
| aws_fsx_lustre_DiskWriteBytes | DiskWriteBytes | Disk Write Bytes(LUSTRE) | Bytes | Sum | The number of bytes for write operations that access storage volumes. |
| aws_fsx_lustre_DiskWriteOperations | DiskWriteOperations | Disk Write Operations(LUSTRE) | Count | Sum | The number of write operations for the file server that accesses storage volumes. |
| aws_fsx_lustre_FileServerDiskThroughputUtilization | FileServerDiskThroughputUtilization | File Server Disk Throughput Utilization(LUSTRE) | Percent | Average | The disk throughput between your file server and its storage volumes, as a percentage of the provisioned limit determined by throughput capacity. |
| aws_fsx_lustre_NetworkReceivedBytes | NetworkReceivedBytes | Network Received Bytes(LUSTRE) | Bytes | Sum | The number of bytes received by the file system, including data movement to/from linked data repositories. |
| aws_fsx_lustre_NetworkSentBytes | NetworkSentBytes | Network Sent Bytes(LUSTRE) | Bytes | Sum | The number of bytes sent by the file system, including data movement to/from linked data repositories. |
| aws_fsx_lustre_NetworkThroughputUtilization | NetworkThroughputUtilization | Network Throughput Utilization(LUSTRE) | Percent | Average | The network throughput for clients that access the file system, as a percentage of the provisioned limit. For Multi-AZ file systems, this includes replication traffic. |
| aws_fsx_lustre_StorageCapacityUtilization | StorageCapacityUtilization | Storage Capacity Utilization(LUSTRE) | Percent | Average | The storage capacity utilization for a given file system OST. |
| aws_fsx_windows_StorageCapacityUtilization | StorageCapacityUtilization | Storage Capacity Utilization(WINDOWS) | Percent | Average | The storage capacity utilization for a given file system OST. |