CloudWatch GetMetricStatistics API 호출이 데이터 요소를 반환하지 않는 이유는 무엇인가요?

해결 방법

참고: AWS Command Line Interface(AWS CLI) 명령을 실행할 때 오류가 발생할 경우 AWS CLI의 최신 버전을 사용하고 있는지 확인하세요.

CloudWatch는 리전별 서비스이므로 API 호출이 올바른 AWS 리전을 사용하는지 확인해야 합니다. GetMetricStatistics API 호출은 여러 인수를 포함하여 발행되므로 이러한 인수가 지표의 속성과 일치해야 합니다. 인수는 대소문자를 구분하므로 이름과 대소문자가 CloudWatch 콘솔 구성과 일치하는지 확인해야 합니다. 오류는 대부분 잘못된 인수로 인해 발생합니다.

차원

지표가 여러 차원을 포함하여 생성된 경우, 구성된 모든 차원을 지정한 경우에만 해당 데이터 요소를 검색할 수 있습니다. 예를 들어, DataCenterMetric 네임스페이스에 ServerStats라는 이름의 지표를 다음 속성과 함께 게시하는 경우를 가정해 보겠습니다.

Dimensions: Server=Prod, Domain=Frankfurt, Unit: Count, Timestamp: 2016-10-31T12:30:00Z, Value: 105

이 지표에 대한 데이터 요소를 검색하기 위해 다음 차원을 지정합니다.

Server=Prod,Domain=Frankfurt

그러나 두 차원 중 하나만 지정하는 경우에는 데이터 요소를 검색할 수 없습니다. 다음 예시를 참조하세요.

Server=Prod

AWS CLI에서는 get-metric-statistics 명령의 차원을 지정하는 형식이 put-metric-data 명령과 다릅니다. 반드시 다음과 유사한 형식을 사용해야 합니다.

"Name"=string, "Value"=string

참고: 이 경우 Name=Value 형식은 실패합니다.

get-metric-statistics 호출의 다음 예를 참조하세요.

aws cloudwatch get-metric-statistics --metric-name "MyMetric" --start-time 2018-04-08T23:18:00Z --end-time 2018-04-09T23:18:00Z --period 3600 --namespace "MyNamespace" --statistics Maximum --dimensions Name=Server,Value=Prod

put-metric-data 호출의 다음 예를 참조하세요.

aws cloudwatch put-metric-data --namespace "MyNamespace" --metric-name "MyMetric" --dimensions Server=Prod --value 10

기간

지표를 지정된 기간 값 동안 푸시하지 않으면 데이터 요소가 반환되지 않습니다..

예를 들어, 인스턴스에 대한 기본 모니터링을 활성화한 경우, Amazon Elastic Compute Cloud(Amazon EC2)는 5분마다 데이터 요소를 푸시합니다. 예를 들어, Amazon EC2에서 데이터 요소를 타임스탬프 12:00, 12:05, 12:10...와 같은 시점에서 푸시한다고 가정해 보겠습니다. 시작 시간과 종료 시간이 12:01과 12:04인 경우에는 60초 기간으로 데이터 요소를 검색하려고 합니다. 이 경우에는 데이터 요소가 표시되지 않습니다. 시작 시간과 종료 시간을 지표가 제공하는 최소 세분 시간 이상으로 연장하는 것이 가장 좋습니다. (이 사용 사례의 경우 세부 시간은 5분입니다.) 또는 지표가 제공하는 최소 세분 시간보다 크거나 같은 기간을 사용합니다.

통계

지표의 백분위수 통계를 검색하려면 ExtendedStatistic을 사용합니다.

CloudWatch는 원시 데이터 요소를 사용하여 백분위수를 계산합니다. 통계 세트를 사용하여 데이터를 게시하면 아래 조건 중 하나가 참일 경우에만 이 데이터에 대한 백분위수 통계를 검색할 수 있습니다.

• 통계 세트의 SampleCount는 1입니다.
• 통계 세트의 최소값과 최대값이 동일.

단위

• 지정된 단위가 지표에 구성된 단위와 다른 경우, 데이터 요소가 반환되지 않습니다.
• 단위 인수를 지정하지 않는 경우, 모든 단위에 대한 데이터 요소가 반환됩니다.

시작 시간 및 종료 시간

• 시작 시간과 종료 시간 인수의 형식은 GetMetricStatistics 설명서에 지정된 형식으로 설정합니다.
• 시간 시간과 종료 시간 사이에 지표에 대한 데이터 요소가 푸시되지 않는 경우 데이터 요소가 반환되지 않습니다.

참고: 24시간 또는 그 이상이 지난 타임스탬프의 데이터 요소는 적어도 48시간이 지나야 get-metric-statistics에 사용될 수 있습니다. 자세한 내용은 put-metric-data를 참조하세요.

---

관련 정보

CloudWatch 지표를 게시하는 AWS 서비스