本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 管理元数据性能
您可以使用亚马逊 FSx 控制台、Amazon FSx API 或 AWS Command Line Interface (AWS CLI) 更新您 FSx 的 for Lustre 文件系统的元数据配置，而不会对最终用户或应用程序造成任何干扰。更新过程会增加为文件系统预配置的元数据 IOPS 的数量。
**注意**
增强型元数据仅适用于 2.15 文件系统。只有在使用 Persitent 2 部署类型和指定的元数据配置创建的 Lustre 文件系统上 FSx ，您才能提高元数据性能。如果在创建文件系统时未指定元数据配置，则无法添加或更新 for Lustre 文件系统的元数据配置。 FSx 这同样适用于从 2.12 文件系统备份恢复的文件系统（该版本不支持增强型元数据性能），或从 2.15 文件系统备份恢复的文件系统（该版本未指定元数据配置）。
提高的文件系统元数据性能可在几分钟内使用。只要提高元数据性能的请求间隔至少 6 小时，您可以随时更新元数据性能。在扩展元数据性能时，文件系统可能会在几分钟内不可用。在文件系统不可用时客户端发出的文件操作将以透明方式重试，并最终在元数据性能扩展完成后成功。在您可以使用新的元数据性能提升后，就需要为其付费。
您可以使用 Amazon FSx 控制台、CLI 和 API 随时跟踪元数据性能提升的进度。有关更多信息，请参阅 [监控元数据配置更新](monitoring-metadata-performance-increase.md)。
**Topics**
+ [Lustre 元数据性能配置](#metadata-configuration)
+ [提高元数据性能时的注意事项](#metadata-scaling-considerations)
+ [何时提高元数据性能](#when-to-modify-metadata-performance)
+ [提高元数据性能](modify-metadata-performance.md)
+ [更改元数据配置模式](switch-provisioning-mode.md)
+ [监控元数据配置更新](monitoring-metadata-performance-increase.md)
## Lustre 元数据性能配置
预配置元数据 IOPS 的数量决定了文件系统可以支持的最大元数据操作速率。
创建文件系统时，可选择元数据配置模式：
+ 对于 SSD 文件系统，如果您希望 Amazon FSx 根据文件系统的存储容量自动配置和扩展文件系统的元数据 IOPS，则可以选择自动模式。请注意，Intelligent-Tiering 文件系统不支持自动模式。
+ 对于 SSD 文件系统，如果要指定 元数据 IOPS 数，请选择用户预置，以预置文件系统。
+ 对于 Intelligent-Tiering 文件系统，必须选择用户预置模式。使用“用户预置”模式，您可以指定元数据 IOPS 数，以预置文件系统。
对于 SSD 文件系统，您可以随时从“自动”模式切换到“用户预置”模式。如果文件系统上预置的元数据 IOPS 数与“自动”模式下预置的默认元数据 IOPS 数一致，也可以从“用户预置”模式切换到“自动”模式。Intelligent-Tiering 文件系统仅支持“用户预置”模式，因此您无法切换元数据配置模式。
有效的元数据 IOPS 值如下所示：
+ 对于 SSD 文件系统，有效的元数据 IOPS 值为 1500、3000、6000 以及 12000 的倍数，最大值为 192000。
+ 对于 Intelligent-Tiering 文件系统，有效的元数据 IOPS 值为 6000 和 12000。
如果工作负载的元数据性能超出了在“自动”模式下预置的元数据 IOPS 数，则可以使用“用户预置”模式增加文件系统的元数据 IOPS 值。
您可以按以下方式，查看文件系统元数据服务器配置的当前值：
+ 使用控制台：在文件系统详细信息页面的**摘要**面板上，**元数据 IOPS** 字段显示预置元数据 IOPS 的当前值以及文件系统的当前元数据配置模式。
+ 使用 CLI 或 API-使用 [describe-file-systems](https://docs.aws.amazon.com/cli/latest/reference/fsx/describe-file-systems.html)CLI 命令或 [DescribeFileSystems](https://docs.aws.amazon.com/fsx/latest/APIReference/API_DescribeFileSystems.html)API 操作，然后查找`MetadataConfiguration`属性。
## 提高元数据性能时的注意事项
提高元数据性能时需要考虑的几个重要事项如下：
+ **仅提高元数据性能** - 您只能*增加*文件系统的元数据 IOPS 数；不得减小元数据 IOPS 数。
+ **不支持在自动模式下指定元数据 IOPS** - 您无法在处于“自动”模式的文件系统中指定元数据 IOPS 数。必须切换到“用户预置”模式，然后提出请求。有关更多信息，请参阅 [更改元数据配置模式](switch-provisioning-mode.md)。
+ **扩展前写入的数据的元数据 IOPS** — 当元数据 IOPS 扩展到 12000 以上时， FSx Lustre 会向您的文件系统添加新的元数据服务器。新的元数据会自动分配至所有服务器，以提升性能。但是，在扩展之前创建的现有元数据和子目录仍保留在原始服务器上，且元数据 IOPS 不会增加。
+ **两次提高的间隔时间**：在上次增加请求后 6 小时之前，您无法进一步提高文件系统的元数据性能。
+ **同时提高元数据性能和 SSD 存储空间**：您无法同时扩展元数据性能和文件系统存储容量。
## 何时提高元数据性能
当需要运行的工作负载要求比文件系统默认配置更高的元数据性能水平时，可增大元数据 IOPS 数。您可以使用图表 AWS 管理控制台 来监控您的元数据性能，该`Metadata IOPS Utilization`图表提供了您在文件系统上消耗的预配置元数据服务器性能的百分比。
您还可以使用更精细的 CloudWatch 指标来监控元数据性能。 CloudWatch 指标包括`DiskReadOperations`和`DiskWriteOperations`，它们提供需要磁盘 IO 的元数据服务器操作量，以及元数据操作的精细指标，包括文件和目录的创建、统计信息、读取和删除。有关更多信息，请参阅 [FSx for Lustre 元数据指标](fs-metrics.md#fs-metadata-metrics)。
# 提高元数据性能
您可以使用亚马逊 FSx 控制台、或 Amazon FSx API 来提高文件系统的元数据性能。 AWS CLI
## 提高文件系统的元数据性能（控制台）
1. 打开 Amazon FSx 控制台，网址为[https://console.aws.amazon.com/fsx/](https://console.aws.amazon.com/fsx/)。
1. 在左侧导航窗格中，选择**文件系统**。在**文件系统**列表中，选择要提高元数据性能的 Lustre 文件系统。 FSx
1. 在**操作**中，选择**更新元数据 IOPS**。或者，在**摘要**面板中，选择文件系统的** Metadata IOPS**旁边的**更新**。
将出现**更新元数据 IOPS** 对话框。
1. 选择**用户预置**。
1. 对于**所需的元数据 IOPS**，请选择新的元数据 IOPS 值。此值必须大于或等于当前的 Metadata IOPS 值。
+ 对于 SSD 文件系统，有效值为 `1500`、`3000`、`6000`、`12000` 和 `12000` 的倍数，最大值为 `192000`。
+ 对于 Intelligent-Tiering 文件系统，有效值为 `6000` 和 `12000`。
1. 选择**更新**。
## 提高文件系统的元数据性能（CLI）
要提高 for Lustre 文件系统的元数据性能，请使用 AWS CLI 命令 [update-file-system](https://docs.aws.amazon.com/cli/latest/reference/fsx/update-file-system.html)（等效UpdateFileSystem 的 API 操作）。 FSx 设置以下参数：
+ 将 `--file-system-id` 设置为要更新的文件系统的 ID。
+ 要提高元数据性能，可使用 `--lustre-configuration MetadataConfiguration` 属性。此属性有 `Mode` 和 `Iops` 两个参数。
1. 如果文件系统处于“用户预置”模式，可以选择使用 `Mode`（如果使用，则将 `Mode` 设置为 `USER_PROVISIONED`）。
如果 SSD 文件系统处于“自动”模式，将 `Mode` 设置为 `USER_PROVISIONED`（除了增加元数据 IOPS 值外，这还将文件系统模式切换到“用户预置”）。
1. 对于 SSD 文件系统，将 `Iops` 设置为 `1500`、`3000`、`6000`、`12000` 或 `12000` 的倍数，最大值为 `192000`。对于 Intelligent-Tiering 文件系统，将 `Iops` 设置为 `6000` 或 `12000`。此值必须大于或等于当前的 Metadata IOPS 值。
以下示例将预配置的元数据 IOPS 更新为 12000。
```
aws fsx update-file-system \
--file-system-id fs-0123456789abcdef0 \
--lustre-configuration 'MetadataConfiguration={Mode=USER_PROVISIONED,Iops=12000}'
```
# 更改元数据配置模式
对于基于 SSD 的文件系统，您可以按照以下过程所述，使用 AWS 控制台和 CLI 更改现有文件系统的元数据配置模式。
从“自动”模式切换到“用户预置”模式时，必须提供一个大于或等于文件系统当前元数据 IOPS 值的元数据 IOPS 值。
如果您请求从用户配置模式切换到自动模式，并且当前的元数据 IOPS 值大于自动默认值，Amazon FSx 会拒绝该请求，因为不支持缩减元数据 IOPS。要解锁模式切换，您必须增加存储容量以与“自动”模式下的当前元数据 IOPS 相匹配，从而再次启用模式切换。
您可以使用亚马逊 FSx 控制台、或 Amazon FSx API 更改文件系统的元数据配置模式。 AWS CLI
## 更改文件系统的元数据配置模式（控制台）
1. 打开 Amazon FSx 控制台，网址为[https://console.aws.amazon.com/fsx/](https://console.aws.amazon.com/fsx/)。
1. 在左侧导航窗格中，选择**文件系统**。在**文件系统**列表中，选择要更改元数据配置模式的 Lustre 文件系统。 FSx
1. 在**操作**中，选择**更新元数据 IOPS**。或者，在**摘要**面板中，选择文件系统的** Metadata IOPS**旁边的**更新**。
将出现**更新元数据 IOPS** 对话框。
1. 请执行以下操作之一。
+ 要从“用户预置”模式切换到“自动”模式，请选择**自动**。
+ 要从“自动”模式切换到“用户预置”模式，请选择**用户预置**。然后，对于**所需的元数据 IOPS**，请提供一个大于或等于当前文件系统元数据 IOPS 值的元数据 IOPS 值。
1. 选择**更新**。
## 更改 SSD 文件系统的元数据配置模式（CLI）
要更改适用于 Lustre 文件系统的固态硬盘 FSx 的元数据配置模式，请使用 AWS CLI 命令 [update-file-system](https://docs.aws.amazon.com/cli/latest/reference/fsx/update-file-system.html)（UpdateFileSystem 是等效的 API 操作）。设置以下参数：
+ 将 `--file-system-id` 设置为要更新的文件系统的 ID。
+ 要更改基于 SSD 文件系统上的元数据配置模式，可使用 `--lustre-configuration MetadataConfiguration` 属性。此属性有 `Mode` 和 `Iops` 两个参数。
+ 要将 SSD 文件系统从“自动”模式切换到“用户预置”模式，需将 `Mode` 设置为 `USER_PROVISIONED`，并将 `Iops` 设置为大于或等于文件系统当前元数据 IOPS 值的元数据 IOPS 值。例如：
```
aws fsx update-file-system \
--file-system-id fs-0123456789abcdef0 \
--lustre-configuration 'MetadataConfiguration={Mode=USER_PROVISIONED,Iops=96000}'
```
+ 要从“用户预置”模式切换到“自动”模式，需将 `Mode` 设置为 `AUTOMATIC` 且不使用 `Iops` 参数。例如：
```
aws fsx update-file-system \
--file-system-id fs-0123456789abcdef0 \
--lustre-configuration 'MetadataConfiguration={Mode=AUTOMATIC}'
```
# 监控元数据配置更新
您可以使用 Amazon FSx 控制台、API 或，监控元数据配置更新的进度 AWS CLI。
## 监控元数据配置更新（控制台）
可以在**文件系统详细信息**页面的**更新**选项卡中监控元数据配置更新。
对于元数据配置更新，可以查看以下信息：
****更新类型****
支持的类型为**元数据 IOPS** 和**元数据配置模式**。
****目标值****
文件系统元数据 IOPS 或元数据配置模式的更新值。
****状态****
当前更新状态。可能的值如下所示：
+ **待处理** — Amazon FSx 已收到更新请求，但尚未开始处理。
+ 处理@@ **中** — Amazon FSx 正在处理更新请求。
+ **已完成** – 更新成功完成。
+ **已失败** – 更新请求失败。选择问号（**?**）可查看关于请求失败原因的详细信息。
****请求时间****
Amazon FSx 收到更新操作请求的时间。
## 监控元数据配置更新（CLI）
您可以使用[describe-file-systems](https://docs.aws.amazon.com/cli/latest/reference/fsx/describe-file-systems.html) AWS CLI 命令和 [DescribeFileSystems](https://docs.aws.amazon.com/fsx/latest/APIReference/API_DescribeFileSystems.html)API 操作查看和监控元数据配置更新请求。`AdministrativeActions` 数组列出每种管理操作类型的 10 个最近更新操作。更新文件系统的元数据性能或元数据配置模式时，会产生 `FILE_SYSTEM_UPDATE` `AdministrativeActions`。
以下示例显示了 CLI 命令 `describe-file-systems` 的响应摘录。文件系统有待处理的管理操作，需要将元数据 IOPS 增加到 96000，并将元数据配置模式切换到“用户预置”。
```
"AdministrativeActions": [
{
"AdministrativeActionType": "FILE_SYSTEM_UPDATE",
"RequestTime": 1678840205.853,
"Status": "PENDING",
"TargetFileSystemValues": {
"LustreConfiguration": {
"MetadataConfiguration": {
"Iops": 96000,
"Mode": USER_PROVISIONED
}
}
}
}
]
```
Amazon 通过修改文件系统的元数据 IOPS 和元数据配置模式来 FSx 处理该操作。`FILE_SYSTEM_UPDATE`当新的元数据资源可供文件系统使用时，`FILE_SYSTEM_UPDATE` 状态将更改为 `COMPLETED`。
如果元数据配置更新请求失败，则 `FILE_SYSTEM_UPDATE` 操作的状态将更改为 `FAILED`，如以下示例所示。`FailureDetails` 属性提供失败信息。
```
"AdministrativeActions": [
{
"AdministrativeActionType": "FILE_SYSTEM_UPDATE",
"RequestTime": 1678840205.853,
"Status": "FAILED",
"TargetFileSystemValues": {
"LustreConfiguration": {
"MetadataConfiguration": {
"Iops": 96000,
"Mode": USER_PROVISIONED
}
}
},
"FailureDetails": {
"Message": "failure-message"
}
}
]
```