本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 使用 Amazon CloudWatch 監控指標
您可以使用 Amazon CloudWatch 指標來追蹤效能、偵測異常狀況，以及監控資料表的運作狀態。您可以搭配 S3 Tables 使用幾組 CloudWatch 指標。
**資料表和資料表儲存貯體的每日儲存指標**
監控儲存在資料表和資料表儲存貯體中的資料量，包括以位元組為單位的總計大小和檔案數量。這些指標會追蹤每個存取層的總計儲存位元組，以及資料表儲存貯體、資料表和命名空間層級的檔案計數。S3 Tables 的儲存體指標會每天回報一次，並免費提供給所有客戶。
**資料表維護指標**
監控 Amazon S3 在資料表上執行的自動維護操作，例如壓縮。這些指標會追蹤維護活動期間處理的位元組和檔案數目。S3 Tables 的維護指標每天會回報一次，並免費提供給所有客戶。
**請求指標**
監控 S3 Tables 請求，以快速找出並處理操作問題。您可以選擇性地為個別資料表儲存貯體啟用這些 CloudWatch 指標。S3 Tables 的請求指標每分鐘報告一次，並以與 CloudWatch 自訂指標相同的費率計費。請求指標包括：
+ 資料平面操作的計數 (GET、PUT、HEAD、POST)
+ 傳輸的位元組數
+ 延遲測量
+ 錯誤率
**注意**
**最努力的 CloudWatch 指標交付**
CloudWatch 指標是盡力交付。以請求指標對 Amazon S3 物件提出的大部分請求，都會導致資料點傳送至 CloudWatch。
不保證指標的完成程度與時間先後順序。特定要求的資料點回傳，回傳時附有的時間戳記可能會晚於實際處理要求時間。一分鐘的資料點在透過 CloudWatch 送達前可能延遲，或根本不會傳遞。CloudWatch 請求指標可讓您近乎即時了解儲存貯體的流量性質。並不表示完整考量所有要求。由於遵循此功能的盡力本質，在[帳單與成本管理儀表板](https://console.aws.amazon.com/billing/home?#/)提供的報告中，可能包含一或多個未出現在儲存貯體指標中的存取請求。
# 指標和維度
下表列出 S3 Tables 傳送至 Amazon CloudWatch 的儲存指標和維度。
**注意**
**最努力的 CloudWatch 指標交付**
CloudWatch 指標是盡力交付。以請求指標對 Amazon S3 物件提出的大部分請求，都會導致資料點傳送至 CloudWatch。
不保證指標的完成程度與時間先後順序。特定要求的資料點回傳，回傳時附有的時間戳記可能會晚於實際處理要求時間。一分鐘的資料點在透過 CloudWatch 送達前可能延遲，或根本不會傳遞。CloudWatch 請求指標可讓您近乎即時了解儲存貯體的流量性質。並不表示完整考量所有要求。由於遵循此功能的盡力本質，在[帳單與成本管理儀表板](https://console.aws.amazon.com/billing/home?#/)提供的報告中，可能包含一或多個未出現在儲存貯體指標中的存取請求。
## CloudWatch 中資料表儲存貯體的每日儲存指標
`AWS/S3/Tables` 命名空間包含下列每日儲存指標，無需額外費用。您可以依照資料表儲存貯體、資料表或命名空間名稱來篩選這些指標。
**每日儲存指標**
| 指標名稱 | Description | 單位 | 統計資料 | 精細程度 |
| --- | --- | --- | --- | --- |
| 儲存貯體儲存總計 | 資料表儲存貯體中所有資料表使用的儲存量 (以位元組計算) | 位元組 | 總和 | 每日 |
| 檔案總數 | 儲存在資料表儲存貯體中所有檔案的總數 | 計數 | 總和 | 每日 |
## 資料表維護指標
`AWS/S3/Tables` 命名空間包含下列資料表維護指標，可免費使用。您可以依照資料表儲存貯體、資料表或命名空間名稱來篩選這些指標。
**資料表維護指標**
| 指標名稱 | Description | 單位 | 統計資料 | 精細程度 |
| --- | --- | --- | --- | --- |
| CompactionBytesProcessed | 在資料表壓縮操作期間處理的位元組數 | 位元組 | 總和 | 每日 |
| CompactionObjectsCount | 在資料表壓縮操作期間處理的物件數 | 計數 | 總和 | 每日 |
## 請求 CloudWatch 中資料表和資料表儲存貯體的指標
`AWS/S3/Tables` 命名空間包含下列請求指標，其計費費率與 CloudWatch 自訂指標相同。您可以依照資料表儲存貯體、資料表或命名空間名稱來篩選這些指標。
**請求指標**
| 指標名稱 | Description | 單位 | 統計資料 | 精細程度 |
| --- | --- | --- | --- | --- |
| 所有請求計數 | 對資料表儲存貯體提出的 HTTP 請求總數。 | 計數 | 總和 | 1 分鐘 |
| 取得請求計數 | 從資料表擷取物件的 HTTP GET 請求數目 | 計數 | 總和 | 1 分鐘 |
| Put 請求計數 | 為資料表新增物件提出的 HTTP PUT 請求數目 | 計數 | 總和 | 1 分鐘 |
| 標頭請求計數 | 從資料表擷取中繼資料的 HTTP HEAD 請求數目 | 計數 | 總和 | 1 分鐘 |
| Post 請求計數 | 對資料表提出的 HTTP POST 請求數目 | 計數 | 總和 | 1 分鐘 |
| UpdateTableMetadataLocation 請求計數 | 為更新資料表中繼資料位置提出的請求數目 | 計數 | 總和 | 1 分鐘 |
| GetTableMetadataLocation 請求計數 | 為擷取資料表中繼資料位置提出的請求數目 | 計數 | 總和 | 1 分鐘 |
| BytesDownloaded | 針對資料表請求下載的位元組數。 | 位元組 | 總和 | 1 分鐘 |
| BytesUploaded | 針對資料表請求上傳的位元組數 | 位元組 | 總和 | 1 分鐘 |
| 4xxErrors | 傳回的 HTTP 4xx 用戶端錯誤狀態碼計數 | 計數 | 總和 | 1 分鐘 |
| 5xxErrors | 傳回的 HTTP 5xx 伺服器錯誤狀態碼計數 | 計數 | 總和 | 1 分鐘 |
| FirstByteLatency | 從接收到完整請求到開始回傳回應的每次請求時間 | 毫秒 | 總和 | 1 分鐘 |
| TotalRequestLatency | 從收到第一個位元組起，到最後一個位元組傳送為止，每個請求所經過的時間。 | 毫秒 | 總和 | 1 分鐘 |
## CloudWatch 中的 S3 Tables 維度
下列維度用來篩選 S3 Tables 指標。
**S3 Tables 維度**
| 維度名稱 | Description | 範例值 |
| --- | --- | --- |
| TableBucketName | Amazon S3 資料表儲存貯體的名稱。 | my-table-bucket |
| Namespace | 資料表儲存貯體中的命名空間，其中包含一或多個資料表 | my-department |
| TableName | 命名空間中特定資料表的名稱 | transactions |
# 存取 CloudWatch 指標
您可以使用 CloudWatch 主控台、 AWS CLI或 CloudWatch API 監控 S3 Tables 指標。本節說明如何使用這些不同的方法存取您的指標。
## 使用 S3 主控台
1. 登入 AWS 管理主控台，並在 [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)：// 開啟 Amazon S3 主控台。
1. 在左側導覽窗格中，選擇**資料表儲存貯體**。
1. 在儲存貯體清單中，選擇包含您要查看指標之資料表的儲存貯體名稱。
1. 選擇**指標**標籤。
1. 在任何指標窗格中選擇**在 CloudWatch 中檢視**，以導覽至 CloudWatch 主控台，並在`AWS/S3/Tables`命名空間中查看可用的指標。
## 使用 AWS CLI
若要使用 列出 S3 Tables 的指標 AWS CLI，請使用 `list-metrics`命令，並將 `--namespace` 參數設定為 `AWS/S3/Tables`：
```
aws cloudwatch list-metrics --namespace AWS/S3/Tables
```
若要取得特定 S3 Tables 指標的統計資料，請使用 `get-metric-statistics` 命令。例如：
```
aws cloudwatch get-metric-statistics \
--namespace AWS/S3/Tables \
--metric-name TotalBucketStorage \
--dimensions Name=TableBucketName,Value=MyTableBucket \
--start-time 2025-03-01T00:00:00 \
--end-time 2025-03-02T00:00:00 \
--period 86400 \
--statistics Average
```
## 最佳實務
+ 擷取指標時，請根據指標的精細程度設定期間值。對於每日指標 (例如儲存指標)，使用 86400 秒 (24 小時)。對於分鐘層級指標 (例如請求指標)，使用 60 秒。
+ 適當使用維度來篩選所需範圍的指標 (資料表儲存貯體、命名空間或個別資料表層級)。
+ 考量使用指標數學來建立更符合您監控需求的衍生指標。
## 相關資源
+ [Amazon CloudWatch 概念](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html)
+ [使用 Amazon CloudWatch 儀表板](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html)
# 管理 CloudWatch 指標
根據預設，所有 Amazon S3 Tables 和資料表儲存貯體都會啟用儲存指標。您可以透過主控台、 AWS Command Line Interface (AWS CLI) 或 AWS SDKs啟用或停用其他請求指標。
## 先決條件
+ 要求 `s3table:PutTableBucketMetricsConfiguration` IAM 許可。
**注意**
S3 Tables 請求指標的計費方式與 CloudWatch 自訂指標相同。
## 使用 AWS 管理主控台
啟用或停用其他指標
1. 登入 AWS 管理主控台，並在 https：//[https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/) 開啟 Amazon S3 主控台。
1. 在左側導覽窗格中，選擇**資料表儲存貯體**。
1. 在儲存貯體清單中，選擇包含您要為其請求指標之物件的儲存貯體名稱。
1. 選擇**指標**標籤。
1. 從請求指標面板選擇**編輯**。
1. 選擇**已啟用**或**已停用**，然後選取**儲存**。
## 使用 AWS CLI
這些範例示範如何使用 啟用或停用資料表儲存貯體的請求指標 AWS CLI。若要使用這些命令，請以您自己的資訊取代*使用者輸入預留位置*。
**Example ：若要啟用資料表儲存貯體的請求指標：**
```
aws s3tables put-table-bucket-metrics-configuration \
--table-bucket-arn arn:aws:s3tables:us-east-1:111122223333:bucket/amzn-s3-demo-table-bucket
```
**Example ：若要停用資料表儲存貯體的請求指標：**
```
aws s3tables delete-table-bucket-metrics-configuration \
--table-bucket-arn arn:aws:s3tables:us-east-1:111122223333:bucket/amzn-s3-demo-table-bucket
```