本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用 Amazon CloudWatch 監控 S3 檔案
<a name="s3-files-monitoring-cloudwatch"></a>

您可以使用 [Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/WhatIsCloudWatch.html) 監控 S3 檔案系統，該系統會收集來自 Amazon S3 檔案的原始資料並將其處理為可讀指標。這些指標會保留 15 個月，因此您可以存取歷史資訊，並更清楚檔案系統的效能。

S3 檔案指標資料會自動傳送至 CloudWatch。大多數指標會每隔 1 分鐘傳送一次，而儲存指標則會每 15 分鐘傳送一次。您可以建立 [CloudWatch 警示](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Alarms.html)，在指標超過您指定的閾值時傳送通知。您也可以使用 CloudWatch 儀表板，這是 CloudWatch 主控台中可自訂的首頁，可用於在單一檢視中監控資源。如需詳細資訊，請參閱[建立自訂 CloudWatch 儀表板](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/create_dashboard.html)。

## S3 檔案 CloudWatch 指標
<a name="s3-files-monitoring-cloudwatch-metrics"></a>

S3 檔案指標使用 `AWS/S3Files` 命名空間。系統會針對單一維度 報告所有指標`FileSystemId`。`AWS/S3Files` 命名空間包含下列指標：


| 指標 | Description | 單位和有效統計資料 | 
| --- | --- | --- | 
| StorageBytes | 檔案系統的總大小，以位元組為單位，其中包含資料和中繼資料。此指標每 15 分鐘會發送到 CloudWatch。 | 單位：位元組。最小值、最大值、平均值 | 
| Inodes | S3 檔案檔案系統中的索引 （例如檔案、目錄、符號連結） 總數。此指標每 15 分鐘會發送到 CloudWatch。 | 單位：計數。總和 | 
| PendingExports | 待匯出至 S3 儲存貯體的檔案和目錄總數。 | 單位：計數。總和 | 
| ImportFailures | 重試後無法匯入檔案系統的物件總數 （例如，不正確的 IAM 許可）。 | 單位：計數。總和 | 
| ExportFailures | 匯出失敗且不會重試的檔案和目錄總數。此指標可協助您識別終端機匯出失敗，以便疑難排解並採取動作 （例如，更新 IAM 許可）。 | 單位：計數。總和 | 
| DataReadBytes | 從檔案系統讀取的位元組數。 SampleCount會提供資料讀取操作的數量。您可以檢視每個單位時間的此指標，來計算資料讀取輸送量。 | 單位：位元組 （最小值、最大值、平均值、總和）、計數 (SampleCount) | 
| DataWriteBytes | 寫入檔案系統的位元組數。 SampleCount會提供資料寫入操作的數量。您可以檢視每個單位時間的此指標，來計算資料寫入輸送量。 | 單位：位元組 （最小值、最大值、平均值、總和）、計數 (SampleCount) | 
| MetadataReadBytes | 從檔案系統讀取的中繼資料位元組數目。 SampleCount會提供中繼資料讀取操作數目。 | 單位：位元組 （最小值、最大值、平均值、總和）、計數 (SampleCount) | 
| MetadataWriteBytes | 寫入檔案系統的中繼資料位元組數。 SampleCount會提供中繼資料寫入操作的數量。 | 單位：位元組 （最小值、最大值、平均值、總和）、計數 (SampleCount) | 
| LostAndFoundFiles | 失物招領目錄中的檔案總數。失物招領目錄位於檔案系統的根目錄中，名稱為 .s3files-lost\$1found-file-system-id。失物招領目錄中的檔案不會複製到 S3 儲存貯體。當因為同時變更檔案系統和 S3 儲存貯體中的相同資料而發生衝突時，S3 檔案會將 S3 儲存貯體視為事實來源，並將衝突的檔案移至遺失和找到的目錄。 | 單位：計數。總和 | 
| ClientConnections | 檔案系統的作用中用戶端連線數目。 | 單位：計數。總和 | 

## 用戶端連線指標
<a name="s3-files-monitoring-cloudwatch-client-metrics"></a>

S3 檔案可讓用戶端直接從連結的 S3 儲存貯體讀取檔案資料，以最佳化讀取效能。為了支援此功能，S3 Files 用戶端會發出連線指標，以監控用戶端是否可以建立必要的連線。

這些指標由 S3 Files 用戶端 (amazon-efs-utils) 發出，並發佈至 `efs-utils/S3Files` CloudWatch 命名空間。指標發射預設為啟用，作為 S3 檔案體驗的一部分。


| 指標 | Description | 單位和有效統計資料 | 
| --- | --- | --- | 
| NFSConnectionAccessible | 指出用戶端是否可以透過 NFS 掛載連線至檔案系統。值為 1 表示可存取連線。值為 0 表示無法存取連線。 | 單位：無。最小值、最大值、平均值 | 
| S3BucketAccessible | 指出用戶端是否具有從連結的 S3 儲存貯體讀取資料所需的許可。值為 1 表示用戶端具有必要的許可。值為 0 表示用戶端沒有必要的許可。 | 單位：無。最小值、最大值、平均值 | 
| S3BucketReachable | 指出連結的 S3 儲存貯體和字首是否存在，並且可從用戶端連線。值為 1 表示可以連接儲存貯體和字首。值 0 表示無法存取儲存貯體或字首。 | 單位：無。最小值、最大值、平均值 | 

## 存取 CloudWatch 指標
<a name="s3-files-monitoring-cloudwatch-access"></a>

您可以使用 CloudWatch 主控台、CLI AWS 或 CloudWatch API 檢視 S3 檔案指標。

### 使用 CloudWatch 主控台檢視指標
<a name="s3-files-monitoring-cloudwatch-access-console"></a>

1. 在 [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) 開啟 CloudWatch 主控台。

1. 在導覽窗格中，選擇**指標**，然後選擇**所有指標**。

1. 選擇 **S3Files** 命名空間。

1. 選擇**檔案系統指標**。

1. 選取您要檢視的指標。

1. 選擇**圖形化指標**索引標籤來設定圖形顯示。

### 使用 AWS CLI 檢視指標
<a name="s3-files-monitoring-cloudwatch-access-cli"></a>

使用 `get-metric-statistics` 命令。例如，若要檢視 `DataReadBytes`：

```
aws cloudwatch get-metric-statistics \
  --namespace AWS/S3Files \
  --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
```