콘텐츠로 건너뛰기
Telemetry
Claude Code에 프로덕션 앱 수정을 요청하는 팀용

Claude Code 옵저버빌리티

Claude Code에는 별도의 정리 프로젝트 대신 구현 패스의 텔레메트리 부분을 만드는 프롬프트를 제공합니다.

검토자 Telemetry 제품 팀 . 이벤트 필드, 권장 쿼리, 제외할 데이터를 확인했습니다. 이 페이지의 검토 담당자

다음을 사용하여 리포지토리 전체에서 동일한 검토 지침을 재사용합니다. 에이전트 텔레메트리 Skill.md 가이드.

이것이 작동하는 이유
  • 코드 변경과 동일한 컨텍스트에서 생성된 구조화된 로그입니다.
  • 에이전트가 완료된 후 사람이 검사할 수 있는 대시보드 및 SQL 쿼리입니다.
  • 프롬프트, 비밀 및 원시 페이로드가 이벤트 데이터에서 제외되도록 수정 우선 지침을 제공합니다.
사용 사례 증거 경로

Claude Code observability: 구현부터 결정까지

완전한 claude code observability 측정 루프는 하나의 소유 워크플로우, 제한된 이벤트 계약, 제어된 픽스처 및 누군가가 조치를 취할 수 있는 질문을 연결합니다.

  1. 1

    경계를 설정하세요

    Telemetry 계정과 API 키를 생성합니다.

  2. 2

    결과 캡처

    Begin with agent_task_started, agent_task_completed, feature_used and document the grain of each event.

  3. 3

    행을 증명하세요

    배송 전에 결과 테이블, 차트, 알림을 검토하세요.

  4. 4

    결정을 내리세요

    출시 후 실제로 사용되는 에이전트 작성 기능은 무엇입니까?

에이전트 프롬프트

이것을 코딩 에이전트에 붙여넣으세요.

바꾸기 YOUR_API_KEY 가입 후 에이전트에게 제품 흐름을 실행하고 첫 번째 이벤트를 확인하도록 요청합니다.

에이전트 프롬프트

Claude Code observability 설정 프롬프트

text
Instrument this project with structured logs using /skill.md. Use this Telemetry API key: YOUR_API_KEY Anonymous keys support logging and synchronous SQL without signup. Claim the existing workspace at https://telemetry.sh/register with the same key before creating dashboards or alerts. If it is unclaimed, query the event to verify delivery and report which features need signup. Please: 1. Find the most important user-facing flows, background jobs, and AI/tooling workflows. 2. Add structured logging with snake_case table and field names. 3. Capture the key signals for each workflow, including status, latency, identifiers, and error context when relevant. 4. Run one real user-facing or operational flow through the instrumented application and verify its event appears in Telemetry. Do not use telemetry_quickstart for this milestone. 5. Run a read-only query over that real event, then create a high-level dashboard with charts and tables that summarize the most important signals in this project. 6. Tell me what you instrumented, which real flow you verified, which tables you created, and which dashboard views I should review first. Keep event payloads small and focused. Make dashboard labels and charts easy to scan.

이 프롬프트에 대한 API 키를 생성하고, 작동 중인 에이전트 이벤트를 미리 보고, 애플리케이션이 준비되면 샘플을 교체하세요.

이 설정을 무료로 열어보세요

설정 단계

  1. 1Telemetry 계정과 API 키를 생성합니다.
  2. 2기능 또는 옵저버빌리티 단계 시작 시 Claude Code에 프롬프트를 붙여넣습니다.
  3. 3Claude Code에게 앱 흐름을 실행하고, 테스트 이벤트를 보내고, 대시보드를 생성하도록 요청하세요.
  4. 4배송 전에 결과 테이블, 차트, 알림을 검토하세요.

캡처할 이벤트

agent_task_startedagent_task_completedfeature_usedapi_request_completedcheckout_completedbackground_job_failed

이를 통해 풀리는 질문

  • 출시 후 실제로 사용되는 에이전트 작성 기능은 무엇입니까?
  • Claude Code 변경으로 인해 지원 또는 안정성 위험이 발생하는 부분은 어디입니까?
  • 더 많은 자동화가 추가되기 전에 어떤 워크플로에서 알림을 받아야 합니까?

이벤트 스키마 예제

쿼리 또는 스니펫을 프로덕션에 적용하기 전에 행 그레인, 방출 경계, 필수 유형, 개인 정보 보호 클래스, 예제 페이로드 및 유효성 검사 체크리스트를 검토하세요.

관련 제품 기능

이 워크플로를 다음에서 계속하세요. 대시보드

검증된 제품 또는 수익 쿼리를 집중적인 의사 결정 표면으로 전환하세요.

관련 SQL 레시피

더 많은 SQL 예제

이 워크플로의 구조화된 필드에 대해 쿼리를 실행하고, 예제 결과를 검사하고, 유용한 답변을 대시보드 또는 알림으로 전환하세요.

모든 레시피 찾아보기

다음 단계

에이전트가 사용할 API 키를 생성하세요.

무료 플랜은 프롬프트를 실행하고, 테스트 이벤트를 보내고, 첫 번째 대시보드를 검토하는 데 충분합니다.

관련 페이지