CloudWatch PutMetricData는 데이터 포인트가 아니라 요청 수로 과금되므로 한 요청에 묶어 보낸다
·수정 2026.10.14·수정 3회
요약
- PutMetricData는 호출 1건마다 요금이 붙는다(서울 1,000건당 $0.01, 매달 무료 100만 건). 데이터 포인트를
MetricData배열에 모아 한 번에 보내면(요청당 최대 1,000개) 호출 수가 포인트 수분의 1로 준다. - 보내기 전에 타임스탬프를 거른다. CloudWatch는 2주 전부터 2시간 후까지만 받고, 범위를 벗어나면
InvalidParameterValue로 거부한다. 거부된 호출도AWS/Usage의 CallCount에 잡혔다(관찰). - 같은 구간을 반복 업로드하면 안 되는 이유: CloudWatch는 같은 시각의 값을 덮어쓰지 않고 샘플로 쌓는다. 비용이 반복 횟수만큼 늘고, Sum과 Average도 틀어진다.
본문
과금 단위
- API 요청: 서울 1,000건당 $0.01(Pricing API 사용 유형
APN2-CW:Requests). 매달 100만 건은 무료지만 GetMetricData, GetInsightRuleReport, GetMetricWidgetImage는 무료 한도에서 빠진다. - 커스텀 지표 보관료(첫 1만 개까지 지표당 월 $0.30)는 이와 별도로 붙는다. 같은 지표가 청구서의 지표 줄과 API 줄에 둘 다 나오는 건 정상이다.
- 함정: 요금 페이지 본문에 "PutMetricData ... $0.01/M requests"라는 문장이 있다. 하지만 같은 페이지의 예시 6은 1,000건당 $0.01로 계산하고, Pricing API도 1,000건당 $0.01이다. 백만 건 단가로 읽으면 비용을 1,000배 작게 잡게 된다.
호출 수 줄이기
- 한 요청에 묶기:
MetricData항목은 요청당 1,000개, 요청 크기는 1MB까지다. gzip으로 압축한 본문도 보낼 수 있다. 포인트마다put_metric_data를 부르던 루프를, 리스트에 모았다가 루프 밖에서 한 번 부르도록 바꾼다. - 미리 집계하기: 한 지표에 1분 안에 값이 여러 개 생기면
StatisticValues(Sum, Minimum, Maximum, SampleCount) 하나로 보낸다. 백분위가 필요하면Values/Counts배열을 쓴다(지표당 값 150개까지). statistic set으로 보내면 SampleCount가 1이거나 Minimum과 Maximum이 같을 때만 백분위를 구할 수 있다. - 받아줄 시각만 보내기: 2시간보다 먼 미래나 2주보다 오래된 타임스탬프는 거부된다. 거부된 호출의 과금 여부는 AWS 문서에 없다(미검증). 하지만 호출 수와 실행 시간은 그대로 쓴다.
- 로그로 보내기(EMF): 람다나 컨테이너라면 Embedded Metric Format 로그를 쓰면 된다. CloudWatch가 로그에서 지표를 뽑으므로
cloudwatch:PutMetricData권한도 호출도 필요 없다. 대신 로그 수집비(서울 GB당 $0.76)와 지표 보관료가 붙는다.- PutMetricData 요청 1건 값($0.00001)이면 로그를 약 13KB 넣을 수 있다.
- 포인트마다 호출하는 구조라면 EMF 쪽이 싸다.
- 이미 1,000개씩 묶어 보내고 있다면 PutMetricData 쪽이 싸다.
같은 구간을 반복 업로드하면 생기는 일
CloudWatch는 같은 시각(또는 같은 기간)에 들어온 값마다 SampleCount, Sum, Minimum, Maximum을 기록한다. 뒤에 들어온 값이 앞의 값을 대체하지 않는다.
- 외부 집계(예: 5분 단위 이벤트 수)를 매분 다시 올리면 Sum이 반복 횟수만큼 부푼다.
- 아직 안 끝난 구간의 중간값이나 미래 구간의 0이 같이 쌓이면 Average와 Minimum이 틀어진다.
- 이렇게 올린 지표에서 믿을 수 있는 통계는 Maximum뿐이다(값이 계속 늘어나기만 하는 카운트일 때). 알람도 Maximum으로 걸어야 한다.
누가 호출하는지 찾기
- PutMetricData는 CloudTrail에서 데이터 이벤트로 분류된다. 기본으로는 기록되지 않고, Event history에도 남지 않는다. 켜려면 데이터 이벤트 요금이 따로 붙는다.
- 그래서 지표로 역추적했다.
AWS/Usage네임스페이스의CallCount(Service=CloudWatch, Type=API, Resource=PutMetricData)로 시간대별 호출 수를 뽑는다.- 커스텀 네임스페이스마다 SampleCount를 합해 호출 수와 비교한다. 호출이 샘플보다 많으면 거부되는 호출이 있다는 신호다.
- 시간대별 호출 패턴을 람다마다 Invocations와 상관계수로 맞춰 보면 호출 주체가 드러난다.
사례 (관찰됨)
Amplitude의 5분 단위 이벤트 수를 매분 가져와 CloudWatch로 옮기는 람다(EventBridge rate(1 minute), 타임아웃 60초)가 있었다.
- 구간마다 호출: 응답의 5분 구간마다 PutMetricData를 따로 불렀다. Amplitude가 그날 끝까지 288개 구간(아직 안 온 구간은 0)을 돌려줘서, 실행 1번에 약 370회를 호출했다.
- 미래 시각 거부: 코드 주석은 "±2시간 확인"이었지만 실제로는 과거만 걸렀다. 그래서 2시간 넘는 미래 구간이 전부 거부됐다. 하루 호출 86만 건 중 71%가 거부였다.
- 타임아웃과 재시도: 오전에는 남은 구간이 많아 60초 타임아웃에 걸렸다. 비동기 호출 재시도(기본 2회)까지 붙어 실행이 분당 3회가 됐다. 그래서 하루 호출 패턴이 "자정~오전 10시는 평평하고, 이후 시간당 1,440건씩 줄어드는" 모양이었다.
- 비용: API 요금은 월 약 $65~250(거부된 호출 과금 여부에 따라)이고, 람다 실행비가 월 약 $8.6 더 붙었다.
- 수정: 지금보다 늦은 구간은 건너뛰고, 지표별로 한 요청에 묶었다. 로컬 재현에서 실행당 호출이 382회에서 2회로 줄었고, 배포 후 실행 1회가 2.7초에 정상 종료됐다. 예상 호출 수는 하루 약 2,900건으로 무료 한도 안이다.
관련 노트
- enhanced Container Insights는 TaskId로 series를 폭증시키지만 CloudWatch proration이 비용을 수렴시킨다
- 객체 스토리지에 HLS를 쌓으면 세그먼트당 쓰기가 2회여서 짧게 보관하면 요청비가 저장비를 넘는다
- New Relic 파이썬 에이전트는 64KB 이하 페이로드를 압축하지 않는다
- Cloud Monitoring consumed_api 메트릭으로 GCP API 키 사용 패턴을 추적한다
참고
- https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricData.html
- https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/publishingMetrics.html
- https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Embedded_Metric_Format.html
- https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/logging_cw_api_calls.html
- https://aws.amazon.com/cloudwatch/pricing/