이 게시물은 AWS에 Claude Code 텔레메트리 기반 Observability 플랫폼을 구축하는 방법을 소개합니다.

개요

• Claude Code의 OTel로 내보내는 8종 메트릭과 5종 이벤트 활용
• 이중 파이프라인 설계: Prometheus(AMP) 기반 메트릭 파이프라인과 S3+Athena 기반 이벤트 파이프라인

핵심 컴포넌트

• 수집: ADOT Collector on ECS/Fargate, OTLP(gRPC/HTTP) 수신 및 파이프라인 분기
• 메트릭: prometheusremotewrite -> AMP, resource_to_telemetry_conversion으로 라벨 변환
• 이벤트: CloudWatch Logs → Firehose → S3(Parquet) 변환, Lambda Transformer로 OTLP 평탄화, EventBridge+Lambda로 Glue 파티션 자동 등록

시각화 및 인사이트

• Managed Grafana에서 Prometheus와 Athena 결합한 6개 대시보드(80패널)로 실시간 모니터링과 심층 분석 통합
• 활용 목표: 사용자별 비용 추적, 모델 효율 비교, 도구 성공률 및 세션 분석