관측성 & 계측 (Observability and Instrumentation)

무엇을 해주나

• 기능을 만들 때 "온콜 엔지니어가 물어볼 질문 2~4개"를 먼저 정의하게 하고, 각 질문에 맞는 시그널(로그/메트릭/트레이스)을 고르도록 안내합니다.
• 문자열 보간 대신 구조화 로깅(이벤트명 + 필드), 요청 상관관계 ID(correlation ID), 진입점(scheduler/replay/CLI) 표시 규칙을 코드 예시와 함께 제시합니다.
• 엔드포인트·외부 의존성에는 RED(Rate/Errors/Duration), 리소스에는 USE 메트릭을 적용하고, 카디널리티 폭발(사용자 ID를 라벨로 쓰는 등)을 막는 규칙을 강제합니다.
• OpenTelemetry 기반 분산 트레이싱 셋업, 증상 기반 알림 설계, 3줄짜리 최소 런북 작성법, 마지막으로 "계측 자체를 검증"하는 절차와 체크리스트를 제공합니다.

이런 분께 추천

• 프로덕션 서비스를 운영하는 백엔드·플랫폼·SRE/DevOps 엔지니어
• 장애가 났을 때 "로그를 봐도 뭐가 일어났는지 모르겠다"는 경험이 있는 팀
• 알림이 너무 많아 아무도 보지 않는(알림 피로) 상태를 정리하고 싶은 팀
• PR 리뷰에서 재시도·큐·외부 호출 코드의 계측 누락을 잡고 싶은 리뷰어

활용 예시

1. 결제 재시도 기능 출시 전: "첫 시도 성공률은? 영구 실패 원인은? 결제사가 느려졌나?" 질문을 정의하고 payment_failed 구조화 로그 + 제공사별 지연 히스토그램을 붙입니다.
2. 알림 정리: CPU 85% 같은 원인 기반 페이지를 없애고, 에러율 1% 5분 지속·p99 2초 초과 같은 증상 기반 알림 + docs/runbooks/ 런북 링크로 재구성합니다.
3. 메트릭 비용 폭증 대응: user_id·전체 URL이 라벨로 들어간 시계열을 찾아 route 템플릿·status_class 같은 유한 집합 라벨로 교체하고, 상세 정보는 로그·트레이스로 옮깁니다.

이 파일의 지시를 읽고 그대로 따라서 나를 도와줘:
https://raw.githubusercontent.com/aiskillstore/marketplace/HEAD/pending/addyosmani/observability-and-instrumentation/SKILL.md

내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 aiskillstore/marketplace 의 pending/addyosmani/observability-and-instrumentation 폴더를 내 ~/.claude/skills/observability-and-instrumentation/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.