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

# Performance Insights 的 Amazon CloudWatch 指標
<a name="performance-insights-cloudwatch"></a>

績效詳情會自動將指標發佈至 Amazon CloudWatch。您可以透過績效詳情來查詢相同的資料，但在 CloudWatch 中具備這些指標可讓您輕鬆新增 CloudWatch 警示。您也可以輕鬆將指標新增至現有的 CloudWatch 儀表板。


| 指標 | 描述 | 
| --- | --- | 
|  DBLoad  |  Amazon DocumentDB 的作用中工作階段數目。您通常會需要平均作用中工作階段數量的資料。在績效詳情中，系統會以 `db.load.avg` 的形式來查詢此資料。  | 
|  DBLoadCPU  |  等待狀態類型為 CPU 的作用中工作階段數目。在績效詳情中，此資料會查詢為 `db.load.avg`，並依等待狀態類型 篩選`CPU`。  | 
|  DBLoadNonCPU  |  等待狀態類型不是 CPU 的作用中工作階段數量。  | 

**注意**  
只有當資料庫執行個體上有負載時，這些指標才會發佈至 CloudWatch。

您可以使用 CloudWatch 主控台、 AWS CLI或 CloudWatch API 來檢查這些指標。

例如，您可以執行 [get-metric-statistics](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/get-metric-statistics.html) 命令來取得 `DBLoad` 指標的統計。

```
aws cloudwatch get-metric-statistics \
    --region ap-south-1 \
    --namespace AWS/DocDB \
    --metric-name DBLoad  \
    --period 360 \
    --statistics Average \
    --start-time 2022-03-14T8:00:00Z \
    --end-time 2022-03-14T9:00:00Z \
    --dimensions Name=DBInstanceIdentifier,Value=documentdbinstance
```

此範例會產生類似下列範例的輸出結果。

```
{
    "Datapoints": [
        {
            "Timestamp": "2022-03-14T08:42:00Z", 
            "Average": 1.0, 
            "Unit": "None"
        }, 
        {
            "Timestamp": "2022-03-14T08:24:00Z", 
            "Average": 2.0, 
            "Unit": "None"
        }, 
        {
            "Timestamp": "2022-03-14T08:54:00Z", 
            "Average": 6.0, 
            "Unit": "None"
        }, 
        {
            "Timestamp": "2022-03-14T08:36:00Z", 
            "Average": 5.7, 
            "Unit": "None"
        }, 
        {
            "Timestamp": "2022-03-14T08:06:00Z", 
            "Average": 4.0, 
            "Unit": "None"
        }, 
        {
            "Timestamp": "2022-03-14T08:00:00Z", 
            "Average": 5.2, 
            "Unit": "None"
        }
    ], 
    "Label": "DBLoad"
}
```

您可以使用 CloudWatch 主控台中的`DB_PERF_INSIGHTS`指標數學函數來查詢 Amazon DocumentDB Performance Insights 計數器指標。`DB_PERF_INSIGHTS` 函數也包含以次分鐘為間隔的 `DBLoad` 指標。您可以根據這些指標設定 CloudWatch 警示。如需如何建立警示的詳細資訊，請參閱[從 AWS 資料庫在績效詳情計數器指標上建立警示](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_alarm_database_performance_insights.html)。

如需 CloudWatch 的詳細資訊，請參閱 *Amazon CloudWatch 使用者指南*中的[什麼是 Amazon CloudWatch？](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/WhatIsCloudWatch.html)。