Managing Throughput Capacity - Amazon FSx for Windows File Server

Managing Throughput Capacity

Every Amazon FSx for Windows File Server 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 Windows File Server Performance.

Note

Support for file systems created before June 1, 2020 is coming soon.

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.

When setting the throughput capacity on your file system, you can choose from the following levels (in MB/s): 8, 16, 32, 64, 128, 256, 512, 1024, 2048.

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.

  1. Open the Amazon FSx console at https://console.aws.amazon.com/fsx/.

  2. Navigate to File systems, and choose the Windows file system that you want to increase the throughput capacity for.

  3. For Actions, choose Update throughput. Or, in the Summary panel, choose Update next to the file system's Throughput capacity.

    The Update throughput capacity window appears.

  4. Choose the new value for Throughput capacity from the list.

    
        Console screenshot showing the Update throughput capacity window
  5. Choose Update to initiate the throughput capacity update.

    Note

    Multi-AZ file systems fail over and fail back when updating throughput scaling, and are fully available. Single-AZ file systems experience a very brief period of unavailability during the update.

  6. You can monitor the update progress on the File systems detail page, in the Updates tab.

    You can monitor the progress of the update by using the Amazon FSx console, the AWS CLI, and the API. For more information, see Monitoring Throughput Capacity Changes.

To modify a file system's throughput capacity, use the AWS CLI command update-file-system. Set the following parameters:

  • --file-system-id to the ID of the file system that you are updating.

  • --throughput-capacity to the desired value to update the file system to.

You can monitor the progress of the update by using the Amazon FSx console, the AWS CLI, and the API. For more information, see Monitoring Throughput Capacity Changes.

Monitoring Throughput Capacity Changes

You can monitor the progress of a throughput capacity modification using the Amazon FSx console, the API, and the AWS CLI.

Monitoring Throughput Capacity Changes in the Console

In the Updates tab in the File system details window, you can view the 10 most recent update actions for each update action type.


     Console screenshot showing the file system updates window.

For throughput capacity update actions, you can view the following information.

Update type

Supported types are Throughput capacity, Storage capacity, and Storage optimizatin.

Target value

The desired value to change the file system's throughput capacity to.

Status

The current status of the update. For throughput capacity updates, the possible values are as follows:

  • Pending – Amazon FSx has received the update request, but has not started processing it.

  • In progress – Amazon FSx is processing the update request.

  • Completed – The throughput capacity update completed successfully.

  • Failed – The throughput capacity update failed. Choose the question mark (?) to see details on why the throughput update failed.

Request time

The time that Amazon FSx received the update request.

Monitoring Changes with the AWS CLI and API

You can view and monitor file system throughput capacity modification requests using the describe-file-systems CLI command and the DescribeFileSystems API action. The AdministrativeActions array lists the 10 most recent update actions for each administrative action type. When you modify a file system's throughput capacity, a FILE_SYSTEM_UPDATE administrative action is generated.

The following example shows the response excerpt of a describe-file-systems CLI command. The file system has a throughput capacity of 8 MB/s, and the target throughput capacity of 256 MB/s.

. . . "ThroughputCapacity": 8, "AdministrativeActions": [ { "AdministrativeActionType": "FILE_SYSTEM_UPDATE", "RequestTime": 1581694764.757, "Status": "PENDING", "TargetFileSystemValues": { "ThroughputCapacity": 256 } } ]

When Amazon FSx completes processing the action successfully, the status changes to COMPLETED. The new throughput capacity is then available to the file system, and shows in the ThroughputCapacity property. This is shown in the following response excerpt of a describe-file-systems CLI command.

. . . "ThroughputCapacity": 256, "AdministrativeActions": [ { "AdministrativeActionType": "FILE_SYSTEM_UPDATE", "RequestTime": 1581694764.757, "Status": "COMPLETED", "TargetFileSystemValues": { "ThroughputCapacity": 256 } } ]

If the throughput capacity modification fails, the status changes to FAILED, and the FailureDetails property provides information about the failure. For information about troubleshooting failed actions, see Troubleshooting Failed Storage and Throughput Updates.