# 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` - 각 데이터 요소에 대한 최상위 기여 요소의 값입니다. 그래프의 각 데이터 포인트에 대해 기고자의 ID가 변경될 수 있습니다.

  이 규칙이 `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"
    }
}
```

규칙을 생성하면 다음의 지표 수학 표현식 예를 사용하여 Contributor Insights가 보고하는 데이터를 그래프로 표시할 수 있는 CloudWatch 콘솔에서 **지표(Metrics)** 탭을 선택합니다.

**예: 지표 수학 표현식**

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

이 예에서 `e3` 지표 수학 표현식은 거부된 모든 TCP 연결을 반환합니다. TCP 연결의 20%가 거부되는 경우 알림을 받으려면, 임곗값을 `100`에서 `20`으로 변경하여 표현식을 수정할 수 있습니다.

**참고**  
**지표(Metrics)** 섹션에서 모니터링하는 지표에 대해 경보를 설정할 수 있습니다. **그래프로 표시된 지표(Graphed metrics)** 탭에서 **작업(Actions)** 열 아래에 있는 **경보 생성(Create alarm)** 아이콘을 선택할 수 있습니다. **경보 생성(Create alarm)** 아이콘은 종 모양으로 되어 있습니다.

지표 그래프 작성 및 지표 수학 함수 사용에 대한 자세한 내용은 [CloudWatch 그래프에 수학 표현식 추가](using-metric-math.md#adding-metrics-expression-console) 섹션을 참조하세요.