mon-get-stats
설명
지정된 통계에 대한 시계열 데이터를 가져옵니다.
참고
mon-put-data
명령을 사용하여 새 지표를 생성하는 경우 mon-get-stats
명령을 사용하여 새 지표에 대한 통계를 검색할 수 있기까지 최대 2분 정도 걸릴 수 있습니다. 그러나 mon-list-metrics
명령을 사용하여 검색된 지표 목록에 새 지표가 나타나기까지는 최대 15분 정도 걸릴 수 있습니다.
구문
mon-get-stats MetricName
--namespace
value
--statistics value
[,value
...] [--dimensions "key1=value1
,key2=value2
..."
] [--end-time value
] [--period value
] [--start-time value
] [--unit value
] [Common Options]
옵션
명칭 | 설명 |
---|---|
|
지표의 이름입니다. 이 값은 유형: 인수 유효한 값: 1~255자인 모든 유효한 메트릭 이름 기본값: 해당 사항 없음 필수 여부: 예 |
|
측정치의 차원입니다. 다음과 같이 차원을 두 가지 방식으로 지정할 수 있으며 형식을 결합하거나 서로 바꿔서 사용할 수 있습니다.
유형: 맵 유효한 값: name=value 형식의 문자열. 여기서 키는 차원의 이름이고 값은 차원의 값입니다. 차원 이름 및 값은 길이가 1~250자인 ANSI 문자열이어야 합니다. 허용되는 최대 차원 수는 10개입니다. 기본값: 해당 사항 없음 필수 항목 여부: 아니요 |
|
반환된 데이터 요소에 대해 마지막으로 허용된 타임스탬프입니다. 종료 시간은 제외됩니다. 타임스탬프는 ISO8601 결합 형식을 사용하여 지정됩니다. 예를 들어 2013년 7월 30일 12:30:00 PST의 날짜 및 시간은 2013-07-30T12:30:00-07:00 또는 UTC: 2013-07-30T19:30:00Z로 표시할 수 있습니다. 모든 타임스탬프는 가장 가까운 분 단위로 반내림되므로 CloudWatch에서 반환할 수 있는 최고 분해능은 1분입니다. 유형: 인수 유효한 값: 유효한 타임스탬프는 시간대 오프셋 또는 UTC 지시자를 사용하여 ISO8601 형식으로 표시됩니다. 기본값: 현재 날짜/시간 필수 항목 여부: 아니요 |
|
지표의 네임스페이스입니다. 네임스페이스에 대한 자세한 내용은 AWS 네임스페이스 단원을 참조하세요. 타입: 문자열 유효한 값: 길이가 1~ 250자인 유효한 네임스페이스 기본값: 해당 사항 없음 필수 여부: 예 |
|
통계를 검색할 세분화 정도(초). 이 기간은 60초 이상으로 60의 배수여야 합니다. 유형: 인수 유효한 값: 60초의 배수인 숫자(초) 기본값: 60초 필수 항목 여부: 아니요 |
|
지정된 지표에 대해 반환할 통계입니다. 유형: 열거 유효한 값: Average, Sum, Maximum 또는 Minimum 기본값: 해당 사항 없음 필수 여부: 예 |
|
반환된 데이터 요소에 대해 처음 허용된 타임스탬프입니다. 시작 시간이 포함됩니다. 타임스탬프는 ISO8601 결합 형식을 사용하여 지정됩니다. 예를 들어 2013년 7월 30일 12:30:00 PST의 날짜 및 시간은 2013-07-30T12:30:00-07:00 또는 UTC: 2013-07-30T19:30:00Z로 표시할 수 있습니다. 모든 타임스탬프는 가장 가까운 분 단위로 반내림되므로 CloudWatch에서 반환할 수 있는 최고 분해능은 1분입니다. 유형: 인수 유효한 값: 유효한 타임스탬프는 시간대 오프셋 또는 UTC 지시자를 사용하여 ISO8601 형식으로 표시됩니다. 기본값: 현재 시간 한 시간 전 필수 항목 여부: 아니요 |
|
지표를 검색할 단위. 메트릭은 여러 단위로 보고될 수 있습니다. 이 명령어는 특정 메트릭에 대한 지정된 단위를 검색합니다. 단위를 요청하지 않으면 모든 단위가 반환됩니다. 메트릭이 단위 하나로만 보고되는 경우에는 단위를 요청하지 않아도 반환되는 결과는 동일합니다. 유형: 열거 유효한 값: 다음 중 하나입니다.
기본값: 해당 사항 없음 필수 항목 여부: 아니요 |
일반 옵션
이름 | 설명 |
---|---|
|
AWS 자격 증명을 포함하는 파일의 위치입니다. 환경 변수 타입: 문자열 유효한 값: 액세스 키 ID 및 비밀 액세스 키를 포함하는 파일의 유효한 경로입니다. 기본값: |
|
요청 서명을 위한 EC2 인증서 파일의 위치입니다. 환경 변수 타입: 문자열 유효한 값: Amazon EC2 또는 AWS Identity and Access Management에서 제공하는 PEM 파일의 유효한 파일 경로입니다. 기본값: |
|
연결 제한 시간 값(초)입니다. 유형: 정수 유효한 값: 양수입니다. 기본값: 30 |
|
구분된(long) 결과를 표시할 때 사용할 구분 기호입니다. 타입: 문자열 유효한 값: 문자열입니다. 기본값: 쉼표(,) |
|
표 형식 또는 구분된 결과를 표시하는 경우 열 머리글을 포함합니다. XML 결과를 표시하는 경우 서비스 요청에서 HTTP 헤더를 반환합니다(해당하는 경우). 유형: 플래그 유효한 값: 제공되면 헤더를 표시합니다. 기본값: |
|
비밀 키와 함께 요청에 서명하는 데 사용할 액세스 키 ID입니다. 이는 --secret-key와 함께 사용해야 합니다. 그렇지 않으면 옵션이 무시됩니다. CloudWatch에 대한 모든 요청에 서명해야 합니다. 그러지 않으면 요청이 거부됩니다. 타입: 문자열 유효한 값: 유효한 액세스 키 ID입니다. 기본값: None |
|
요청에 서명하는 데 사용할 프라이빗 키입니다. 퍼블릭 또는 프라이빗 키를 사용하면 CLI에서 SOAP를 사용하게 됩니다. 퍼블릭 인증서 및 프라이빗 키를 사용하여 요청에 서명합니다. 이 파라미터는 타입: 문자열 유효한 값: 유효한 ASN.1 프라이빗 키에 대한 경로입니다. 기본값: None |
|
요청이 전달되는 리전입니다. 환경 변수 타입: 문자열 유효한 값: AWS 리전(예: us-east-1)입니다. 기본값: |
|
액세스 키 ID와 함께 요청에 서명하는 데 사용할 비밀 액세스 키입니다. 이 파라미터는 타입: 문자열 유효한 값: 액세스 키 ID입니다. 기본값: None |
|
이 데이터가 요청되지 않았음을 나타내는 자리 표시자로 (nil)을 사용하여 빈 필드를 표시합니다. 유형: 플래그 유효한 값: 없음 기본값: 빈 필드는 기본적으로 표시되지 않습니다. |
|
CLI가 AWS를 호출하는 데 사용하는 URL을 표시합니다. 유형: 플래그 유효한 값: 없음 기본값: false |
|
결과가 표시되는 방식을 지정합니다. 예를 들어 결과를 표 형식, 구분된(long) 형식, XML 형식 또는 출력 없음(quiet) 형식으로 표시할 수 있습니다. 유형: 플래그 유효한 값: 없음 기본값: |
|
CloudWatch에 연결할 때 사용하는 URL입니다. 환경 변수 타입: 문자열 유효한 값: 유효한 HTTP 또는 HTTPS URL입니다. 기본값: |
출력
이 명령은 다음이 포함된 표를 반환합니다.
-
Time – 지표가 수집된 시간.
-
SampleCount – 이 열에 적당한 설명이 없습니다.
-
Average - 평균값.
-
Sum - 값의 합계.
-
Minimum – 관찰된 최소값.
-
Maximum – 관찰된 최대값.
-
Unit - 지표의 단위.
Amazon CloudWatch CLI는 stderr에 오류를 표시합니다.
예
요청 예제
이 예는 1시간의 확인 기간에서 EC2 인스턴스 i-c07704a9에 대한 평균, 최소 및 최대 CPU 사용률을 반환합니다.
mon-get-stats CPUUtilization --start-time 2013-02-14T23:00:00.000Z --end-time 2013-03-14T23:00:00.000Z --period 3600 --statistics "Average,Minimum,Maximum" --namespace "AWS/EC2" --dimensions "InstanceId=i-c07704a9"
다음은 확인 기간이 1분일 때 샘플 및 평균 지표의 출력을 보여주는 예제입니다.
Time Samples Average Unit 2013-05-19 00:03:00 2.0 0.19 Percent 2013-05-19 00:04:00 2.0 0 Percent 2013-05-19 00:05:00 2.0 0 Percent 2013-05-19 00:06:00 2.0 0 Percent 2013-05-19 00:07:00 2.0 0 Percent 2013-05-19 00:08:00 2.0 0 Percent 2013-05-19 00:09:00 2.0 0 Percent 2013-05-19 00:10:00 2.0 0 Percent 2013-05-19 00:11:00 2.0 0 Percent 2013-05-19 00:12:00 2.0 0.195 Percent 2013-05-19 00:13:00 2.0 0.215 Percent ...
요청 예제
이 예는 EC2에서의 CPU 사용률을 반환합니다.
mon-get-stats CPUUtilization --start-time 2013-02-14T23:00:00.000Z --end-time 2013-03-14T23:00:00.000Z --period 3600 --statistics "Average,Minimum,Maximum" --namespace "AWS/EC2"
요청 예제
이 예는 1시간의 확인 기간에서 특정 사용자의 MyService 테스트 스택에 대한 평균, 최소 및 최대 요청 수를 반환합니다.
mon-get-stats RequestCount --start-time 2013-11-24T23:00:00.000Z --end-time 2013-11-25T23:00:00.000Z --period 3600 --statistics "Average,Minimum,Maximum" --namespace "MyService" --dimensions "User=SomeUser,Stack=Test"
요청 예제
이 예는 모든 "MyService"에 대한 RequestCount 통계를 보여줍니다.
mon-get-stats RequestCount --start-time 2013-11-24T23:00:00.000Z --end-time 2013-11-25T23:00:00.000Z --period 3600 --statistics "Average,Minimum,Maximum,SampleCount" --namespace "MyService"