Managing throughput capacity
Every FSx for OpenZFS file system has a throughput capacity that is configured when you create the file system. You can modify your file system's throughput capacity at any time, as needed. Throughput capacity is one factor that determines the speed at which the file server hosting the file system can serve file data. Higher levels of throughput capacity also come with higher levels of I/O operations per second (IOPS) and more memory for caching of data on the file server. For more information, see Amazon FSx for OpenZFS performance.
When you modify your file system's throughput capacity, behind the scenes, Amazon FSx switches out the file system's file server. For Multi-AZ file systems, it results in an automatic failover and failback while Amazon FSx switches out the preferred and secondary file servers. For single-AZ systems, your file system will be unavailable for a few minutes during throughput capacity scaling. You are billed for the new amount of throughput capacity once it is available to your file system.
File systems offer varying levels of throughput capacity, depending on your deployment type. The values of throughput capacity (in MB/s) for Single-AZ 1, Single-AZ 2, and Multi-AZ are as follows:
-
Single-AZ 2 and Multi-AZ – 160, 320, 640, 1280, 2560, 3840, 5120, 7680, 10240
-
Single-AZ 1 – 64, 128, 256, 512, 1024, 2048, 3072, 4096
When to modify throughput capacity
Amazon FSx integrates with Amazon CloudWatch, enabling you to monitor your file system's ongoing throughput usage levels. The performance (throughput and IOPS) that you can drive through your file system depends on your specific workload’s characteristics, in addition to your file system’s throughput capacity, storage capacity, and storage type. You can use CloudWatch metrics to determine which of these dimensions to change to improve performance. For more information, see Monitoring with Amazon CloudWatch.
How to modify throughput capacity
You can modify a file system's throughput capacity using the Amazon FSx console, the AWS Command Line Interface (AWS CLI), or the Amazon FSx API.
Open the Amazon FSx console at https://console.aws.amazon.com/fsx/
. Navigate to File systems, and choose the FSx for OpenZFS file system that you want to increase the throughput capacity for.
For Actions, choose Update throughput capacity. Or, in the Summary panel, choose Update next to the file system's Throughput capacity.
The Update throughput capacity window appears.
Choose the new value for Desired throughput capacity from the list.
Choose Update to initiate the throughput capacity update.
Note
Your file system may experience a very brief period of unavailability during the update.
To modify a file system's throughput capacity, use the update-file-system CLI command (or the equivalent UpdateFileSystem API operation), as shown in the following example.
aws fsx update-file-system \ --file-system-id fs-0123456789abcdef0 \ --open-zfs-configuration '{"ThroughputCapacity":512}'
