모니터링

​

빠른 시작

# 1. 원격 측정 활성화
export CLAUDE_CODE_ENABLE_TELEMETRY=1

# 2. 내보내기 선택 (둘 다 선택 사항 - 필요한 것만 구성)
export OTEL_METRICS_EXPORTER=otlp       # 옵션: otlp, prometheus, console, none
export OTEL_LOGS_EXPORTER=otlp          # 옵션: otlp, console, none

# 3. OTLP 엔드포인트 구성 (OTLP 내보내기용)
export OTEL_EXPORTER_OTLP_PROTOCOL=grpc
export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317

# 4. 인증 설정 (필요한 경우)
export OTEL_EXPORTER_OTLP_HEADERS="Authorization=Bearer your-token"

# 5. 디버깅용: 내보내기 간격 단축, 프로덕션 사용을 위해 재설정
export OTEL_METRIC_EXPORT_INTERVAL=10000  # 10초 (기본값: 60000ms)
export OTEL_LOGS_EXPORT_INTERVAL=5000     # 5초 (기본값: 5000ms)

# 6. Claude Code 실행
claude

​

관리자 구성

{
  "env": {
    "CLAUDE_CODE_ENABLE_TELEMETRY": "1",
    "OTEL_METRICS_EXPORTER": "otlp",
    "OTEL_LOGS_EXPORTER": "otlp",
    "OTEL_EXPORTER_OTLP_PROTOCOL": "grpc",
    "OTEL_EXPORTER_OTLP_ENDPOINT": "http://collector.example.com:4317",
    "OTEL_EXPORTER_OTLP_HEADERS": "Authorization=Bearer example-token"
  }
}

​

관리 설정이 OTLP 대상을 잠그는 방식

• 엔드포인트: OTEL_EXPORTER_OTLP_ENDPOINT를 설정하면 Claude Code는 개발자가 설정한 모든 신호별 엔드포인트를 제거합니다. 개발자가 한 신호를 다른 수집기로 지정할 수 없으므로 관리 설정에서 신호별 엔드포인트 변수를 설정할 필요가 없습니다.
• 프로토콜: OTEL_EXPORTER_OTLP_PROTOCOL을 설정하면 Claude Code는 개발자가 설정한 모든 신호별 프로토콜을 제거합니다.
• 자격증명: OTEL_EXPORTER_OTLP_HEADERS, OTEL_EXPORTER_OTLP_CLIENT_KEY 또는 OTEL_EXPORTER_OTLP_CLIENT_CERTIFICATE를 설정하면 Claude Code는 해당 변수의 개발자 설정 신호별 버전과 모든 개발자 설정 엔드포인트 변수(일반 또는 신호별)를 제거합니다. 이러한 자격증명이 관리 설정이 선택하지 않은 수집기에 도달할 수 있기 때문입니다.
• 내보내기 선택기: OTEL_METRICS_EXPORTER, OTEL_LOGS_EXPORTER 및 베타 OTEL_TRACES_EXPORTER는 일반적인 키별 우선순위를 따릅니다. 개발자의 설정이 여전히 신호를 비활성화하거나 콘솔 내보내기로 전환할 수 있으므로 필요한 경우 관리 설정에서도 선택기를 설정하세요. 관리 소스에서 OTEL_LOGS_EXPORTER는 원격 측정 단위를 따르는 반면 다른 두 선택기는 키별로 병합됩니다. Claude Code v2.1.223 이상이 필요합니다.
• 베타 추적 엔드포인트: 상세 베타 추적이 활성화되면 Claude Code는 로그 및 추적 내보내기를 통해서가 아니라 BETA_TRACING_ENDPOINT로 내보냅니다. 따라서 Claude Code는 다음 관리 설정 중 하나가 신호의 대상을 결정할 때마다 개발자 설정 BETA_TRACING_ENDPOINT를 제거합니다:
  • 일반 또는 로그/추적 엔드포인트 또는 자격증명
  • otelHeadersHelper
  • none, console 또는 비어있음으로 설정된 로그 또는 추적 내보내기 선택기(신호를 수집기에서 유지하는 값)
  • CLAUDE_CODE_ENABLE_TELEMETRY 비활성화
  메트릭 전용 엔드포인트 또는 자격증명은 제거하지 않습니다. v2.1.251 이전에는 개발자 설정 BETA_TRACING_ENDPOINT가 관리 설정이 수집기를 고정했을 때도 상세 베타 추적이 내보내는 로그 및 추적을 리디렉션했습니다.

​

구성 세부 정보

​

일반적인 구성 변수

​

mTLS 인증

​

메트릭 카디널리티 제어

​

추적 (베타)

​

스팬 계층 구조

claude_code.interaction
├── claude_code.llm_request
├── claude_code.hook                    (상세 베타 추적 필요)
└── claude_code.tool
    ├── claude_code.tool.blocked_on_user
    ├── claude_code.tool.execution
    └── (Agent 도구) 하위 에이전트 claude_code.llm_request / claude_code.tool 스팬

​

스팬 속성

• Read, Edit, Write, Bash, WebFetch, WebSearch 및 MCP 도구 이외의 도구에 대한 호출
• 이미지, PDF 또는 콘텐츠가 변경되지 않은 파일의 재읽기와 같이 파일 텍스트 이외의 것을 반환하는 Read
• OTEL_LOG_TOOL_DETAILS=1도 설정하지 않으면 Edit 또는 Write 호출
• Claude Code가 쿼리된 메시지를 즉시 보내기 위해 턴을 중단했기 때문에 백그라운드로 이동한 WebFetch 또는 WebSearch 호출. Claude는 도구 스팬이 끝난 후 해당 결과를 나중에 받습니다.

​

동적 헤더

​

설정 구성

{
  "otelHeadersHelper": "/path/to/generate-otel-headers.sh"
}

​

스크립트 요구 사항

#!/bin/bash
# 예: 여러 헤더
echo "{\"Authorization\": \"Bearer $(get-token.sh)\", \"X-API-Key\": \"$(get-api-key.sh)\"}"

• 대화형 세션의 경고 알림 (도우미가 처음 실패할 때 세션당 한 번 표시되는 otelHeadersHelper failed; telemetry is not being exported)
• /status 출력
• --debug로 실행하거나 세션에서 /debug를 실행한 후의 디버그 로그
• -p로 시작된 비대화형 세션의 stderr

​

새로 고침 동작

​

다중 팀 조직 지원

# 팀 식별을 위한 사용자 정의 속성 추가
export OTEL_RESOURCE_ATTRIBUTES="department=engineering,team.id=platform,cost_center=eng-123"

• 팀 또는 부서별로 메트릭 필터링
• 비용 센터별 비용 추적
• 팀별 대시보드 생성
• 특정 팀에 대한 경고 설정

export OTEL_RESOURCE_ATTRIBUTES="org.name=Johns_Organization"
export OTEL_RESOURCE_ATTRIBUTES="org.name=JohnsOrganization"

export OTEL_RESOURCE_ATTRIBUTES="org.name=John%27s%20Organization"

​

예제 구성

export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=console
export OTEL_METRIC_EXPORT_INTERVAL=1000

export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=otlp
export OTEL_EXPORTER_OTLP_PROTOCOL=grpc
export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317

export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=prometheus

export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=console,otlp
export OTEL_EXPORTER_OTLP_PROTOCOL=http/json

export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=otlp
export OTEL_LOGS_EXPORTER=otlp
export OTEL_EXPORTER_OTLP_METRICS_PROTOCOL=http/protobuf
export OTEL_EXPORTER_OTLP_METRICS_ENDPOINT=http://metrics.example.com:4318
export OTEL_EXPORTER_OTLP_LOGS_PROTOCOL=grpc
export OTEL_EXPORTER_OTLP_LOGS_ENDPOINT=http://logs.example.com:4317

export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=otlp
export OTEL_EXPORTER_OTLP_PROTOCOL=grpc
export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317

export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_LOGS_EXPORTER=otlp
export OTEL_EXPORTER_OTLP_PROTOCOL=grpc
export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317

​

사용 가능한 메트릭 및 이벤트

​

표준 속성

• prompt.id: 사용자 프롬프트를 다음 프롬프트까지의 모든 후속 이벤트와 연관시키는 UUID입니다. 이벤트 상관 속성 참조.
• workspace.host_paths: 데스크톱 앱에서 선택한 호스트 작업 공간 디렉토리(문자열 배열)
• workflow.run_id: Workflow 도구 실행에 속하는 에이전트가 내보낸 API 및 도구 이벤트에서 wf_ 접두사가 붙은 실행 식별자입니다. 하나의 workflow.run_id로 이벤트를 필터링하면 해당 실행의 API 요청 및 도구 결과를 재구성합니다. 식별자는 워크플로우 스크립트가 생성하는 에이전트와 그 에이전트가 차례로 생성하는 모든 에이전트(예: 스킬 호출)를 포함합니다. Workflow 도구 결과에서 보고된 실행 식별자와 일치합니다. 다른 모든 이벤트에는 없습니다. Claude Code v2.1.202 이상 필요
• workflow.name: 워크플로우의 이름(스크립트의 meta.name)으로, workflow.run_id와 함께 내보내집니다. 기본 제공 워크플로우 이름은 실행이 수정되지 않은 기본 제공 스크립트를 실행할 때 그대로 나타납니다. 사용자 작성 이름(기본 제공 스크립트의 편집된 복사본 포함)은 OTEL_LOG_TOOL_DETAILS=1이 설정되지 않은 경우 custom으로 대체됩니다. Claude Code v2.1.202 이상 필요

​

저장소 속성

​

메트릭

​

메트릭 세부 정보

​

세션 카운터

• 모든 표준 속성
• start_type: 세션이 시작된 방식. "fresh", "resume", "continue" 또는 "agents_view" 중 하나입니다. "agents_view" 값은 claude agents 대시보드 프로세스(대화형 세션이 아닌 사용자 시작 로컬 UI)를 식별합니다. 대시보드에서 UI 프로세스 시작을 대화형 세션과 분리하려면 이 값을 필터링합니다.

​

코드 라인 카운터

• 모든 표준 속성
• type: ("added", "removed")
• model: 변경을 수행한 모델의 모델 식별자(예: “claude-sonnet-5”)

​

풀 요청 카운터

• 모든 표준 속성

​

커밋 카운터

• 모든 표준 속성

​

비용 카운터

• 모든 표준 속성
• model: 모델 식별자(예: “claude-sonnet-5”)
• query_source: 요청을 발급한 하위 시스템의 범주. "main", "subagent" 또는 "auxiliary" 중 하나입니다.
• speed: 요청이 빠른 모드를 사용했을 때 "fast". 그 외의 경우 없음
• effort: 요청에 적용된 노력 수준: "low", "medium", "high", "xhigh" 또는 "max". Claude Code가 노력 수준을 보내지 않을 때 없음(예: 노력을 지원하지 않는 모델)
• agent.name: 요청을 발급한 하위 에이전트 유형. 기본 제공 에이전트 이름과 공식 마켓플레이스 플러그인의 에이전트는 그대로 나타납니다. 다른 사용자 정의 에이전트 이름은 "custom"으로 대체됩니다. 요청이 명명된 하위 에이전트 유형에 의해 발급되지 않은 경우 없음
• skill.name: 요청에 대해 활성화된 스킬(Skill 도구 또는 / 명령으로 설정되거나 생성된 하위 에이전트에 의해 상속됨). 기본 제공, 번들, 사용자 정의 및 공식 마켓플레이스 플러그인 스킬 이름은 그대로 나타납니다. 타사 플러그인 스킬 이름은 "third-party"로 대체됩니다. 활성 스킬이 없을 때 없음
• plugin.name: 활성 스킬 또는 하위 에이전트가 플러그인에 의해 제공될 때 소유 플러그인. 공식 마켓플레이스 플러그인 이름은 그대로 나타납니다. 타사 플러그인 이름은 "third-party"로 대체됩니다. 스킬과 하위 에이전트 모두 소유 플러그인이 없을 때 없음
• marketplace.name: 소유 플러그인이 설치된 마켓플레이스. OTEL_LOG_TOOL_DETAILS=1이 설정된 경우에도 공식 마켓플레이스 플러그인에 대해서만 내보내집니다. 그 외의 경우 없음
• mcp_server.name: 이 요청이 소비한 도구 결과의 MCP 서버. 기본 제공, claude.ai 프록시 및 공식 레지스트리 서버 이름은 그대로 나타납니다. 사용자 구성 서버 이름은 "custom"으로 대체됩니다. 요청이 MCP 도구 결과를 소비하지 않았을 때 없음. v2.1.222 이전에는 Claude Code가 MCP 도구 호출 후 모든 요청에 이 속성을 설정했으며, 도구 결과를 소비한 요청에만 설정하지 않았으므로, 이를 집계하는 대시보드는 업그레이드 후 단계 감소를 보여줍니다.
• mcp_tool.name: 이 요청이 소비한 도구 결과의 MCP 도구(동일한 수정 및 버전 동작 포함 mcp_server.name). 요청이 MCP 도구 결과를 소비하지 않았을 때 없음

​

토큰 카운터

• 모든 표준 속성
• type: ("input", "output", "cacheRead", "cacheCreation")
• model: 모델 식별자(예: “claude-sonnet-5”)
• query_source: 요청을 발급한 하위 시스템의 범주. "main", "subagent" 또는 "auxiliary" 중 하나입니다.
• speed: 요청이 빠른 모드를 사용했을 때 "fast". 그 외의 경우 없음
• effort: 요청에 적용된 노력 수준. 세부 정보는 비용 카운터 참조.
• agent.name, skill.name, plugin.name, marketplace.name, mcp_server.name, mcp_tool.name: 요청에 대한 스킬, 플러그인, 에이전트 및 MCP 속성. 정의 및 수정 동작은 비용 카운터 참조.

​

코드 편집 도구 결정 카운터

• 모든 표준 속성
• tool_name: 도구 이름("Edit", "Write", "NotebookEdit")
• decision: 사용자 결정("accept", "reject")
• source: 결정이 나온 위치. "config", "hook", "user_permanent", "user_temporary", "user_abort" 또는 "user_reject" 중 하나입니다. 각 값의 의미는 도구 결정 이벤트 참조.
• language: 편집된 파일의 프로그래밍 언어(예: "TypeScript", "Python", "JavaScript" 또는 "Markdown"). 인식되지 않는 파일 확장자의 경우 "unknown"을 반환합니다.

​

활성 시간 카운터

• 모든 표준 속성
• type: 키보드 상호 작용의 경우 "user", 도구 실행 및 AI 응답의 경우 "cli"

​

이벤트

​

이벤트 상관 속성

• user_prompt, assistant_response 및 api_response_body의 message.uuid
• API 이벤트의 request_id(기록의 어시스턴트 항목에 requestId로 유지됨)
• tool_result 및 tool_decision 이벤트의 tool_use_id

​

사용자 프롬프트 이벤트

• 모든 표준 속성
• event.name: "user_prompt"
• event.timestamp: ISO 8601 타임스탬프
• event.sequence: 이벤트 순서 지정을 위한 프로세스당 카운터(이벤트 상관 속성 참조)
• prompt_length: 프롬프트의 길이
• prompt: 프롬프트 내용. 기본적으로 수정됨. OTEL_LOG_USER_PROMPTS=1을 설정하여 포함
• message.uuid: 결과 사용자 메시지의 UUID(유지된 기록 항목과 일치). 명령 디스패치에는 없습니다(0개 이상의 메시지를 생성할 수 있음). Claude Code v2.1.214 이상 필요
• command_name: 프롬프트가 명령을 호출할 때 명령 이름. compact 또는 debug와 같은 기본 제공 및 번들 명령 이름은 그대로 내보내집니다; reset과 같은 별칭은 정규 이름이 아닌 입력한 대로 내보냅니다. 사용자 정의, 플러그인 및 MCP 명령 이름은 OTEL_LOG_TOOL_DETAILS=1이 설정되지 않은 경우 custom 또는 mcp로 축소됩니다.
• command_source: 명령이 있을 때 명령의 출처: builtin, custom 또는 mcp. 플러그인 제공 명령은 custom으로 보고합니다.

​

어시스턴트 응답 이벤트

• 모든 표준 속성
• event.name: "assistant_response"
• event.timestamp: ISO 8601 타임스탬프
• event.sequence: 이벤트 순서 지정을 위한 프로세스당 카운터(이벤트 상관 속성 참조)
• response_length: 응답 텍스트의 문자 길이
• response: 응답 텍스트(콘텐츠 제한(기본값 60KB)에서 잘림). 기본적으로 <REDACTED>로 수정됨. OTEL_LOG_ASSISTANT_RESPONSES=1을 설정하여 포함. OTEL_LOG_ASSISTANT_RESPONSES가 설정되지 않으면, OTEL_LOG_USER_PROMPTS가 대신 제어하므로, 프롬프트 로깅이 켜져 있는 동안 응답을 수정된 상태로 유지하려면 OTEL_LOG_ASSISTANT_RESPONSES=0을 설정합니다.
• model: 모델 식별자(예: “claude-sonnet-5”)
• request_id: API 요청 ID(이벤트 상관 속성 참조)
• message.uuid: 응답의 최종 기록 항목의 UUID. API 응답은 콘텐츠 블록당 하나의 기록 항목으로 유지됩니다; 이는 마지막 항목이며, 다음 턴의 parentUuid가 이를 연결합니다. Claude Code v2.1.214 이상 필요
• query_source: 요청을 발급한 하위 시스템(예: "repl_main_thread", "compact" 또는 하위 에이전트 이름)

​

도구 결과 이벤트

• 모든 표준 속성
• event.name: "tool_result"
• event.timestamp: ISO 8601 타임스탬프
• event.sequence: 이벤트 순서 지정을 위한 프로세스당 카운터(이벤트 상관 속성 참조)
• tool_name: 도구의 이름
• tool_use_id: 이 도구 호출의 고유 식별자. 훅에 전달된 tool_use_id와 일치하여 OTel 이벤트와 훅 캡처 데이터 간의 상관 관계를 허용합니다.
• success: "true" 또는 "false"
• duration_ms: 밀리초 단위의 실행 시간
• error_type: 도구가 실패했을 때 오류 범주 문자열(예: "Error:ENOENT" 또는 "ShellError")
• error (OTEL_LOG_TOOL_DETAILS=1일 때): 도구가 실패했을 때 전체 오류 메시지
• decision_type: 항상 "accept"(이 이벤트는 도구 실행 후에만 내보내짐). 거부된 호출은 도구 결과를 생성하지 않습니다.
• decision_source: 권한 결정이 나온 위치. "config", "hook", "user_permanent" 또는 "user_temporary" 중 하나입니다. 각 값의 의미는 도구 결정 이벤트 참조. 거부 전용 소스 "user_abort" 및 "user_reject"는 이 이벤트에 나타나지 않습니다.
• tool_input_size_bytes: JSON 직렬화된 도구 입력의 바이트 크기
• tool_result_size_bytes: 도구 결과의 바이트 크기
• mcp_server_scope: MCP 서버 범위 식별자(MCP 도구의 경우)
• vcs.ref.head.revision, vcs.ref.head.name, vcs.ref.head.type (OTEL_LOG_TOOL_DETAILS=1일 때): Bash 또는 PowerShell 도구에서 실행한 성공적인 git commit의 커밋 ID입니다. vcs.ref.head.revision은 커밋 SHA이고, vcs.ref.head.name은 커밋된 브랜치이며, vcs.ref.head.type은 branch입니다. 커밋이 분리된 HEAD에서 이루어진 경우 이름과 유형은 생략됩니다. Claude Code v2.1.269 이상 필요
• tool_parameters (OTEL_LOG_TOOL_DETAILS=1일 때): 도구별 매개변수를 포함하는 JSON 문자열. Claude Desktop의 기본 제공 서버의 경우, Claude Desktop이 소유한 세션에서, mcp_server_name/mcp_tool_name 쌍은 플래그가 꺼져 있어도 포함됩니다(도구 결정 이벤트와 동일한 호스트 작성 예외), Claude Code v2.1.214 이상 필요. 매개변수는 도구에 따라 다릅니다:
  • Bash 도구의 경우: bash_command, full_command, timeout, description 및 dangerouslyDisableSandbox를 포함하며, git commit 명령이 성공할 때 git_commit_id 및 git_branch를 포함합니다. git_commit_id는 커밋이 세션의 작업 디렉토리의 HEAD일 때 전체 커밋 SHA이고, 그 외의 경우 git의 축약된 SHA입니다. git_branch는 커밋된 브랜치이며, 분리된 HEAD에서는 생략됨
  • 데스크톱 앱의 작업 공간 Bash 도구(또한 tool_name을 Bash로 보고함): bash_command, full_command 및 timeout만 포함
  • MCP 도구의 경우: mcp_server_name, mcp_tool_name 포함
  • Skill 도구의 경우: skill_name 포함
  • Agent 도구 또는 레거시 Task 도구의 경우: subagent_type 포함
• tool_input (OTEL_LOG_TOOL_DETAILS=1일 때): JSON 직렬화된 도구 인수. 512자를 초과하는 개별 값은 잘리며, 전체 페이로드는 약 4K 문자로 제한됩니다. MCP 도구를 포함한 모든 도구에 적용됩니다.

​

API 요청 이벤트

• 모든 표준 속성
• event.name: "api_request"
• event.timestamp: ISO 8601 타임스탬프
• event.sequence: 이벤트 순서 지정을 위한 프로세스당 카운터(이벤트 상관 속성 참조)
• model: 사용된 모델(예: “claude-sonnet-5”)
• cost_usd: USD 단위의 예상 비용
• cost_usd_micros: 미국 달러의 백만분의 일 단위의 예상 비용(정수로 내보내짐)
• duration_ms: 밀리초 단위의 요청 기간
• input_tokens: 입력 토큰 수
• output_tokens: 출력 토큰 수
• cache_read_tokens: 캐시에서 읽은 토큰 수
• cache_creation_tokens: 캐시 생성에 사용된 토큰 수
• request_id: "req_011..."과 같은 API 요청 ID(이벤트 상관 속성 참조).
• client_request_id: x-client-request-id 요청 헤더로 전송된 클라이언트 생성 UUID; 존재할 때는 이벤트 상관 속성 표 참조. Claude Code v2.1.214 이상 필요
• speed: 빠른 모드가 활성화되었는지 여부를 나타내는 "fast" 또는 "normal"
• query_source: 요청을 발급한 하위 시스템(예: "repl_main_thread", "compact" 또는 하위 에이전트 이름)
• effort: 요청에 적용된 노력 수준: "low", "medium", "high", "xhigh" 또는 "max". Claude Code가 노력 수준을 보내지 않을 때 없음(예: 노력을 지원하지 않는 모델)
• agent.name, skill.name, plugin.name, marketplace.name, mcp_server.name, mcp_tool.name: 요청에 대한 스킬, 플러그인, 에이전트 및 MCP 속성. 정의 및 수정 동작은 비용 카운터 참조.

​

API 오류 이벤트

• 모든 표준 속성
• event.name: "api_error"
• event.timestamp: ISO 8601 타임스탬프
• event.sequence: 이벤트 순서 지정을 위한 프로세스당 카운터(이벤트 상관 속성 참조)
• model: 사용된 모델(예: “claude-sonnet-5”)
• error: 오류 메시지
• status_code: HTTP 상태 코드(숫자). 연결 실패와 같은 비HTTP 오류의 경우 없음.
• duration_ms: 밀리초 단위의 요청 기간
• attempt: 초기 요청을 포함한 총 시도 횟수(1은 재시도가 발생하지 않았음을 의미)
• request_id: "req_011..."과 같은 API 요청 ID(이벤트 상관 속성 참조).
• client_request_id: x-client-request-id 요청 헤더로 전송된 클라이언트 생성 UUID. 시간 초과 또는 연결 오류와 같은 실패가 서버 request_id를 생성하지 않은 경우에도 사용 가능합니다; 존재할 때는 이벤트 상관 속성 표 참조. Claude Code v2.1.214 이상 필요
• speed: 빠른 모드가 활성화되었는지 여부를 나타내는 "fast" 또는 "normal"
• query_source: 요청을 발급한 하위 시스템(예: "repl_main_thread", "compact" 또는 하위 에이전트 이름)
• effort: 요청에 적용된 노력 수준. Claude Code가 노력 수준을 보내지 않을 때 없음(예: 노력을 지원하지 않는 모델)
• agent.name, skill.name, plugin.name, marketplace.name, mcp_server.name, mcp_tool.name: 요청에 대한 스킬, 플러그인, 에이전트 및 MCP 속성. 정의 및 수정 동작은 비용 카운터 참조.

​

API 거부 이벤트

• 모든 표준 속성
• event.name: "api_refusal"
• event.timestamp: ISO 8601 타임스탬프
• event.sequence: 이벤트 순서 지정을 위한 프로세스당 카운터(이벤트 상관 속성 참조)
• model: 요청의 모델 식별자
• request_id: "req_011..."과 같은 API 요청 ID(이벤트 상관 속성 참조).
• query_source: 요청을 발급한 하위 시스템(예: "repl_main_thread", "compact" 또는 하위 에이전트 이름). 정의는 api_request 참조.
• speed: 빠른 모드가 활성화되었을 때 "fast" 또는 "normal"
• attempt: 재시도 시도 번호. 첫 번째 시도는 1입니다.
• effort: 요청에 적용된 노력 수준. Claude Code가 노력 수준을 보내지 않을 때 없음(예: 노력을 지원하지 않는 모델)
• server_fallback_hop: API의 서버 측 모델 폴백이 이미 다른 모델에서 이 거부를 재시도했으므로 사용자가 이 특정 거부를 보지 못했을 때 true. 요청이 거부로 끝났을 때 false. 단일 턴은 폴백 모델도 거부할 때 나중의 false 최종 이벤트와 true 홉 이벤트를 모두 내보낼 수 있습니다.
• has_category: API 응답이 "cyber", "bio", "frontier_llm" 또는 "reasoning_extraction"의 stop_details.category를 전달했을 때 true. 응답이 범주를 전달하지 않았거나 해당 집합 외의 값을 전달했을 때 false. server_fallback_hop이 true일 때 없음(홉 블록은 stop_details를 전달하지 않음).
• has_explanation: API 응답이 stop_details.explanation을 전달했을 때 true, 그 외의 경우 false. server_fallback_hop이 true일 때 없음.
• category: API 응답의 stop_details.category 값. "cyber", "bio", "frontier_llm" 또는 "reasoning_extraction" 중 하나입니다. OTEL_LOG_TOOL_DETAILS=1이 설정되고 has_category가 true일 때만 존재합니다.
• agent.name, skill.name, plugin.name, marketplace.name, mcp_server.name, mcp_tool.name: 요청에 대한 스킬, 플러그인, 에이전트 및 MCP 속성. 정의 및 수정 동작은 비용 카운터 참조.

​

API 요청 본문 이벤트

• 모든 표준 속성
• event.name: "api_request_body"
• event.timestamp: ISO 8601 타임스탬프
• event.sequence: 이벤트 순서 지정을 위한 프로세스당 카운터(이벤트 상관 속성 참조)
• body: 시스템 프롬프트, 메시지 및 도구와 같은 JSON 직렬화된 Messages API 요청 매개변수(콘텐츠 제한(기본값 60KB)에서 잘림). 이전 어시스턴트 턴의 확장 사고 콘텐츠는 수정됩니다. 인라인 모드(OTEL_LOG_RAW_API_BODIES=1)에서만 내보내집니다.
• body_ref: 잘리지 않은 본문을 포함하는 <dir>/<uuid>.request.json 파일의 절대 경로. 파일 모드(OTEL_LOG_RAW_API_BODIES=file:<dir>)에서만 내보내집니다.
• body_length: 잘리지 않은 본문 길이. OTEL_LOG_RAW_API_BODIES=file:<dir>일 때 UTF-8 바이트, 또는 =1일 때 UTF-16 코드 단위
• body_truncated: 인라인 잘림이 발생했을 때 "true". 파일 모드 및 잘림이 발생하지 않았을 때 없음.
• model: 요청 매개변수의 모델 식별자
• query_source: 요청을 발급한 하위 시스템(예: "compact")
• request_body_id: 이 시도의 요청 본문을 식별하는 UUID. 성공한 시도에 대한 api_response_body 이벤트는 동일한 값을 전달하므로, 응답을 이를 생성한 정확한 요청과 쌍으로 만들 수 있습니다. Claude Code v2.1.274 이상 필요

​

API 응답 본문 이벤트

• 모든 표준 속성
• event.name: "api_response_body"
• event.timestamp: ISO 8601 타임스탬프
• event.sequence: 이벤트 순서 지정을 위한 프로세스당 카운터(이벤트 상관 속성 참조)
• body: id, 콘텐츠 블록, 사용량 및 중지 이유를 포함하는 JSON 직렬화된 Messages API 응답(콘텐츠 제한(기본값 60KB)에서 잘림). 확장 사고 콘텐츠는 수정됩니다. 인라인 모드(OTEL_LOG_RAW_API_BODIES=1)에서만 내보내집니다.
• body_ref: 잘리지 않은 본문을 포함하는 <dir>/<request_id>.response.json 파일의 절대 경로. 파일 모드(OTEL_LOG_RAW_API_BODIES=file:<dir>)에서만 내보내집니다.
• body_length: 잘리지 않은 본문 길이. OTEL_LOG_RAW_API_BODIES=file:<dir>일 때 UTF-8 바이트, 또는 =1일 때 UTF-16 코드 단위
• body_truncated: 인라인 잘림이 발생했을 때 "true". 파일 모드 및 잘림이 발생하지 않았을 때 없음.
• model: 모델 식별자
• query_source: 요청을 발급한 하위 시스템
• request_id: "req_011..."과 같은 API 요청 ID(이벤트 상관 속성 참조).
• request_body_id: 이 응답이 답변하는 api_request_body 이벤트의 request_body_id. Claude Code v2.1.274 이상 필요
• message.id: API가 응답에 할당한 메시지 ID(응답 본문의 id 필드). Claude Code v2.1.274 이상 필요
• message.uuid: 응답의 최종 기록 항목의 UUID. request_body_id와 함께, 기록 메시지를 이를 뒤에 있는 요청 및 응답 본문에 연결합니다. Claude Code v2.1.274 이상 필요

​

도구 결정 이벤트

• 모든 표준 속성
• event.name: "tool_decision"
• event.timestamp: ISO 8601 타임스탬프
• event.sequence: 이벤트 순서 지정을 위한 프로세스당 카운터(이벤트 상관 속성 참조)
• tool_name: 도구의 이름(예: “Read”, “Edit”, “Write”, “NotebookEdit”)
• tool_use_id: 이 도구 호출의 고유 식별자. 훅에 전달된 tool_use_id와 일치하여 OTel 이벤트와 훅 캡처 데이터 간의 상관 관계를 허용합니다.
• decision: "accept" 또는 "reject"
• tool_source: 항상 존재합니다. 도구의 출처(CLI 작성 값의 폐쇄 집합). Claude Code v2.1.214 이상 필요
  • "builtin": CLI 자체의 도구
  • "mcp": 일반적으로 MCP 서버
  • "sdk_host_builtin_mcp": Claude Desktop 자체에 내장된 프로세스 내 서버(Claude Desktop이 소유한 세션). Claude Desktop은 자신의 진입점 중 하나(claude-desktop, claude-desktop-3p 또는 local-agent)에서 시작한 세션을 소유합니다(해당 세션이 중첩된 자식이 아닐 때); 중첩된 세션(Claude Code 자체가 생성하는 세션 포함)은 이러한 서버를 "mcp"로 보고합니다.
• source: 결정이 나온 위치:
  • "config": 프롬프트 없이 자동으로 결정됨(프로젝트 설정, 사용자의 개인 설정의 허용 또는 거부 규칙, 엔터프라이즈 관리 정책, --allowedTools 또는 --disallowedTools 플래그, 활성 권한 모드, 동일한 대화형 CLI 세션의 이전 프롬프트에서 세션 범위 부여, 또는 도구가 본질적으로 안전하기 때문). 이벤트는 이러한 소스 중 어느 것이 일치했는지 나타내지 않습니다. Claude Code는 또한 권한 프롬프트 요청 자체가 실패할 때 "config"을 보고합니다(예: Agent SDK의 canUseTool 콜백 또는 --permission-prompt-tool 도구가 잘못된 결과를 반환하거나, 요청이 보류 중일 때 입력 스트림이 닫힐 때). v2.1.216 이전에는 Claude Code가 이러한 실패를 "user_reject"로 보고했습니다.
  • "hook": PreToolUse 또는 PermissionRequest 훅이 결정을 반환했습니다.
  • "user_permanent": 사용자가 권한 프롬프트에서 “예, 다시 묻지 마세요 …” 를 선택했을 때 내보내집니다(개인 설정에 허용 규칙을 저장함). 대화형 CLI에서는 해당 선택 자체에 대해서만 내보내집니다; 나중에 저장된 규칙과 일치하는 호출은 대신 "config"을 내보냅니다. Agent SDK 또는 비대화형 -p 세션에서는 초기 선택과 나중의 규칙 일치 모두 "user_permanent"를 내보냅니다. 수락으로 취급됩니다.
  • "user_temporary": 사용자가 권한 프롬프트에서 “예”를 선택했거나, 파일 편집 또는 읽기 프롬프트에서 세션의 나머지 부분에 대한 액세스를 부여하는 옵션을 선택했을 때 내보내집니다. 대화형 CLI에서는 선택 자체에 대해서만 내보내집니다; 나중에 해당 세션 범위 부여와 일치하는 호출은 대신 "config"을 내보냅니다. Agent SDK 또는 비대화형 -p 세션에서는 선택과 나중의 일치 모두 "user_temporary"를 내보냅니다. 수락으로 취급됩니다.
  • "user_abort": 사용자가 권한 프롬프트를 답변 없이 해제했을 때 내보내집니다. Agent SDK 및 비대화형 -p 세션에서는 canUseTool 또는 --permission-prompt-tool 권한 요청이 보류 중일 때 턴을 중단하는 것을 포함합니다; v2.1.216 이전에는 Claude Code가 해당 중단을 "user_reject"로 보고했습니다. 거부로 취급됩니다.
  • "user_reject": 사용자가 프롬프트에서 “아니오”를 선택했을 때 내보내집니다. 대화형 CLI에서는 해당 선택 자체에 대해서만 내보내집니다; 사용자의 개인 설정의 거부 규칙과 일치하는 호출은 대신 "config"을 내보냅니다. Agent SDK 또는 비대화형 -p 세션에서는 개인 설정의 거부 규칙과 일치하는 호출이 "user_reject"를 내보냅니다. 거부로 취급됩니다.
• tool_parameters (OTEL_LOG_TOOL_DETAILS=1일 때): 도구별 매개변수를 포함하는 JSON 문자열. 도구 결과 이벤트와 동일한 형태이지만, git_commit_id와 같은 실행 후 필드는 제외됩니다. 권한 결정이 updatedInput을 통해 도구 입력을 다시 쓸 경우 수락된 호출에 대해 tool_result와 다를 수 있습니다. 이 속성을 사용하여 decision이 "reject"일 때 어떤 명령이 거부되었는지 확인합니다.
  • "sdk_host_builtin_mcp" 도구의 경우: mcp_server_name 및 mcp_tool_name은 호스트 애플리케이션이 이러한 이름을 정의하기 때문에 OTEL_LOG_TOOL_DETAILS가 꺼져 있어도 포함됩니다; 이들이 없으면, 이러한 기본 제공 서버 중 하나에 대한 거부된 호출은 기본 스트림에서 속성화할 수 없습니다. 사용자 구성 MCP 서버의 경우, 이벤트의 tool_name은 항상 리터럴 "mcp_tool"이고, 서버 및 도구 이름은 플래그가 켜져 있을 때만 tool_parameters에 나타납니다; 인수 콘텐츠는 모든 곳에서 플래그가 필요합니다. Claude Code v2.1.214 이상 필요
  • Bash 도구의 경우: bash_command, full_command, timeout, description, dangerouslyDisableSandbox 포함. 데스크톱 앱의 작업 공간 bash 도구도 tool_name을 Bash로 보고하지만, bash_command, full_command 및 timeout만 포함
  • MCP 도구의 경우: mcp_server_name, mcp_tool_name 포함
  • Skill 도구의 경우: skill_name 포함
  • Agent 도구 또는 레거시 Task 도구의 경우: subagent_type 포함

​

권한 모드 변경 이벤트

• 모든 표준 속성
• event.name: "permission_mode_changed"
• event.timestamp: ISO 8601 타임스탬프
• event.sequence: 이벤트 순서 지정을 위한 프로세스당 카운터(이벤트 상관 속성 참조)
• from_mode: 이전 권한 모드(예: "default", "plan", "acceptEdits", "auto" 또는 "bypassPermissions")
• to_mode: 새 권한 모드
• trigger: 변경을 유발한 것. "shift_tab", "exit_plan_mode", "auto_gate_denied" 또는 "auto_opt_in" 중 하나입니다. SDK 또는 브리지에서 전환이 시작될 때 없음

​

인증 이벤트

• 모든 표준 속성
• event.name: "auth"
• event.timestamp: ISO 8601 타임스탬프
• event.sequence: 이벤트 순서 지정을 위한 프로세스당 카운터(이벤트 상관 속성 참조)
• action: "login" 또는 "logout"
• success: "true" 또는 "false"
• auth_method: 인증 방법(예: "oauth")
• error_category: 작업이 실패했을 때 범주별 오류 종류. 원시 오류 메시지는 절대 포함되지 않습니다.
• status_code: 작업이 HTTP 오류로 실패했을 때 HTTP 상태 코드(문자열)

​

MCP 서버 연결 이벤트

• 모든 표준 속성
• event.name: "mcp_server_connection"
• event.timestamp: ISO 8601 타임스탬프
• event.sequence: 이벤트 순서 지정을 위한 프로세스당 카운터(이벤트 상관 속성 참조)
• status: "connected", "failed" 또는 "disconnected"
• transport_type: 서버 전송(예: "stdio", "sse" 또는 "http")
• server_scope: 서버가 구성된 범위(예: "user", "project" 또는 "local")
• duration_ms: 밀리초 단위의 연결 시도 기간
• error_code: 연결이 실패했을 때 오류 코드
• is_plugin: 서버가 플러그인에 의해 제공될 때 true, 그 외의 경우 false
• plugin_id_hash (is_plugin이 true일 때): 플러그인 이름과 마켓플레이스의 안정적인 해시(이름을 노출하지 않고 플러그인별로 이벤트를 그룹화하기 위해). Claude Code는 플러그인 로드 이벤트에서 설명한 대로 계산합니다.
• plugin.name (is_plugin이 true일 때): 서버를 제공하는 플러그인의 이름. 타사 플러그인의 경우 OTEL_LOG_TOOL_DETAILS=1이 아닌 경우 리터럴 문자열 "third-party"입니다; 이는 기본적으로 타사 플러그인 이름이 로그에 나타나는 것을 방지합니다. 공식 Anthropic 소스의 플러그인은 항상 이름으로 식별됩니다. plugin_id_hash 및 plugin.name 속성은 자신의 모니터링 백엔드로 흐르며 Anthropic으로 전송되지 않습니다.
• server_name (OTEL_LOG_TOOL_DETAILS=1일 때): 구성된 서버 이름
• error (OTEL_LOG_TOOL_DETAILS=1일 때): 연결이 실패했을 때 전체 오류 메시지

​

내부 오류 이벤트

• 모든 표준 속성
• event.name: "internal_error"
• event.timestamp: ISO 8601 타임스탬프
• event.sequence: 이벤트 순서 지정을 위한 프로세스당 카운터(이벤트 상관 속성 참조)
• error_name: 오류 클래스 이름(예: "TypeError" 또는 "SyntaxError")
• error_code: 오류에 있을 때 "ENOENT"와 같은 Node.js errno 코드

​

플러그인 설치 이벤트

• 모든 표준 속성
• event.name: "plugin_installed"
• event.timestamp: ISO 8601 타임스탬프
• event.sequence: 이벤트 순서 지정을 위한 프로세스당 카운터(이벤트 상관 속성 참조)
• marketplace.is_official: 마켓플레이스가 공식 Anthropic 마켓플레이스인 경우 "true", 그 외의 경우 "false"
• install.trigger: "cli" 또는 "ui"
• plugin.name: 설치된 플러그인의 이름. 타사 마켓플레이스의 경우 OTEL_LOG_TOOL_DETAILS=1일 때만 포함됨
• plugin.version: 마켓플레이스 항목에서 선언된 경우 플러그인 버전. 타사 마켓플레이스의 경우 OTEL_LOG_TOOL_DETAILS=1일 때만 포함됨
• marketplace.name: 플러그인이 설치된 마켓플레이스. 타사 마켓플레이스의 경우 OTEL_LOG_TOOL_DETAILS=1일 때만 포함됨

​

플러그인 로드 이벤트

• 모든 표준 속성
• event.name: "plugin_loaded"
• event.timestamp: ISO 8601 타임스탬프
• event.sequence: 이벤트 순서 지정을 위한 프로세스당 카운터(이벤트 상관 속성 참조)
• plugin.name: 플러그인의 이름. 공식 마켓플레이스 및 기본 제공 번들 외부의 플러그인의 경우 OTEL_LOG_TOOL_DETAILS=1이 아닌 경우 "third-party"
• marketplace.name: 플러그인이 설치된 마켓플레이스(알려진 경우). plugin.name과 동일한 조건에서 "third-party"로 수정됨
• plugin.version: 플러그인 매니페스트의 버전. 이름이 수정되지 않고 매니페스트가 버전을 선언할 때만 포함됨
• plugin.scope: 플러그인의 출처 범주: "official", "community", "org", "user-local" 또는 "default-bundle"
• enabled_via: 플러그인이 활성화되는 방식: "default-enable", "org-policy", "admin-install", "seed-mount" 또는 "user-install". "admin-install" 값은 플러그인이 조직 설정 > 플러그인 및 스킬에서 조직에 필수 또는 자동 설치로 설정되어 있음을 의미합니다. v2.1.246 이전에는 Claude Code가 이러한 플러그인을 "user-install" 또는 "seed-mount"로 보고했습니다.
• plugin_id_hash: 플러그인 이름과 마켓플레이스의 결정적 해시(구성된 내보내기로만 전송됨). 이름을 기록하지 않고 플릿 전체에서 로드된 서로 다른 타사 플러그인을 계산할 수 있습니다. claude.ai에서 동기화된 플러그인의 경우, Claude Code는 플러그인 이름을 claude.ai가 플러그인에 대해 보고하는 마켓플레이스 이름 또는 그 외의 경우 synced와 함께 해시합니다. v2.1.246 이전에는 Claude Code가 해시에서 claude.ai가 보고하는 마켓플레이스 이름을 사용하지 않았습니다.
• has_hooks: 플러그인이 훅을 제공하는지 여부
• has_mcp: 플러그인이 MCP 서버를 제공하는지 여부
• host_owned_mcp: SDK 호스트가 이 플러그인의 MCP 연결을 관리하고 Claude Code가 플러그인의 MCP 서버 구성 읽기를 건너뛸 때 true, 그 외의 경우 false. Claude Code v2.1.172 이상 필요
• skill_path_count: 플러그인이 선언하는 스킬 디렉토리 수
• command_path_count: 플러그인이 선언하는 명령 디렉토리 수
• agent_path_count: 플러그인이 선언하는 에이전트 디렉토리 수
• safe_mode: 세션이 --safe-mode로 시작되었을 때 "true", 그 외의 경우 "false". 안전 모드에서 이 이벤트는 구성된 인벤토리만 보고합니다; 플러그인의 명령, 스킬, 훅 및 MCP 서버는 로드되지 않습니다. Claude Code v2.1.169 이상 필요

​

스킬 활성화 이벤트

• 모든 표준 속성
• event.name: "skill_activated"
• event.timestamp: ISO 8601 타임스탬프
• event.sequence: 이벤트 순서 지정을 위한 프로세스당 카운터(이벤트 상관 속성 참조)
• skill.name: 스킬의 이름. 사용자 정의 및 타사 플러그인 스킬의 경우 OTEL_LOG_TOOL_DETAILS=1이 아닌 경우 자리 표시자 "custom_skill"
• invocation_trigger: 스킬이 트리거된 방식("user-slash", "claude-proactive" 또는 "nested-skill")
• skill.source: 스킬이 로드된 위치(예: "bundled", "userSettings", "projectSettings", "plugin")
• skill.kind: 스킬이 워크플로우 스킬일 때 "workflow". 그 외의 경우 없음
• plugin.name (OTEL_LOG_TOOL_DETAILS=1이거나 플러그인이 공식 마켓플레이스에서 온 경우): 스킬이 플러그인에 의해 제공될 때 소유 플러그인의 이름
• marketplace.name (OTEL_LOG_TOOL_DETAILS=1이거나 플러그인이 공식 마켓플레이스에서 온 경우): 스킬이 플러그인에 의해 제공될 때 소유 플러그인이 설치된 마켓플레이스

​

@멘션 이벤트

• 모든 표준 속성
• event.name: "at_mention"
• event.timestamp: ISO 8601 타임스탬프
• event.sequence: 이벤트 순서 지정을 위한 프로세스당 카운터(이벤트 상관 속성 참조)
• mention_type: 멘션의 유형("file", "directory", "agent", "mcp_resource", "peer"). "peer" 값은 다른 Claude Code 세션 중 하나를 멘션했음을 의미합니다. Claude Code v2.1.232 이상 필요
• success: 멘션이 성공적으로 해결되었는지 여부("true" 또는 "false")

​

API 재시도 소진 이벤트

• 모든 표준 속성
• event.name: "api_retries_exhausted"
• event.timestamp: ISO 8601 타임스탬프
• event.sequence: 이벤트 순서 지정을 위한 프로세스당 카운터(이벤트 상관 속성 참조)
• model: 사용된 모델
• error: 최종 오류 메시지
• status_code: HTTP 상태 코드(숫자). 비HTTP 오류의 경우 없음.
• total_attempts: 수행된 총 시도 횟수
• total_retry_duration_ms: 모든 시도에 걸친 총 벽시계 시간
• speed: "fast" 또는 "normal"

​

훅 등록 이벤트

• 모든 표준 속성
• event.name: "hook_registered"
• event.timestamp: ISO 8601 타임스탬프
• event.sequence: 이벤트 순서 지정을 위한 프로세스당 카운터(이벤트 상관 속성 참조)
• hook_event: 훅 이벤트 유형(예: "PreToolUse" 또는 "PostToolUse")
• hook_type: 훅 구현 유형: "command", "prompt", "mcp_tool", "http" 또는 "agent"
• hook_source: 훅이 정의된 위치: "userSettings", "projectSettings", "localSettings", "flagSettings", "policySettings" 또는 "pluginHook"
• safe_mode: 세션이 --safe-mode로 시작되었을 때 "true", 그 외의 경우 "false". Claude Code v2.1.169 이상 필요
• hook_matcher (OTEL_LOG_TOOL_DETAILS=1일 때): 훅 구성에서 설정된 경우 훅 구성의 매처 문자열
• plugin.name (hook_source가 "pluginHook"일 때): 기여하는 플러그인의 이름. 공식 마켓플레이스 및 기본 제공 번들 외부의 플러그인의 경우 OTEL_LOG_TOOL_DETAILS=1이 아닌 경우 "third-party"
• plugin_id_hash (hook_source가 "pluginHook"일 때): 플러그인 이름과 마켓플레이스의 결정적 해시(구성된 내보내기로만 전송됨). 이름을 기록하지 않고 기여하는 서로 다른 플러그인을 계산할 수 있습니다. Claude Code는 플러그인 로드 이벤트에서 설명한 대로 계산합니다.

​

훅 실행 시작 이벤트

• 모든 표준 속성
• event.name: "hook_execution_start"
• event.timestamp: ISO 8601 타임스탬프
• event.sequence: 이벤트 순서 지정을 위한 프로세스당 카운터(이벤트 상관 속성 참조)
• hook_event: 훅 이벤트 유형(예: "PreToolUse" 또는 "PostToolUse")
• hook_name: 매처를 포함한 전체 훅 이름(예: "PreToolUse:Write")
• num_hooks: 일치하는 훅 명령 수
• managed_only: 관리 정책 훅만 허용될 때 "true"
• hook_source: "policySettings" 또는 "merged"
• safe_mode: 세션이 --safe-mode로 시작되었을 때 "true", 그 외의 경우 "false". Claude Code v2.1.169 이상 필요
• hook_definitions: 훅 구성의 JSON 직렬화. 상세 베타 추적과 OTEL_LOG_TOOL_DETAILS=1이 모두 활성화되었을 때만 포함됨

​

훅 실행 완료 이벤트

• 모든 표준 속성
• event.name: "hook_execution_complete"
• event.timestamp: ISO 8601 타임스탬프
• event.sequence: 이벤트 순서 지정을 위한 프로세스당 카운터(이벤트 상관 속성 참조)
• hook_event: 훅 이벤트 유형
• hook_name: 매처를 포함한 전체 훅 이름
• num_hooks: 일치하는 훅 명령 수
• num_success: 성공적으로 완료된 수
• num_blocking: 차단 결정을 반환한 수
• num_non_blocking_error: 차단 없이 실패한 수
• num_cancelled: 완료 전에 취소된 수
• total_duration_ms: 모든 일치하는 훅의 벽시계 기간
• stdout_chars: 성공한 일치하는 훅 전체의 stdout 총 문자 수. Claude Code v2.1.280 이상 필요
• additional_context_chars: 일치하는 훅이 반환한 additionalContext의 총 문자 수. Claude Code v2.1.280 이상 필요
• system_message_chars: 일치하는 훅이 반환한 systemMessage의 총 문자 수. Claude Code v2.1.280 이상 필요
• initial_user_message_chars: 일치하는 훅이 반환한 initialUserMessage의 총 문자 수. Claude Code v2.1.280 이상 필요
• num_outputs_persisted: 10,000자 상한을 초과한 훅 출력 수(Claude Code가 파일에 저장함). Claude Code v2.1.280 이상 필요
• managed_only: 관리 정책 훅만 허용될 때 "true"
• hook_source: "policySettings" 또는 "merged"
• safe_mode: 세션이 --safe-mode로 시작되었을 때 "true", 그 외의 경우 "false". Claude Code v2.1.169 이상 필요
• hook_definitions: 훅 구성의 JSON 직렬화. 상세 베타 추적과 OTEL_LOG_TOOL_DETAILS=1이 모두 활성화되었을 때만 포함됨

​

훅 플러그인 메트릭 이벤트

• 모든 표준 속성
• event.name: "hook_plugin_metrics"
• event.timestamp: ISO 8601 타임스탬프
• event.sequence: 이벤트 순서 지정을 위한 프로세스당 카운터(이벤트 상관 속성 참조)
• plugin_id: <name>@<marketplace> 형식의 플러그인 식별자
• hook_event: 메트릭을 내보낸 훅 이벤트 유형
• 최대 20개의 플러그인 내보낸 메트릭 키. 이름은 ^[a-z][a-z0-9_]{0,39}$와 일치합니다. 값은 부울 또는 숫자입니다.

​

압축 이벤트

• 모든 표준 속성
• event.name: "compaction"
• event.timestamp: ISO 8601 타임스탬프
• event.sequence: 이벤트 순서 지정을 위한 프로세스당 카운터(이벤트 상관 속성 참조)
• trigger: "auto" 또는 "manual"
• success: "true" 또는 "false"
• duration_ms: 압축 기간
• pre_tokens: 압축 전 대략적인 토큰 수
• post_tokens: 압축 후 대략적인 토큰 수
• error: 압축이 실패했을 때 오류 메시지
• precompute_reuse: trigger가 "manual"일 때만 설정됩니다. 자동 압축은 컨텍스트 윈도우가 채워지기 전에 백그라운드에서 요약을 준비할 수 있으며, 이 속성은 /compact가 해당 준비된 요약을 재사용했는지 기록합니다. "hit"은 재사용되었음을 의미합니다; "miss_custom_instructions", "miss_hook" 및 "miss_not_ready"는 대신 새로운 요약이 계산된 이유를 제공합니다. Claude Code v2.1.153 이상 필요

​

하위 에이전트 완료 이벤트

• 모든 표준 속성
• event.name: "subagent_completed"
• event.timestamp: ISO 8601 타임스탬프
• event.sequence: 이벤트 순서 지정을 위한 프로세스당 카운터(이벤트 상관 속성 참조)
• agent_type: 하위 에이전트 유형. 기본 제공 에이전트 이름과 공식 마켓플레이스 플러그인의 에이전트는 그대로 나타납니다; 다른 에이전트 이름은 OTEL_LOG_TOOL_DETAILS=1이 설정되지 않은 경우 "custom"으로 대체됩니다.
• agent.source: 에이전트 정의가 나온 위치: built-in, plugin 또는 사용자 정의 에이전트를 정의한 설정 소스(예: userSettings 또는 projectSettings)
• is_built_in: 하위 에이전트가 기본 제공 에이전트 유형인지 여부
• is_async: 하위 에이전트가 백그라운드에서 실행되었는지 여부
• total_tokens: 하위 에이전트의 최종 API 요청의 토큰 풋프린트: 해당 하나의 요청의 입력, 캐시 생성, 캐시 읽기 및 출력 토큰(대략 완료 시 하위 에이전트의 컨텍스트 크기). 실행 전체에 걸친 합계가 아님
• total_tool_uses: 하위 에이전트가 전체 실행 전체에서 수행한 도구 호출 수
• duration_ms: 밀리초 단위의 실행 시간
• model: 하위 에이전트가 실행하도록 해결된 모델
• final_model: 하위 에이전트의 최종 응답을 생성한 모델(폴백과 같은 중간 실행 전환 후 model과 다름). Claude Code v2.1.212 이상 필요
• model_swapped: 둘 이상의 모델이 하위 에이전트의 요청을 제공했는지 여부. Claude Code v2.1.212 이상 필요
• plugin_id_hash, plugin.name: 플러그인 제공 에이전트에 대해 존재합니다. 공식 마켓플레이스 플러그인 이름은 그대로 나타납니다; 다른 플러그인 이름은 OTEL_LOG_TOOL_DETAILS=1이 설정되지 않은 경우 "third-party"로 대체됩니다.

​

피드백 설문 이벤트

• 모든 표준 속성
• event.name: "feedback_survey"
• event.timestamp: ISO 8601 타임스탬프
• event.sequence: 이벤트 순서 지정을 위한 프로세스당 카운터(이벤트 상관 속성 참조)
• event_type: 설문 수명 주기 이벤트(예: "appeared", "responded" 또는 "transcript_prompt_appeared")
• appearance_id: 하나의 설문 인스턴스에 대해 내보낸 이벤트를 연결하는 고유 ID
• survey_type: 이벤트를 생성한 설문. "session"은 “Claude가 어떻게 하고 있나요?” 평가 프롬프트입니다.
• response: responded 이벤트의 사용자 선택
• enabled_via_override: CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL이 설정되었을 때 true. 문자열이 아닌 부울로 내보내집니다. session 설문 이벤트에 있습니다. 이 속성을 필터링하여 플릿 전체에서 재정의가 적용되었는지 확인합니다.

​

보존 스윕 이벤트

• 모든 표준 속성
• event.name: "retention_sweep"
• event.timestamp: ISO 8601 타임스탬프
• event.sequence: 이벤트 순서 지정을 위한 프로세스당 카운터(이벤트 상관 속성 참조)
• result: 스윕이 실행되었을 때 "complete", Claude Code가 일시 중지했을 때 "skipped"
• period_days: 병합된 설정의 cleanupPeriodDays 값(일 단위) 또는 소스가 설정하지 않을 때 30. 건너뛴 이벤트에서 스윕이 사용했을 값(Claude Code가 읽을 수 있는 설정 소스에서 계산됨)
• used_default: 읽을 수 있는 설정 소스가 cleanupPeriodDays를 설정하지 않을 때 "true", 그 외의 경우 "false". 완료 이벤트에서 "true"는 30일 기본값이 적용되었음을 의미합니다.
• skip_reason: Claude Code가 스윕을 일시 중지한 이유. result가 "skipped"일 때만 존재:
  • "user_source_disabled": 사용자 설정이 제외됨(예: --setting-sources 플래그 또는 SDK의 settingSources 옵션), 활성화된 소스가 cleanupPeriodDays를 제공하지 않음
  • "settings_unknowable": 설정 파일을 읽거나 구문 분석할 수 없어 cleanupPeriodDays 또는 desktopSessionCleanupPeriodDays가 Claude Code가 볼 수 없는 값으로 설정될 수 있음
  • "settings_invalid_key_set": 설정에 유효성 검사 오류가 있고 cleanupPeriodDays 또는 desktopSessionCleanupPeriodDays가 명시적으로 설정되어 있어 기본값으로 폴백하면 해당 설정에 대해 파일을 삭제하거나 유지할 수 있음
• transcripts_deleted: 스윕이 삭제한 세션 기록(최상위 ~/.claude/projects/*/*.jsonl 파일) 수
• transcripts_exempted_desktop: 보존 기간을 초과했지만 스윕이 Claude Desktop 및 Cowork 규칙에 따라 유지한 기록 수. 이들은 files_past_cutoff에 계산되지 않습니다. Claude Code v2.1.248 이상 필요
• session_files_deleted: 세션 파일 스윕이 삭제한 아티팩트 수: 기록 및 사이드카, 녹음 및 도구 결과와 같은 세션별 동반 파일
• artifacts_deleted: 데이터 디렉토리 전체에서 스윕이 삭제한 총 항목(세션 파일 포함). 일부 스윕은 제거된 전체 디렉토리 트리를 하나의 항목으로 계산하고 몇 가지 정리 통과는 카운터에 기여하지 않으므로, 값을 정확한 파일 수보다는 하한으로 취급합니다.
• files_retained_fresh: 검사되었으며 보존 기간 내에 있기 때문에 제자리에 남겨진 파일. 파일별 스윕만 이들을 계산하므로 값은 하한입니다; 0이 아닌 값은 정상적인 정상 상태입니다.
• files_past_cutoff: 보존 기간보다 오래되었지만 스윕이 삭제하지 못한 파일(예: 권한 오류 또는 열린 파일). 0보다 큰 값은 파일이 구성된 보존 기간을 초과했음을 의미합니다; 0은 없었다는 증거가 아닙니다(전체 디렉토리 제거 실패는 대신 error_count에 계산되기 때문).
• error_count: 스윕이 파일을 나열하거나 삭제하는 동안 발생한 오류 수

​

관리 설정 해결 이벤트

• 관리 설정, 사용자 설정 또는 --settings의 env 블록에 또는 Claude Code를 시작하는 환경에 설정합니다. 프로젝트 또는 로컬 설정의 값은 복제된 저장소가 이들을 쓸 수 있기 때문에 켜지 않습니다.
• 서버 관리 설정은 변수가 조직이 이미 받는 이벤트에 조직 자체의 수정된 정책만 추가하기 때문에 보안 승인 대화를 표시하지 않고 설정할 수 있습니다.

• 모든 표준 속성
• event.name: "managed_settings_resolved"
• event.timestamp: ISO 8601 타임스탬프
• event.sequence: 이벤트 순서 지정을 위한 프로세스당 카운터(이벤트 상관 속성 참조)
• managed_settings.trigger: 세션 시작 이벤트의 경우 "startup", 관리 설정 또는 정책 도우미의 상태가 세션 중에 변경되었을 때 "change", 또는 관리 설정 정책이 세션을 중지했을 때 "refused". Claude Code는 마지막 이벤트와 다른 속성이 있을 때만 change 이벤트를 보내며, 변경된 설정 값은 OTEL_LOG_MANAGED_SETTINGS가 꺼져 있어도 계산됩니다.
• error.type: Claude Code가 세션을 중지한 이유. refused 이벤트에만 존재:
  • "helper_failed": 정책 도우미 실행이 실패함
  • "policy_invalid": 관리 설정에 Claude Code가 시작되지 않도록 하는 오류가 포함되어 있거나, 관리자 소스가 로드되지 않아 Claude Code가 조직 로그인 적용을 확인할 수 없음
  • "consent_rejected": 사용자가 서버 관리 설정에 대한 보안 승인 대화를 거부함
  • "force_refresh_failed": forceRemoteSettingsRefresh가 필요로 하는 설정 가져오기가 실패함
  • "gateway_rejected": Claude 앱 게이트웨이가 관리 설정 로드에 HTTP 403으로 응답함
  • "version_below_minimum": 이 Claude Code 버전이 requiredMinimumVersion 아래 또는 requiredMaximumVersion 위
  • "_OTHER": Claude 앱 게이트웨이 관리 설정 로드가 다른 이유로 실패함
• managed_settings.sources: 정책 키를 최소 하나 전달하는 모든 관리 소스(우선순위 순서대로 최고부터), first-wins에서 효과를 갖지 않는 소스 포함. 값은 "remote", MDM 또는 OS 수준 정책의 경우 "plist" 또는 "hklm", 관리 설정 파일 및 드롭인의 경우 "file", 포함 호스트가 설정을 제공할 때 "parent", Claude Code가 읽을 때 Windows HKCU 레지스트리 값의 경우 "hkcu". 제어 키만 전달하거나 Claude Code가 읽을 수 없는 소스는 나열되지 않습니다. 문자열 배열로 내보내짐, 관리 소스가 정책 키를 전달하지 않을 때 비어 있음
• managed_settings.source_behavior: Claude Code가 읽은 managedSourcesBehavior 값("first-wins" 또는 "merge"). 소스가 키를 설정하지 않을 때 "first-wins"
• managed_settings.helper.state: 선택한 MDM 또는 파일 소스가 구성하는 정책 도우미의 상태:
  • "ok": 도우미의 출력이 관리 설정으로 제공됨
  • "bad_path", "not_a_file", "exit_nonzero", "timed_out", "oversize", "parse_failed", "envelope_invalid" 또는 "schema_rejected": 도우미의 마지막 실행이 실패함. 도우미 실패가 경우를 설명함
  • "none": 도우미가 구성되지 않았거나, 도우미를 구성하는 소스가 MDM 정책 또는 관리 설정 파일이 아님
• managed_settings.helper.applied: 도우미의 자체 출력이 관리 설정으로 제공될 때 "output", 그렇지 않을 때 "none"
• managed_settings.helper.entry: Claude Code가 policyHelper를 선택했을 때 "policyHelper". 도우미를 선택하지 않았을 때 없음
• managed_settings.helper.path: 도우미의 구성된 path. Claude Code가 도우미를 선택했을 때마다 존재(도우미를 선택했는지 여부와 관계없이 OTEL_LOG_MANAGED_SETTINGS가 설정됨)
• managed_settings.resolved_sha256 (OTEL_LOG_MANAGED_SETTINGS=1일 때): 수정 전 해결된 관리 설정의 SHA-256(키가 재귀적으로 정렬되고 공백이 없는 JSON으로 직렬화됨). 동일한 다이제스트를 실행하는 머신은 동일한 정책을 실행합니다. Claude Code는 짧은 정책을 추측 해싱으로 복구할 수 있기 때문에 옵트인으로만 다이제스트를 보냅니다. 관리 설정이 해결되지 않았을 때 없으며, refused 이벤트에는 없음
• managed_settings.settings (OTEL_LOG_MANAGED_SETTINGS=1일 때): 해결된 관리 설정의 이름과 형태(값이 수정됨)를 JSON 문자열로. refused 이벤트에는 없음. Claude Code는 설정 스키마에서 이를 구축합니다:
  • 스키마가 내보내기를 선언하는 설정 이름이 내보내지며, 스키마가 선언하지 않는 키는 생략됨
  • 부울, 숫자 및 스키마가 permissions.defaultMode와 같은 고정 옵션 집합으로 제한하는 문자열 값은 그대로 내보내집니다. sandbox.network.httpProxyPort 및 sandbox.network.socksProxyPort는 "[REDACTED]"로 내보내집니다.
  • 다른 모든 문자열(예: model, apiKeyHelper, 모든 env 값, 모든 URL 및 모든 명령)은 "[REDACTED]"로 내보내집니다.
  • 맵의 항목 이름(예: env 변수 이름 및 플러그인 ID)은 그대로 내보내집니다. 스키마가 항목을 입력하지 않는 설정(예: vimInsertModeRemaps)은 단일 "[REDACTED]"로 내보내지며, sandbox.ignoreViolations은 명령 패턴 없이 경로 목록 목록으로 내보내집니다.
  • 목록은 길이를 유지하며, 각 항목은 동일한 규칙으로 수정됨
  • permissions.allow, permissions.deny 또는 permissions.ask 규칙은 도구 이름(이 Claude Code 버전에 기본 제공되거나 mcp__jira__create_issue와 같은 mcp__ 참조인 경우)으로 내보내지며, 콘텐츠는 수정됨(예: Read([REDACTED])). 다른 규칙은 "[REDACTED]"로 내보내집니다.
  • 훅은 동일한 규칙을 따르므로 type 및 timeout과 같은 고정 옵션 및 숫자 필드는 표시되는 반면, 각 명령, URL, matcher 및 if 조건은 "[REDACTED]"로 내보내집니다.
  예를 들어, apiKeyHelper, 두 개의 env 변수 및 거부 규칙이 있는 관리 설정은 {"apiKeyHelper":"[REDACTED]","env":{"HTTPS_PROXY":"[REDACTED]","CLAUDE_CODE_ENABLE_TELEMETRY":"[REDACTED]"},"permissions":{"deny":["Read([REDACTED])"]}} 로 내보내집니다. Claude Code는 값을 8KB의 UTF-8에서 자르며, 자른 값은 유효한 JSON이 아닙니다.
• managed_settings.settings_truncated (managed_settings.settings가 있을 때): Claude Code가 managed_settings.settings를 8KB에서 자를 때 true, 그 외의 경우 false. 부울로 내보내짐, 문자열이 아님

​

메트릭 및 이벤트 데이터 해석

​

사용 모니터링

​

비용 모니터링

• 팀 또는 개인 전체의 사용 추세 추적
• 최적화를 위한 높은 사용 세션 식별
• skill.name, plugin.name 및 agent.name 속성을 통해 특정 스킬, 플러그인 또는 서브에이전트 유형에 지출 귀속

​

경고 및 세분화

• 비용 급증
• 비정상적인 토큰 소비
• 특정 사용자의 높은 세션 볼륨

​

재시도 소진 감지

​

이벤트 분석

• 가장 자주 사용되는 도구
• 도구 성공률
• 평균 도구 실행 시간
• 도구 유형별 오류 패턴

​

감사 보안 이벤트

​

속성 작업을 사용자에게 연결

export OTEL_RESOURCE_ATTRIBUTES="enduser.id=jdoe@example.com,enduser.directory_id=S-1-5-21-..."

​

MCP 활동 감사

• tool_result: mcp_server_scope를 유지하고 사용자 구성 서버의 경우 tool_name을 리터럴 "mcp_tool"로 수정하며, 인수 내용을 생략합니다. Claude Desktop의 기본 제공 서버의 경우, Claude Desktop이 소유한 세션에서는 tool_parameters 내부의 mcp_server_name/mcp_tool_name 쌍도 유지하며, tool_decision과 동일한 호스트 작성 예외입니다. Claude Code v2.1.214 이상 필요
• tool_decision: tool_source를 유지하고 사용자 구성 서버의 경우 tool_name을 리터럴 "mcp_tool"로 수정하며, 인수 내용을 생략합니다. Claude Desktop의 기본 제공 서버의 경우, Claude Desktop이 소유한 세션에서는 tool_parameters 내부의 mcp_server_name/mcp_tool_name 쌍도 유지합니다. tool_source 및 이름 쌍 모두 Claude Code v2.1.214 이상 필요
• mcp_server_connection: server_name 및 오류 메시지를 생략하지만, is_plugin, plugin_id_hash 및 plugin.name을 유지하며, Anthropic이 아닌 플러그인 이름은 리터럴 "third-party"로 수정되므로 플러그인 제공 서버는 상세 로깅 없이도 구별 가능합니다

​

보안 질문을 이벤트에 매핑

​

SIEM에 이벤트 전송

{
  "env": {
    "CLAUDE_CODE_ENABLE_TELEMETRY": "1",
    "OTEL_LOGS_EXPORTER": "otlp",
    "OTEL_LOG_TOOL_DETAILS": "1",
    "OTEL_EXPORTER_OTLP_LOGS_PROTOCOL": "http/protobuf",
    "OTEL_EXPORTER_OTLP_LOGS_ENDPOINT": "https://siem.example.com:4318/v1/logs",
    "OTEL_EXPORTER_OTLP_HEADERS": "Authorization=Bearer your-siem-token"
  }
}

​

백엔드 고려 사항

​

메트릭의 경우

• 시계열 데이터베이스: 비율 계산, 집계된 메트릭
• 컬럼형 저장소: 복잡한 쿼리, 고유 사용자 분석
• 완전한 기능의 관찰성 플랫폼: 고급 쿼리, 시각화, 경고

​

이벤트/로그의 경우

• 로그 집계 시스템: 전체 텍스트 검색, 로그 분석
• 컬럼형 저장소: 구조화된 이벤트 분석
• 완전한 기능의 관찰성 플랫폼: 메트릭과 이벤트 간의 상관 관계

​

추적의 경우

• 분산 추적 시스템: 스팬 시각화, 요청 워터폴, 지연 시간 분석
• 완전한 기능의 관찰성 플랫폼: 추적 검색 및 메트릭과 로그와의 상관 관계

​

서비스 정보

• service.name: 터미널 세션의 경우 claude-code, Claude Desktop 앱의 Code 탭에서 시작된 세션의 경우 claude-code-desktop
• service.version: 현재 Claude Code 버전, 또는 Code 탭 세션의 경우 Desktop 앱 버전
• os.type: 운영 체제 유형 (예: linux, darwin, windows)
• os.version: 운영 체제 버전 문자열
• host.arch: 호스트 아키텍처 (예: amd64, arm64)
• wsl.version: WSL 버전 번호 (Windows Subsystem for Linux에서 실행할 때만 표시)
• 미터 이름: com.anthropic.claude_code

​

ROI 측정 리소스

​

보안 및 개인 정보 보호

• OpenTelemetry 내보내기는 선택 사항이며 명시적 구성이 필요합니다. Anthropic의 별도 운영 원격 측정 및 이를 비활성화하는 방법에 대해서는 데이터 사용을 참조하세요
• 원본 파일 콘텐츠 및 코드 스니펫은 메트릭 또는 이벤트에 포함되지 않습니다. 추적 스팬은 별도의 데이터 경로입니다: 아래의 OTEL_LOG_TOOL_CONTENT 항목을 참조하세요
• OAuth를 통해 인증된 경우 user.email이 원격 측정 속성에 포함되며, 구성한 OTel 엔드포인트로만 전송되고 Anthropic으로는 절대 전송되지 않습니다. 조직에서 이것이 우려 사항인 경우 원격 측정 백엔드와 함께 작업하여 이 필드를 필터링하거나 수정하세요
• 사용자 프롬프트 콘텐츠는 기본적으로 수집되지 않습니다. 프롬프트 길이만 기록됩니다. 프롬프트 콘텐츠를 포함하려면 OTEL_LOG_USER_PROMPTS=1을 설정하세요. 상세 베타 추적에서 이 변수는 프롬프트 텍스트보다 더 멀리 도달합니다: 또한 claude_code.llm_request 스팬의 도구 결과를 전달하는 new_context 스팬 속성을 제어합니다
• 어시스턴트 응답 텍스트는 기본적으로 수집되지 않습니다. 응답 길이만 기록됩니다. 응답 텍스트를 포함하려면 OTEL_LOG_ASSISTANT_RESPONSES=1을 설정하세요. Claude Code의 모든 OpenTelemetry 데이터와 마찬가지로 응답 텍스트는 구성한 OTel 엔드포인트로만 전송되며 Anthropic으로는 전송되지 않습니다. 이 변수가 설정되지 않으면 OTEL_LOG_USER_PROMPTS가 폴백으로 사용되므로 프롬프트 콘텐츠는 원하지만 응답 콘텐츠는 원하지 않는 경우 OTEL_LOG_ASSISTANT_RESPONSES=0을 설정하세요
• 도구 입력 인수 및 매개변수는 기본적으로 기록되지 않습니다. 이를 포함하려면 OTEL_LOG_TOOL_DETAILS=1을 설정하세요. Claude Desktop의 기본 제공 서버의 경우, Claude Desktop이 소유한 세션에서 tool_decision 및 tool_result는 인수 콘텐츠가 아닌 호스트 작성 이름인 mcp_server_name/mcp_tool_name 쌍을 전달하며, 플래그가 꺼져 있어도 그렇습니다. 이 예외는 Claude Code v2.1.214 이상이 필요합니다. 이 데이터는 구성한 OTEL 엔드포인트로만 전송되며 Anthropic으로는 절대 전송되지 않습니다. 인수에는 여전히 민감한 값이 포함될 수 있으므로 필요에 따라 이러한 속성을 필터링하거나 수정하도록 원격 측정 백엔드를 구성하세요. 활성화되면:
  • tool_result 및 tool_decision 이벤트는 Bash 명령, MCP 서버 및 도구 이름, 스킬 이름이 포함된 tool_parameters 속성을 포함합니다. full_command와 같은 필드는 잘리지 않은 상태로 내보내집니다
  • tool_result 이벤트는 추가로 파일 경로, URL, 검색 패턴 및 기타 인수가 포함된 tool_input 속성을 포함합니다. 512자를 초과하는 개별 값은 잘리고 전체는 약 4K 문자로 제한됩니다
  • user_prompt 이벤트는 사용자 정의, 플러그인 및 MCP 명령의 축자 command_name을 포함합니다
  • 비용 및 토큰 카운터 및 api_request, api_error, api_refusal 이벤트는 속성 귀속에서 실제 에이전트, 스킬, 플러그인, MCP 서버 및 도구 이름을 전달합니다
  • 추적 스팬은 동일한 tool_input 속성 및 file_path와 같은 입력 파생 속성을 포함하며, tool_input과 동일한 잘림이 적용됩니다
• 도구 콘텐츠는 기본적으로 추적 스팬에 기록되지 않습니다. 이를 포함하려면 OTEL_LOG_TOOL_CONTENT=1을 설정하세요. 그러면 claude_code.tool 스팬은 원본 파일 콘텐츠, Bash 명령 출력, MCP 도구, WebFetch 및 WebSearch가 반환하는 것이 포함된 tool.output 스팬 이벤트를 전달하며, 속성당 콘텐츠 제한(기본값 60KB)에서 잘립니다. MCP 도구, WebFetch 및 WebSearch의 결과는 Claude Code v2.1.283 이상이 필요합니다. 도구 콘텐츠는 또한 new_context를 통해 스팬에 도달하며, 그 제어는 스팬마다 다릅니다. 필요에 따라 이러한 속성을 필터링하거나 수정하도록 원격 측정 백엔드를 구성하세요
• 원본 Anthropic Messages API 요청 및 응답 본문은 기본적으로 기록되지 않습니다. 이를 포함하려면 셸, 사용자 설정 또는 관리 설정에서 OTEL_LOG_RAW_API_BODIES를 설정하세요. 프로젝트 및 로컬 설정에서는 무시됩니다. 본문에는 전체 대화 기록(시스템 프롬프트, 모든 이전 사용자 및 어시스턴트 턴, 도구 결과)이 포함되므로 이를 활성화하면 다른 OTEL_LOG_* 콘텐츠 플래그가 공개할 모든 것에 동의하는 것을 의미합니다. Claude Code는 다른 설정에 관계없이 항상 이러한 본문에서 Claude의 확장 사고 콘텐츠를 수정합니다. 설정한 값은 Claude Code가 본문을 전달하는 방식을 결정합니다:
  • =1일 때 Claude Code는 각 API 호출에 대해 api_request_body 및 api_response_body 로그 이벤트를 내보냅니다. 이벤트의 body 속성은 JSON 직렬화된 페이로드를 전달하며, 콘텐츠 제한(기본값 60KB)에서 잘립니다
  • =file:<dir>일 때 Claude Code는 잘리지 않은 본문을 해당 디렉토리 아래의 .request.json 및 .response.json 파일에 기록하고, 이벤트는 인라인 본문 대신 body_ref 경로를 전달합니다. 로그 수집기 또는 사이드카와 함께 디렉토리를 배포하되 원격 측정 스트림을 통해서는 배포하지 마세요. 각 성공적인 응답에 대해 Claude Code는 또한 해당 디렉토리의 index.jsonl에 한 줄을 추가하여 응답 파일을 이를 생성한 요청 파일 및 이것이 된 트랜스크립트 메시지에 연결합니다. 각 줄은 메시지 콘텐츠를 포함하지 않으며, API 응답 본문 이벤트 섹션에 해당 필드가 나열됩니다. 인덱스 파일은 Claude Code v2.1.274 이상이 필요합니다

​

Amazon Bedrock에서 Claude Code 모니터링