AWS

다운로드 49
업데이트 2022. 6. 6.

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날짜시각집계 기준 시각
value64비트 실수집계 값
dimensions배열측정 기준예: 각 요소는 name 및 value 속성 포함