CloudWatch에서 규칙에 따라 생성된 지표 그래프 작성 - Amazon CloudWatch
Contributor Insights 지표 데이터에 대한 경보 설정하기

CloudWatch에서 규칙에 따라 생성된 지표 그래프 작성

Contributor Insights는 지표 수학 함수 INSIGHT_RULE_METRIC을 제공합니다. 이 함수를 사용하여 Contributor Insights 보고서의 데이터를 CloudWatch 콘솔 [지표(Metrics)] 탭의 그래프에 추가할 수 있습니다. 이 수학 함수를 기반으로 경보를 설정할 수도 있습니다. 지표 수학 함수에 대한 자세한 내용은 CloudWatch 지표에 수학 표현식 사용 단원을 참조하세요.

이 지표 수학 함수를 사용하려면 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 지표 데이터에 대한 경보 설정하기

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 그래프에 수학 표현식 추가 섹션을 참조하세요.