Zettelkasten

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배 작게 잡게 된다.

호출 수 줄이기

  1. 한 요청에 묶기: MetricData 항목은 요청당 1,000개, 요청 크기는 1MB까지다. gzip으로 압축한 본문도 보낼 수 있다. 포인트마다 put_metric_data를 부르던 루프를, 리스트에 모았다가 루프 밖에서 한 번 부르도록 바꾼다.
  2. 미리 집계하기: 한 지표에 1분 안에 값이 여러 개 생기면 StatisticValues(Sum, Minimum, Maximum, SampleCount) 하나로 보낸다. 백분위가 필요하면 Values/Counts 배열을 쓴다(지표당 값 150개까지). statistic set으로 보내면 SampleCount가 1이거나 Minimum과 Maximum이 같을 때만 백분위를 구할 수 있다.
  3. 받아줄 시각만 보내기: 2시간보다 먼 미래나 2주보다 오래된 타임스탬프는 거부된다. 거부된 호출의 과금 여부는 AWS 문서에 없다(미검증). 하지만 호출 수와 실행 시간은 그대로 쓴다.
  4. 로그로 보내기(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에도 남지 않는다. 켜려면 데이터 이벤트 요금이 따로 붙는다.
  • 그래서 지표로 역추적했다.
    1. AWS/Usage 네임스페이스의 CallCount(Service=CloudWatch, Type=API, Resource=PutMetricData)로 시간대별 호출 수를 뽑는다.
    2. 커스텀 네임스페이스마다 SampleCount를 합해 호출 수와 비교한다. 호출이 샘플보다 많으면 거부되는 호출이 있다는 신호다.
    3. 시간대별 호출 패턴을 람다마다 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건으로 무료 한도 안이다.

관련 노트

참고