# 使用 Amazon CloudWatch 监控 S3 Files
<a name="s3-files-monitoring-cloudwatch"></a>

您可以使用 [Amazon CloudWatch](https://docs.amazonaws.cn/AmazonCloudWatch/latest/monitoring/WhatIsCloudWatch.html) 监控 S3 Files 文件系统，该服务从 Amazon S3 Files 收集原始数据并将其处理为可读的指标。这些指标保留 15 个月，以便您可以访问历史信息，并更好地了解文件系统的执行情况。

S3 Files 指标数据会自动发送到 CloudWatch。大多数指标每隔 1 分钟发送一次，而存储指标每 15 分钟发送一次。您可以创建 [CloudWatch 警报](https://docs.amazonaws.cn/AmazonCloudWatch/latest/monitoring/CloudWatch_Alarms.html)，以便在指标超过您指定的阈值时发送通知。您可以使用 CloudWatch 控制面板，此类控制面板是 CloudWatch 控制台中的一种自定义主页，可用于在单个视图中监控资源。有关更多信息，请参阅[创建 CloudWatch 自定义控制面板](https://docs.amazonaws.cn/AmazonCloudWatch/latest/monitoring/create_dashboard.html)。

## S3 Files CloudWatch 指标
<a name="s3-files-monitoring-cloudwatch-metrics"></a>

S3 Files 指标使用 `AWS/S3/Files` 命名空间。所有指标都是针对单个维度 `FileSystemId` 报告的。`AWS/S3/Files` 命名空间包括以下指标：


| 指标 | 说明 | 单位和有效统计数据 | 
| --- | --- | --- | 
| StorageBytes | 文件系统的总大小（以字节为单位），包括数据和元数据。每 15 分钟向 CloudWatch 发送一次此指标。 | 单位：字节。最小值、最大值、平均值 | 
| Inodes | S3 Files 文件系统中索引节点（例如文件、目录、符号链接）的总数。每 15 分钟向 CloudWatch 发送一次此指标。 | 单位：计数。总和 | 
| PendingExports | 等待导出到 S3 存储桶的文件和目录的总数。 | 单位：计数。总和 | 
| ImportFailures | 重试后未能导入到文件系统中的对象总数（例如，IAM 权限不正确）。 | 单位：计数。总和 | 
| ExportFailures | 导出失败且不会重试的文件和目录总数。此指标有助于您识别终端导出故障，以便您可以排除故障并采取措施（例如，更新 IAM 权限）。 | 单位：计数。总和 | 
| DataReadBytes | 从文件系统中读取的字节数。SampleCount 给出了数据读取操作的数量。您可以通过查看每单位时间的此指标来计算数据读取吞吐量。 | 单位：字节数（最小值、最大值、平均值、总和）、计数（SampleCount） | 
| DataWriteBytes | 写入文件系统的字节数。SampleCount 给出了数据写入操作的数量。您可以通过查看每单位时间的此指标来计算数据写入吞吐量。 | 单位：字节数（最小值、最大值、平均值、总和）、计数（SampleCount） | 
| MetadataReadBytes | 从文件系统中读取的元数据字节数。SampleCount 给出了元数据读取操作的数量。 | 单位：字节数（最小值、最大值、平均值、总和）、计数（SampleCount） | 
| MetadataWriteBytes | 写入文件系统的元数据字节数。SampleCount 给出了元数据写入操作的数量。 | 单位：字节数（最小值、最大值、平均值、总和）、计数（SampleCount） | 
| LostAndFoundFiles | 丢失找回目录中的文件总数。丢失找回目录位于文件系统的根目录中，名称为 .s3files-lost\+found-{{file-system-id}}。丢失找回目录中的文件不会复制到您的 S3 存储桶中。如果由于对文件系统和 S3 存储桶中的相同数据进行并行更改而发生冲突，则 S3 Files 将 S3 存储桶视为事实来源，并将冲突的文件移至丢失找回目录。 | 单位：计数。总和 | 
| ClientConnections | 与文件系统的活跃客户端连接数量。 | 单位：计数。总和 | 

## 客户端连接指标
<a name="s3-files-monitoring-cloudwatch-client-metrics"></a>

S3 Files 通过支持客户端直接从关联的 S3 存储桶读取文件数据，从而优化读取性能。为了支持这一点，S3 Files 客户端发出连接指标，用于监控客户端能否建立必要的连接。

这些指标由 S3 Files 客户端（amazon-efs-utils）发出并发布到 `efs-utils/S3Files` CloudWatch 命名空间。默认情况下，作为 S3 Files 体验的一部分，指标发出处于启用状态。


| 指标 | 说明 | 单位和有效统计数据 | 
| --- | --- | --- | 
| NFSConnectionAccessible | 表示客户端是否可以通过 NFS 挂载连接到文件系统。值 1 表示连接处于可访问状态。值 0 表示无法访问连接。 | 单位：无。最小值、最大值、平均值 | 
| S3BucketAccessible | 表示客户端是否拥有所需的权限，以便从关联的 S3 存储桶读取数据。值为 1 表示客户端拥有所需的权限。值为 0 表示客户端没有所需的权限。 | 单位：无。最小值、最大值、平均值 | 
| S3BucketReachable | 表示关联的 S3 存储桶和前缀是否存在以及是否可以从客户端访问。值为 1 表示存储桶和前缀处于可访问状态。值为 0 表示存储桶或前缀不可访问。 | 单位：无。最小值、最大值、平均值 | 

## 访问 CloudWatch 指标
<a name="s3-files-monitoring-cloudwatch-access"></a>

您可以使用 CloudWatch 控制台、Amazon CLI 或 CloudWatch API 查看 S3 Files 指标。

### 使用 CloudWatch 控制台查看指标
<a name="s3-files-monitoring-cloudwatch-access-console"></a>

1. 通过以下网址打开 CloudWatch 控制台：[https://console.aws.amazon.com/cloudwatch/](https://console.amazonaws.cn/cloudwatch/)。

1. 在导航窗格中，选择**指标**，然后选择**所有指标**。

1. 选择 **S3Files** 命名空间。

1. 选择**文件系统指标**。

1. 选择要查看的指标。

1. 选择**图形化指标**选项卡以配置图表显示。

### 使用Amazon CLI 查看指标
<a name="s3-files-monitoring-cloudwatch-access-cli"></a>

使用 `get-metric-statistics` 命令。例如，要查看 `DataReadBytes`：

```
aws cloudwatch get-metric-statistics \
  --namespace AWS/S3/Files \
  --metric-name DataReadBytes \
  --dimensions Name=FileSystemId,Value={{file-system-id}} \
  --start-time 2025-01-20T00:00:00Z \
  --end-time 2025-01-20T23:59:59Z \
  --period 3600 \
  --statistics Sum
```