observability-and-instrumentationcommit fe6f081SKILL.md · 모니터링·운영

관측성과 계측

구조화 로그, RED/USE 지표, OpenTelemetry 추적, 증상 기반 알림과 런북으로 운영 환경의 동작을 진단할 수 있게 합니다.

npx skills add addyosmani/agent-skills --skill observability-and-instrumentation

권한: read-repo
write-files
shell
network
호환 도구: Claude Code, Codex, Cursor, Copilot, Gemini CLI
GitHub: 112.3k
출처: 커뮤니티 · Addy Osmani
상태: 스캔 통과
라이선스: MIT
카테고리: 모니터링·운영
저장소: github.com/addyosmani/agent-skills/skills/observability-and-instrumentation

핵심 규칙

계측하기 전에 온콜 담당자가 물을 질문을 적고, 모든 신호가 그중 하나에 답하도록 합니다.

실행 단계

01단계정상 동작 정의
기능에 대해 온콜이 물을 질문 2~4개를 적어 모든 계측의 근거로 삼습니다.
02단계로그와 지표
안정된 이벤트 이름과 상관 ID가 있는 JSON 로그를 남기고 비밀·PII는 기록하지 않으며, RED 지표는 저카디널리티 레이블과 히스토그램으로 잽니다.
03단계분산 추적
OpenTelemetry 자동 계측을 쓰고 의미 있는 작업 단위에만 수동 span을 추가하며, 모든 비동기 경계에서 컨텍스트를 전파합니다.
04단계알림과 런북
사용자가 체감하는 증상에만 알림을 걸고 page와 ticket 두 단계로 나누며, 각 알림을 docs/runbooks/의 런북에 연결합니다.
05단계텔레메트리 검증
스테이징에서 오류를 일으키고 테스트 트래픽을 보내 요청 하나를 추적하며, 각 알림을 한 번 발생시켜 출력을 확인합니다.

권한 설명 (SKILL.md 기준)

기능	필요 여부	설명
파일 쓰기	필요	코드에 로그, 지표, 추적 초기화, 알림 규칙을 추가하고 docs/runbooks/에 런북을 작성합니다.
명령 실행	필요	앱이나 테스트를 실행해 코드 경로를 거치게 하고 실제 로그와 지표 출력을 확인합니다.
네트워크 송신	필요 없음	외부 API 호출을 요구하지 않으며, 스테이징과 추적 UI에서의 확인은 검증 항목으로 설명됩니다.

SKILL.md 프런트매터(YAML)commit fe6f081

---
name: observability-and-instrumentation
description: Instruments code so production behavior is visible and diagnosable. Use when adding logging, metrics, tracing, or alerting. Use when shipping any feature that runs in production and you need evidence it works. Use when production issues are reported but you can't tell what happened from the available data.
---

핵심 규칙

실행 단계

01단계정상 동작 정의

02단계로그와 지표

03단계분산 추적

04단계알림과 런북

05단계텔레메트리 검증

권한 설명 (SKILL.md 기준)

SKILL.md 프런트매터(YAML)

관련 스킬