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

# 在 CloudWatch 中繪製規則產生的指標
<a name="ContributorInsights-GraphReportData"></a>

Contributor Insights 提供指標數學函數 `INSIGHT_RULE_METRIC`。您可以使用此函數，將 Contributor Insights 報表中的資料新增至 CloudWatch 主控台的 **Metrics** (指標) 標籤。您也可以根據此數學函數設定警示。如需指標數學函數的詳細資訊，請參閱 [搭配 CloudWatch 指標使用數學表達式](using-metric-math.md)。

若要使用此指標數學函數，您必須登入擁有 `cloudwatch:GetMetricData` 和 `cloudwatch:GetInsightRuleReport` 許可的帳戶。



語法是 `INSIGHT_RULE_METRIC({{ruleName}}, {{metricName}})`。{{ruleName}} 是 Contributor Insights 規則的名稱。{{metricName}} 是以下清單中的其中一個值。{{metricName}} 的值會判斷數學函數傳回的資料類型。
+ `UniqueContributors` — 每個資料點的唯一貢獻因子數目。
+ `MaxContributorValue` — 每個資料點的最佳貢獻因子值。圖表中每個資料點的參與者的身分可能會變更。

  如果此規則是以 `Count` 彙整，則每個資料點的最高貢獻因子是在該期間中發生次數最多的貢獻因子。如果規則是以 `Sum` 彙整，則最高貢獻因子是該期間中，規則的 `Value` 所指定日誌欄位內總和數最大的貢獻因子。
+ `SampleCount` — 規則符合的資料點數目。
+ `Sum` — 該資料點所表示時間期間內來自所有貢獻因子的值的總和。
+ `Minimum` — 該資料點所表示時間期間內單一觀察的最小值。
+ `Maximum` — 該資料點所表示時間期間內單一觀察的最大值。
+ `Average` — 該資料點所表示時間期間內來自所有貢獻因子的平均值。

## 在 Contributor Insights 指標資料上設定警示
<a name="ContributorInsights-GraphReportData-Alarm"></a>

您可以使用函數 `INSIGHT_RULE_METRIC`，對 Contributor Insights 產生的指標設定警示。例如，您可以根據遭拒絕傳輸控制通訊協定 (TCP) 連線百分比來建立警示。如果要開始使用此類警示，您可以建立類似於以下兩個範例中所示的規則：

**規則範例：「RejectedConnectionsRule」**

```
{
    "Schema": {
        "Name": "CloudWatchLogRule",
        "Version": 1
    },
    "LogGroupNames": [
        "/aws/containerinsights/sample-cluster-name/flowlogs"
    ],
    "LogFormat": "CLF",
    "Fields": {
        "3": "interfaceID",
        "4": "sourceAddress",
        "8": "protocol",
        "13": "action"
    },
    "Contribution": {
        "Keys": [
            "interfaceID",
            "sourceAddress"
        ],
        "Filters": [
            {
                "Match": "protocol",
                "EqualTo": 6
            },
            {
                "Match": "action",
                "In": [
                    "REJECT"
                ]
            }
        ]
    },
    "AggregateOn": "Sum"
}
```

**規則範例：「TotalConnectionsRule」**

```
{
    "Schema": {
        "Name": "CloudWatchLogRule",
        "Version": 1
    },
    "LogGroupNames": [
        "/aws/containerinsights/sample-cluster-name/flowlogs"
    ],
    "LogFormat": "CLF",
    "Fields": {
        "3": "interfaceID",
        "4": "sourceAddress",
        "8": "protocol",
        "13": "action"
    },
    "Contribution": {
        "Keys": [
            "interfaceID",
            "sourceAddress"
        ],
        "Filters": [{
            "Match": "protocol",
            "EqualTo": 6
        }],
        "AggregateOn": "Sum"
    }
}
```

建立規則後，您便可以在 CloudWatch 主控台中選取 **Metrics** (指標) 索引標籤，您可以在其中使用以下指標數學表達式範例來繪製 Contributor Insights 報告的資料圖表：

**範例：指標數學表達式**

```
e1 INSIGHT_RULE_METRIC("RejectedConnectionsRule", "Sum")
e2 INSIGHT_RULE_METRIC("TotalConnectionsRule", "Sum")
e3 (e1/e2)*100
```

在該範例中，指標數學表達式 `e3` 會傳回所有遭拒絕的 TCP 連線。如果您想要在 20% 的 TCP 連線遭到拒絕時收到通知，您可以透過將閾值從 `100` 變更為 `20` 來修改表達式。

**注意**  
您可以在 **Metrics** (指標) 區段中，對您監控的指標設定警示。在 **Graphed metrics** (圖表化指標) 索引標籤上，您可以選取 **Actions** (動作) 資料欄下的 **Create alarm** (建立警示) 圖示。**Create alarm** (建立警示) 圖示看起來像個鈴鐺。

如需有關繪製指標圖表和使用指標數學函數的詳細資訊，請參閱以下區段：[將數學運算式新增至 CloudWatch 圖形](using-metric-math.md#adding-metrics-expression-console)。