aws-cloudwatch-stats
AWS CloudWatch의 지표 통계 데이터를 조회합니다.
aws-cloudwatch-stats span=SPAN [profile=PROFILE] [region=REGION] [duration=NUM{mon|w|d|h|m|s}] [from=yyyyMMddHHmmss] [to=yyyyMMddHHmmss] [stat=STAT] [namespace=NAMESPACE] [metric=METRIC] [dimension=DIMENSION] [value=VALUE]
- span=SPAN
- 시간 단위. s(초), m(분), h(시), d(일), mon(월) 단위로 지정할 수 있습니다. 예를 들면, 10s의 경우 10초 단위로 통계를 생성합니다.
- profile=PROFILE
- AWS 접속 프로파일
- region=REGION
- AWS 리전
- duration=NUM{mon|w|d|h|m|s}
- 현재 시각으로부터 일정 시간 범위 이내의 로그로 한정. s(초), m(분), h(시), d(일), mon(월) 단위로 지정할 수 있습니다. 예를 들면, 10s의 경우 현재 시각으로부터 10초 이전까지의 범위를 의미합니다.
- from=yyyyMMddHHmmss
- yyyyMMddHHmmss 포맷으로 범위의 시작을 지정합니다. 뒷자리를 쓰지 않으면 0으로 채워집니다.
- to=yyyyMMddHHmmss
- yyyyMMddHHmmss 포맷으로 범위의 끝을 지정합니다. 뒷자리를 쓰지 않으면 0으로 채워집니다.
- stat=STAT
- min, max, sum, avg, count 중 하나. 기본값은 평균입니다.
- namespace=NAMESPACE
- 특정 네임스페이스 검색
- metric=METRIC
- 특정 지표 검색
- dimension=DIMENSION
- 특정 측정 기준 검색
- value=VALUE
- 특정 값 검색
AWS IAM 정책
이 명령어를 사용하려면 AWS IAM 정책에 아래 권한을 허용해야 합니다:
- cloudwatch:GetMetricData
출력 필드
| 필드 | 타입 | 이름 | 설명 |
|---|---|---|---|
| aws_profile | 문자열 | 접속 프로파일 | AWS 접속 프로파일 식별자 |
| region | 문자열 | 리전 | 예: ap-northeast-2 |
| namespace | 문자열 | 네임스페이스 | 예: AWS/EC2, AWS/RDS |
| metric | 문자열 | 지표 | 예: CPUUtilization, NetworkPacketsOut |
| label | 문자열 | 이름 | 측정 기준과 지표 조합으로 만든 이름 |
| _time | 날짜 | 시각 | 집계 기준 시각 |
| value | 64비트 실수 | 값 | 집계 값 |
| dimensions | 배열 | 측정 기준 | 예: 각 요소는 name 및 value 속성 포함 |