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

Claude Code 옵저버빌리티

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

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

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

이것이 작동하는 이유
  • 코드 변경과 동일한 컨텍스트에서 생성된 구조화된 로그입니다.
  • 저장할 대시보드를 추가하기 전에 확인된 이벤트와 SQL을 검토하세요.
  • 프롬프트, 비밀 및 원시 페이로드가 이벤트 데이터에서 제외되도록 수정 우선 지침을 제공합니다.
사용 사례 증거 경로

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

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

  1. 1

    경계를 설정하세요

    완료된 애플리케이션 동작 하나를 골라 Claude Code가 이벤트 기록을 추가하게 하세요.

  2. 2

    결과 캡처

    선택한 애플리케이션 동작에 필요한 필드만 고르고 비공개 콘텐츠와 자격 증명은 제외하세요.

  3. 3

    행을 증명하세요

    해당 동작을 실행하고 저장된 이벤트를 SQL로 확인하세요. 샘플 이벤트만으로는 연동이 완료되지 않습니다.

  4. 4

    결정을 내리세요

    계측 범위를 넓히기 전에 관측된 이벤트와 미확인 범위를 검토하세요.

에이전트 프롬프트

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

YOUR_API_KEY를 기존 서버 측 키로 바꾸거나 가입 없이 첫 이벤트를 시험하세요. 대시보드를 저장하려면 워크스페이스를 계정으로 가져와야 합니다.

에이전트 프롬프트

Claude Code observability 설정 프롬프트

text
/skill.md를 사용하여 실제 애플리케이션 이벤트 하나로 인증된 Telemetry 연동을 확인하세요.

이 Telemetry API 키는 서버 측 코드에서만 사용하세요: YOUR_API_KEY

익명 키는 가입 없이 이벤트 기록과 동기 SQL을 지원합니다. 대시보드나 알림을 만들기 전에 같은 키로 https://telemetry.sh/register에서 기존 워크스페이스를 계정으로 가져오세요. 아직 가져오지 않았다면 이벤트를 쿼리해 전송을 확인하고 가입이 필요한 기능을 알려 주세요.

다음 작업을 수행하세요:
1. 완료된 애플리케이션 동작 하나를 선택하고 가능한 경우 event_name, service, route, status, duration_ms, release를 기록하세요.
2. 자격 증명, 원시 요청 본문 또는 고객 콘텐츠를 기록하지 마세요.
3. 해당 실제 동작을 한 번 실행하고 이벤트가 의도한 워크스페이스에 나타나는지 확인하세요. 이 단계에는 telemetry_quickstart를 사용하지 마세요.
4. 전송 응답을 확인하고 이벤트를 쿼리해 키, 워크스페이스, 테이블이 일치하는지 확인하세요. 전송 실패 시 키를 노출하지 말고 응답 상태를 보고하세요.
5. 확인된 실제 이벤트, 결과의 의미, 다음 애플리케이션 실행 후 다시 확인하는 방법을 알려 주세요.

실제 애플리케이션 동작 하나를 실행하고 저장된 이벤트를 확인하세요. 샘플 이벤트는 진단용일 뿐입니다.

코딩 에이전트로 사용해 보기

설정 단계

  1. 1가입 없이 시작하거나 기존 서버 측 API 키를 사용하세요.
  2. 2완료된 애플리케이션 동작 하나를 골라 Claude Code가 이벤트 기록을 추가하게 하세요.
  3. 3해당 동작을 실행하고 저장된 이벤트를 SQL로 확인하세요. 샘플 이벤트만으로는 연동이 완료되지 않습니다.
  4. 4워크스페이스를 계정으로 가져와 대시보드를 저장하고 출시 전에 결과를 확인하세요.

캡처할 이벤트

agent_task_startedagent_task_completedfeature_usedapi_request_completedcheckout_completedbackground_job_failed

이를 통해 풀리는 질문

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

이벤트 스키마 예제

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

관련 제품 기능

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

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

관련 SQL 레시피

더 많은 SQL 예제

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

모든 레시피 찾아보기

다음 단계

실제 애플리케이션 이벤트 하나 확인

가입 없이 실제 이벤트 하나를 보내고 쿼리하세요. 워크스페이스를 계정으로 가져오면 대시보드를 저장할 수 있습니다.

관련 페이지