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