80 80
81 * 일반 또는 로그/추적 엔드포인트 또는 자격증명81 * 일반 또는 로그/추적 엔드포인트 또는 자격증명
82 * [`otelHeadersHelper`](/docs/ko/settings-reference#otelheadershelper)82 * [`otelHeadersHelper`](/docs/ko/settings-reference#otelheadershelper)
83 * `none`, `console` 또는 비어있음으로 설정된 로그 또는 추적 내보내기 선택기(신호가 수집기로 가지 않게 하는 값)83 * `none`, `console` 또는 비어있음으로 설정된 로그 또는 추적 내보내기 선택기(신호를 수집기에서 유지하는 값)
84 * `CLAUDE_CODE_ENABLE_TELEMETRY` 비활성화84 * `CLAUDE_CODE_ENABLE_TELEMETRY` 비활성화
85 85
86 메트릭 전용 엔드포인트 또는 자격증명은 제거하지 않습니다. v2.1.251 이전에는 개발자 설정 `BETA_TRACING_ENDPOINT`가 관리 설정이 수집기를 고정했을 때도 상세 베타 추적이 내보내는 로그 및 추적을 리디렉션했습니다.86 메트릭 전용 엔드포인트 또는 자격증명은 제거하지 않습니다. v2.1.251 이전에는 개발자 설정 `BETA_TRACING_ENDPOINT`가 관리 설정이 수집기를 고정했을 때도 상세 베타 추적이 내보내는 로그 및 추적을 리디렉션했습니다.
150다음 환경 변수는 카디널리티를 관리하기 위해 메트릭에 포함되는 속성을 제어합니다:150다음 환경 변수는 카디널리티를 관리하기 위해 메트릭에 포함되는 속성을 제어합니다:
151 151
152| 환경 변수 | 설명 | 기본값 | 비활성화 예 |152| 환경 변수 | 설명 | 기본값 | 비활성화 예 |
153| ------------------------------------------ | -------------------------------------------------- | ------- | ------- |153| ------------------------------------------ | ----------------------------------------------------------------------------------------- | ------- | ------- |
154| `OTEL_METRICS_INCLUDE_SESSION_ID` | 메트릭에 session.id 속성 포함 | `true` | `false` |154| `OTEL_METRICS_INCLUDE_SESSION_ID` | 메트릭에 session.id 속성 포함 | `true` | `false` |
155| `OTEL_METRICS_INCLUDE_VERSION` | 메트릭에 app.version 속성 포함 | `false` | `true` |155| `OTEL_METRICS_INCLUDE_VERSION` | 메트릭에 app.version 속성 포함 | `false` | `true` |
156| `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` | 메트릭에 user.account\_uuid 및 user.account\_id 속성 포함 | `true` | `false` |156| `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` | 메트릭에 user.account\_uuid 및 user.account\_id 속성 포함 | `true` | `false` |
157| `OTEL_METRICS_INCLUDE_ENTRYPOINT` | 메트릭에 app.entrypoint 속성 포함 | `false` | `true` |157| `OTEL_METRICS_INCLUDE_ENTRYPOINT` | 메트릭에 app.entrypoint 속성 포함 | `false` | `true` |
158| `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` | `OTEL_RESOURCE_ATTRIBUTES`의 키를 메트릭 데이터포인트의 속성으로 포함 | `true` | `false` |158| `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` | `OTEL_RESOURCE_ATTRIBUTES`의 키를 메트릭 데이터포인트의 속성으로 포함 | `true` | `false` |
159| `OTEL_METRICS_INCLUDE_REPOSITORY` | 메트릭 및 이벤트에 `vcs.*` [저장소 식별 속성](#repository-attributes)을 포함합니다. Claude Code v2.1.269 이상 필요 | `false` | `true` |
159 160
160낮은 카디널리티는 일반적으로 더 나은 성능과 낮은 저장소 비용을 의미하지만 분석을 위한 세분화된 데이터는 적습니다.161낮은 카디널리티는 일반적으로 더 나은 성능과 낮은 저장소 비용을 의미하지만 분석을 위한 세분화된 데이터는 적습니다.
161 162
222| ------------------------- | --------------------------------------------------------------------------------------------------------- | ----------------------- |223| ------------------------- | --------------------------------------------------------------------------------------------------------- | ----------------------- |
223| `user_prompt` | 프롬프트 텍스트. 게이트가 설정되지 않으면 값은 `<REDACTED>`입니다 | `OTEL_LOG_USER_PROMPTS` |224| `user_prompt` | 프롬프트 텍스트. 게이트가 설정되지 않으면 값은 `<REDACTED>`입니다 | `OTEL_LOG_USER_PROMPTS` |
224| `user_prompt_length` | 프롬프트 길이 (문자 단위) | |225| `user_prompt_length` | 프롬프트 길이 (문자 단위) | |
225| `interaction.sequence` | 이 세션의 상호 작용 1 기반 카운터 | |226| `interaction.sequence` | 상호 작용 1 기반 카운터 ([`event.sequence`](#event-correlation-attributes)에 설명된 대로 세션당이 아닌 Claude Code 프로세스당 계산됨) | |
226| `parent.source` | 스팬이 추적 부모를 얻은 방법: 인바운드 `TRACEPARENT`에서 부모가 되었을 때 `env`, 자신의 추적을 시작했을 때 `none`. Claude Code v2.1.268 이상 필요 | |227| `parent.source` | 스팬이 추적 부모를 얻은 방법: 인바운드 `TRACEPARENT`에서 부모가 되었을 때 `env`, 자신의 추적을 시작했을 때 `none`. Claude Code v2.1.268 이상 필요 | |
227| `interaction.duration_ms` | 턴의 벽시계 지속 시간 | |228| `interaction.duration_ms` | 턴의 벽시계 지속 시간 | |
228 229
390* 팀별 대시보드 생성391* 팀별 대시보드 생성
391* 특정 팀에 대한 경고 설정392* 특정 팀에 대한 경고 설정
392 393
393Claude Code는 이러한 값을 모든 메트릭 데이터포인트 및 이벤트 레코드의 속성으로 첨부하고, OTLP 리소스 블록에서도 전송합니다. 대부분의 메트릭 백엔드는 데이터포인트 속성을 쿼리 가능한 레이블로 노출하므로 사용자 정의 키로 직접 메트릭을 그룹화하고 필터링할 수 있습니다. 사용자 정의 키는 `user.id` 또는 `session.id`와 같은 [표준 속성](#standard-attributes)을 재정의하지 않습니다. 키가 충돌하면 Claude Code는 기본 제공 값을 유지합니다.394Claude Code는 이러한 값을 모든 메트릭 데이터포인트 및 이벤트 레코드의 속성으로 첨부하고, OTLP 리소스 블록에서도 전송합니다. 대부분의 메트릭 백엔드는 데이터포인트 속성을 쿼리 가능한 레이블로 노출하므로 사용자 정의 키로 직접 메트릭을 그룹화하고 필터링할 수 있습니다. `vcs.*` [저장소 속성](#repository-attributes)을 제외하고 사용자 정의 키는 `user.id` 또는 `session.id`와 같은 [표준 속성](#standard-attributes)을 재정의하지 않습니다. 키가 충돌하면 Claude Code는 기본 제공 값을 유지합니다.
394 395
395각 사용자 정의 키는 모든 메트릭 시리즈의 레이블이 되므로 높은 카디널리티 값은 메트릭 백엔드의 저장소 비용을 증가시킵니다. 사용자 정의 속성을 리소스 블록에만 보내고 데이터포인트 레이블에서 생략하려면 `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES=false`를 설정합니다. [메트릭 카디널리티 제어](#metrics-cardinality-control)를 참조합니다.396각 사용자 정의 키는 모든 메트릭 시리즈의 레이블이 되므로 높은 카디널리티 값은 메트릭 백엔드의 저장소 비용을 증가시킵니다. 사용자 정의 속성을 리소스 블록에만 보내고 데이터포인트 레이블에서 생략하려면 `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES=false`를 설정합니다. [메트릭 카디널리티 제어](#metrics-cardinality-control)를 참조합니다.
396 397
499모든 메트릭과 이벤트는 다음과 같은 표준 속성을 공유합니다:500모든 메트릭과 이벤트는 다음과 같은 표준 속성을 공유합니다:
500 501
501| 속성 | 설명 | 제어 대상 |502| 속성 | 설명 | 제어 대상 |
502| ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------ |503| --------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------- |
503| `session.id` | 고유한 세션 식별자 | `OTEL_METRICS_INCLUDE_SESSION_ID` (기본값: true) |504| `session.id` | 고유한 세션 식별자 | `OTEL_METRICS_INCLUDE_SESSION_ID` (기본값: true) |
504| `app.version` | 현재 Claude Code 버전 | `OTEL_METRICS_INCLUDE_VERSION` (기본값: false) |505| `app.version` | 현재 Claude Code 버전 | `OTEL_METRICS_INCLUDE_VERSION` (기본값: false) |
505| `app.entrypoint` | 세션이 시작된 방식(예: `cli`, `sdk-cli`, `sdk-ts`, `sdk-py`, 또는 `claude-vscode`) | `OTEL_METRICS_INCLUDE_ENTRYPOINT` (기본값: false) |506| `app.entrypoint` | 세션이 시작된 방식(예: `cli`, `sdk-cli`, `sdk-ts`, `sdk-py`, 또는 `claude-vscode`) | `OTEL_METRICS_INCLUDE_ENTRYPOINT` (기본값: false) |
510| `user.email` | 사용자 이메일 주소(로그인 시 또는 [클라우드 세션](/docs/ko/claude-code-on-the-web)에서 세션 자체의 자격 증명에서) | 사용 가능할 때 항상 포함됨 |511| `user.email` | 사용자 이메일 주소(로그인 시 또는 [클라우드 세션](/docs/ko/claude-code-on-the-web)에서 세션 자체의 자격 증명에서) | 사용 가능할 때 항상 포함됨 |
511| `terminal.type` | 터미널 유형(예: `iTerm.app`, `vscode`, `cursor`, 또는 `tmux`) | 감지될 때 항상 포함됨 |512| `terminal.type` | 터미널 유형(예: `iTerm.app`, `vscode`, `cursor`, 또는 `tmux`) | 감지될 때 항상 포함됨 |
512| `OTEL_RESOURCE_ATTRIBUTES`의 키 | 설정한 사용자 정의 속성(예: `department` 또는 `team.id`). [다중 팀 조직 지원](#multi-team-organization-support) 참조 | `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` (기본값: true) |513| `OTEL_RESOURCE_ATTRIBUTES`의 키 | 설정한 사용자 정의 속성(예: `department` 또는 `team.id`). [다중 팀 조직 지원](#multi-team-organization-support) 참조 | `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` (기본값: true) |
514| `vcs.repository.url.full`, `vcs.owner.name`, `vcs.repository.name`, `vcs.provider.name` | 세션 저장소의 ID(저장소의 `origin` 원격에서 파생됨). [저장소 속성](#repository-attributes) 참조 | `OTEL_METRICS_INCLUDE_REPOSITORY` (기본값: false). Claude Code v2.1.269 이상 필요 |
513 515
514Claude Code가 [Claude 앱 게이트웨이](/docs/ko/claude-apps-gateway)에 로그인되어 있으면 CLI는 게이트웨이 세션의 인증된 ID로 내보내기를 스탬프합니다: `user.id`는 익명 설치 식별자가 아닌 IdP 주체이고, `user.email`은 로그인한 이메일이며, `user.groups`는 IdP 그룹 멤버십을 쉼표로 구분된 문자열로 전달합니다. 각 내보내기는 또한 `identity.source: gateway-oidc`를 전달합니다. 게이트웨이 ID는 마지막에 적용되므로 `OTEL_RESOURCE_ATTRIBUTES`를 통해 설정된 `user.*` 및 `identity.*` 키는 게이트웨이 세션에서 무시됩니다.516Claude Code가 [Claude 앱 게이트웨이](/docs/ko/claude-apps-gateway)에 로그인되어 있으면 CLI는 게이트웨이 세션의 인증된 ID로 내보내기를 스탬프합니다: `user.id`는 익명 설치 식별자가 아닌 IdP 주체이고, `user.email`은 로그인한 이메일이며, `user.groups`는 IdP 그룹 멤버십을 쉼표로 구분된 문자열로 전달합니다. 각 내보내기는 또한 `identity.source: gateway-oidc`를 전달합니다. 게이트웨이 ID는 마지막에 적용되므로 `OTEL_RESOURCE_ATTRIBUTES`를 통해 설정된 `user.*` 및 `identity.*` 키는 게이트웨이 세션에서 무시됩니다.
515 517
520* `workflow.run_id`: [Workflow](/docs/ko/workflows) 도구 실행에 속하는 에이전트가 내보낸 API 및 도구 이벤트의 실행 식별자(접두사 `wf_`). 하나의 `workflow.run_id`로 이벤트를 필터링하면 해당 실행의 API 요청 및 도구 결과를 재구성합니다. 식별자는 워크플로우 스크립트가 생성하는 에이전트와 그 에이전트가 차례로 생성하는 모든 에이전트(예: 스킬 호출)를 포함합니다. Workflow 도구 결과에서 보고된 실행 식별자와 일치합니다. 다른 모든 이벤트에는 없습니다. Claude Code v2.1.202 이상 필요522* `workflow.run_id`: [Workflow](/docs/ko/workflows) 도구 실행에 속하는 에이전트가 내보낸 API 및 도구 이벤트의 실행 식별자(접두사 `wf_`). 하나의 `workflow.run_id`로 이벤트를 필터링하면 해당 실행의 API 요청 및 도구 결과를 재구성합니다. 식별자는 워크플로우 스크립트가 생성하는 에이전트와 그 에이전트가 차례로 생성하는 모든 에이전트(예: 스킬 호출)를 포함합니다. Workflow 도구 결과에서 보고된 실행 식별자와 일치합니다. 다른 모든 이벤트에는 없습니다. Claude Code v2.1.202 이상 필요
521* `workflow.name`: 워크플로우의 이름(스크립트의 `meta.name`), `workflow.run_id`와 함께 내보냅니다. 기본 제공 워크플로우 이름은 실행이 수정되지 않은 기본 제공 스크립트를 실행할 때 그대로 나타납니다. 기본 제공 스크립트의 편집된 복사본을 포함한 사용자 작성 이름은 `OTEL_LOG_TOOL_DETAILS=1`이 설정되지 않으면 `custom`으로 대체됩니다. Claude Code v2.1.202 이상 필요523* `workflow.name`: 워크플로우의 이름(스크립트의 `meta.name`), `workflow.run_id`와 함께 내보냅니다. 기본 제공 워크플로우 이름은 실행이 수정되지 않은 기본 제공 스크립트를 실행할 때 그대로 나타납니다. 기본 제공 스크립트의 편집된 복사본을 포함한 사용자 작성 이름은 `OTEL_LOG_TOOL_DETAILS=1`이 설정되지 않으면 `custom`으로 대체됩니다. Claude Code v2.1.202 이상 필요
522 524
525<h4 id="repository-attributes">
526 저장소 속성
527</h4>
528
529`OTEL_METRICS_INCLUDE_REPOSITORY=true`를 설정하여 메트릭과 이벤트를 세션의 저장소 ID로 태그하면, 공유 수집기가 저장소별로 사용량을 속성화할 수 있습니다. Claude Code v2.1.269 이상 필요합니다.
530
531Claude Code는 저장소의 `origin` 원격에서 이러한 속성을 세션당 한 번 파생합니다. 하나의 저장소의 HTTPS 및 SSH 원격은 동일한 값을 생성합니다:
532
533| 속성 | 값 |
534| ------------------------- | ---------------------------------------------------------------------------------------------------------- |
535| `vcs.repository.url.full` | 저장소의 브라우저 URL(.git 없음)(예: `https://github.com/example-org/example-repo`) |
536| `vcs.owner.name` | 소유자 또는 그룹 경로(예: `example-org`). 원격 경로가 단일 세그먼트를 가질 때는 생략됨 |
537| `vcs.repository.name` | 기본 저장소 이름(예: `example-repo`) |
538| `vcs.provider.name` | Claude Code가 원격의 호스트 또는 URL 형태를 이러한 공급자 중 하나로 인식할 때 `github`, `gitlab`, `bitbucket`, 또는 `gitea`. 그 외에는 생략됨 |
539
540값은 소문자로 변환되며, 원격 URL의 자격 증명, 쿼리 문자열, 및 조각은 절대 나타나지 않습니다. 세션에 `origin` 원격이 없을 때, 원격이 URL 형태가 아닐 때, 또는 유일한 포함 저장소가 홈 디렉토리일 때 속성은 생략됩니다.
541
542[`OTEL_RESOURCE_ATTRIBUTES`](#multi-team-organization-support)에서 선언한 `vcs.*` 키는 해당 키의 파생 값을 대체합니다. `vcs.repository.url.full`을 선언하면 Claude Code는 절대 원격을 읽지 않으며 선언한 키만 보고합니다.
543
544속성은 자신의 내보내기로만 흐릅니다. Anthropic의 원격 측정은 모든 `vcs.*` 키를 삭제합니다.
545
523<h3 id="metrics">546<h3 id="metrics">
524 메트릭547 메트릭
525</h3>548</h3>
664| 속성 | 설명 |687| 속성 | 설명 |
665| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |688| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
666| `prompt.id` | 단일 사용자 프롬프트 처리 중에 생성된 모든 이벤트를 연결하는 UUID v4 식별자 |689| `prompt.id` | 단일 사용자 프롬프트 처리 중에 생성된 모든 이벤트를 연결하는 UUID v4 식별자 |
690| `event.sequence` | 이벤트 순서 지정을 위한 0 기반 카운터(Claude Code 프로세스당 계산되며 세션당이 아님) |
667| `message.uuid` | 세션 트랜스크립트(`~/.claude/projects/*/*.jsonl` 파일)에 저장된 메시지의 UUID입니다. `assistant_response`에 있고, 명령 디스패치를 제외한 `user_prompt`에 있습니다(명령 디스패치는 0개 이상의 메시지를 생성할 수 있음). `assistant_response`에서 이것은 응답의 최종 트랜스크립트 항목이며, 다음 턴의 `parentUuid`가 이로부터 체인됩니다. Claude Code v2.1.214 이상 필요 |691| `message.uuid` | 세션 트랜스크립트(`~/.claude/projects/*/*.jsonl` 파일)에 저장된 메시지의 UUID입니다. `assistant_response`에 있고, 명령 디스패치를 제외한 `user_prompt`에 있습니다(명령 디스패치는 0개 이상의 메시지를 생성할 수 있음). `assistant_response`에서 이것은 응답의 최종 트랜스크립트 항목이며, 다음 턴의 `parentUuid`가 이로부터 체인됩니다. Claude Code v2.1.214 이상 필요 |
668| `client_request_id` | `x-client-request-id` 요청 헤더로 전송된 클라이언트 생성 UUID입니다. 자사 API 연결의 `api_request` 및 `api_error`에 있고, 타사 공급자 백엔드 및 요청이 비스트리밍 폴백을 통해 재시도되었을 때는 없습니다. 요청을 응답과 쌍으로 만들고 서버 `request_id`를 생성하지 않은 타임아웃과 같은 실패에 대해 사용 가능하게 유지합니다. `llm_request` 추적 스팬의 동일한 속성과 일치합니다. Claude Code v2.1.214 이상 필요 |692| `client_request_id` | `x-client-request-id` 요청 헤더로 전송된 클라이언트 생성 UUID입니다. 자사 API 연결의 `api_request` 및 `api_error`에 있고, 타사 공급자 백엔드 및 요청이 비스트리밍 폴백을 통해 재시도되었을 때는 없습니다. 요청을 응답과 쌍으로 만들고 서버 `request_id`를 생성하지 않은 타임아웃과 같은 실패에 대해 사용 가능하게 유지합니다. `llm_request` 추적 스팬의 동일한 속성과 일치합니다. Claude Code v2.1.214 이상 필요 |
669 693
670단일 프롬프트로 트리거된 모든 활동을 추적하려면 특정 `prompt.id` 값으로 이벤트를 필터링하세요. 이는 user\_prompt 이벤트, 모든 api\_request 이벤트, 및 해당 프롬프트 처리 중에 발생한 모든 tool\_result 이벤트를 반환합니다.694단일 프롬프트로 트리거된 모든 활동을 추적하려면 특정 `prompt.id` 값으로 이벤트를 필터링하세요. 이는 user\_prompt 이벤트, 모든 api\_request 이벤트, 및 해당 프롬프트 처리 중에 발생한 모든 tool\_result 이벤트를 반환합니다.
671 695
696`event.sequence`는 Claude Code 프로세스가 시작될 때마다 0에서 시작하고 해당 프로세스의 수명 동안 계속 증가합니다. `/clear`를 통해 계속 계산되며, 이는 새로운 `session.id`를 할당합니다. [세션을 포크하지 않고 재개](/docs/ko/how-claude-code-works#resume-or-fork-sessions)하면, 세션은 `session.id`를 유지하지만 세션을 재개한 프로세스에서 `event.sequence` 값을 가져오므로, 한 세션 내에서 나중의 이벤트가 이전 이벤트보다 낮은 값을 전달하거나 하나를 반복할 수 있습니다. 세션의 이벤트를 순서대로 정렬하려면 `event.timestamp`로 정렬하고 동일한 타임스탬프를 공유하는 이벤트를 순서대로 정렬하려면 `event.sequence`를 사용하세요.
697
672메시지 수준 재구성의 경우, 각 이벤트 클래스는 세션 트랜스크립트의 필드와 일치하는 키를 전달합니다. 트랜스크립트 항목 형식은 [Claude Code 내부](/docs/ko/sessions#where-transcripts-are-stored)이며 버전 간에 변경되므로, 이러한 필드에 조인하는 파이프라인은 모든 릴리스에서 중단될 수 있습니다. 조인을 안정적인 계약이 아닌 버전별 조인으로 취급하세요:698메시지 수준 재구성의 경우, 각 이벤트 클래스는 세션 트랜스크립트의 필드와 일치하는 키를 전달합니다. 트랜스크립트 항목 형식은 [Claude Code 내부](/docs/ko/sessions#where-transcripts-are-stored)이며 버전 간에 변경되므로, 이러한 필드에 조인하는 파이프라인은 모든 릴리스에서 중단될 수 있습니다. 조인을 안정적인 계약이 아닌 버전별 조인으로 취급하세요:
673 699
674* `user_prompt` 및 `assistant_response`의 `message.uuid`700* `user_prompt` 및 `assistant_response`의 `message.uuid`
688* 모든 [표준 속성](#standard-attributes)714* 모든 [표준 속성](#standard-attributes)
689* `event.name`: `"user_prompt"`715* `event.name`: `"user_prompt"`
690* `event.timestamp`: ISO 8601 타임스탬프716* `event.timestamp`: ISO 8601 타임스탬프
691* `event.sequence`: 세션 내 이벤트 순서 지정을 위한 단조 증가 카운터717* `event.sequence`: 이벤트 순서 지정을 위한 프로세스별 카운터([이벤트 상관 속성](#event-correlation-attributes)에 설명됨)
692* `prompt_length`: 프롬프트의 길이718* `prompt_length`: 프롬프트의 길이
693* `prompt`: 프롬프트 내용. 기본적으로 수정됨. `OTEL_LOG_USER_PROMPTS=1`을 설정하여 포함시킵니다.719* `prompt`: 프롬프트 내용. 기본적으로 수정됨. `OTEL_LOG_USER_PROMPTS=1`을 설정하여 포함시킵니다.
694* `message.uuid`: 저장된 트랜스크립트 항목과 일치하는 결과 사용자 메시지의 UUID입니다. 명령 디스패치에는 없습니다(0개 이상의 메시지를 생성할 수 있음). Claude Code v2.1.214 이상 필요720* `message.uuid`: 저장된 트랜스크립트 항목과 일치하는 결과 사용자 메시지의 UUID입니다. 명령 디스패치에는 없습니다(0개 이상의 메시지를 생성할 수 있음). Claude Code v2.1.214 이상 필요
708* 모든 [표준 속성](#standard-attributes)734* 모든 [표준 속성](#standard-attributes)
709* `event.name`: `"assistant_response"`735* `event.name`: `"assistant_response"`
710* `event.timestamp`: ISO 8601 타임스탬프736* `event.timestamp`: ISO 8601 타임스탬프
711* `event.sequence`: 세션 내 이벤트 순서 지정을 위한 단조 증가 카운터737* `event.sequence`: 이벤트 순서 지정을 위한 프로세스별 카운터([이벤트 상관 속성](#event-correlation-attributes)에 설명됨)
712* `response_length`: 응답 텍스트의 길이(문자)738* `response_length`: 응답 텍스트의 길이(문자)
713* `response`: 응답 텍스트(콘텐츠 제한(기본값 60KB)에서 잘림). 기본적으로 `<REDACTED>`로 수정됨. `OTEL_LOG_ASSISTANT_RESPONSES=1`을 설정하여 포함시킵니다. `OTEL_LOG_ASSISTANT_RESPONSES`가 설정되지 않으면 `OTEL_LOG_USER_PROMPTS`가 대신 제어하므로, 프롬프트 로깅이 켜져 있는 동안 응답을 수정된 상태로 유지하려면 `OTEL_LOG_ASSISTANT_RESPONSES=0`을 설정하세요.739* `response`: 응답 텍스트(콘텐츠 제한(기본값 60KB)에서 잘림). 기본적으로 `<REDACTED>`로 수정됨. `OTEL_LOG_ASSISTANT_RESPONSES=1`을 설정하여 포함시킵니다. `OTEL_LOG_ASSISTANT_RESPONSES`가 설정되지 않으면 `OTEL_LOG_USER_PROMPTS`가 대신 제어하므로, 프롬프트 로깅이 켜져 있는 동안 응답을 수정된 상태로 유지하려면 `OTEL_LOG_ASSISTANT_RESPONSES=0`을 설정하세요.
714* `model`: 모델 식별자(예: "claude-sonnet-5")740* `model`: 모델 식별자(예: "claude-sonnet-5")
729* 모든 [표준 속성](#standard-attributes)755* 모든 [표준 속성](#standard-attributes)
730* `event.name`: `"tool_result"`756* `event.name`: `"tool_result"`
731* `event.timestamp`: ISO 8601 타임스탬프757* `event.timestamp`: ISO 8601 타임스탬프
732* `event.sequence`: 세션 내 이벤트 순서 지정을 위한 단조 증가 카운터758* `event.sequence`: 이벤트 순서 지정을 위한 프로세스별 카운터([이벤트 상관 속성](#event-correlation-attributes)에 설명됨)
733* `tool_name`: 도구의 이름759* `tool_name`: 도구의 이름
734* `tool_use_id`: 이 도구 호출의 고유 식별자. 훅에 전달된 `tool_use_id`와 일치하여 OTel 이벤트와 훅 캡처 데이터 간의 상관 관계를 허용합니다.760* `tool_use_id`: 이 도구 호출의 고유 식별자. 훅에 전달된 `tool_use_id`와 일치하여 OTel 이벤트와 훅 캡처 데이터 간의 상관 관계를 허용합니다.
735* `success`: `"true"` 또는 `"false"`761* `success`: `"true"` 또는 `"false"`
741* `tool_input_size_bytes`: JSON 직렬화된 도구 입력의 크기(바이트)767* `tool_input_size_bytes`: JSON 직렬화된 도구 입력의 크기(바이트)
742* `tool_result_size_bytes`: 도구 결과의 크기(바이트)768* `tool_result_size_bytes`: 도구 결과의 크기(바이트)
743* `mcp_server_scope`: MCP 서버 범위 식별자(MCP 도구의 경우)769* `mcp_server_scope`: MCP 서버 범위 식별자(MCP 도구의 경우)
770* `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 이상 필요
744* `tool_parameters` (`OTEL_LOG_TOOL_DETAILS=1`일 때): 도구별 매개변수를 포함하는 JSON 문자열. Claude Desktop의 기본 제공 서버의 경우, Claude Desktop이 소유한 세션에서 `mcp_server_name`/`mcp_tool_name` 쌍은 플래그 없이도 포함됩니다. 이는 [도구 결정 이벤트](#tool-decision-event)와 동일한 호스트 작성 예외입니다. Claude Code v2.1.214 이상 필요. 매개변수는 도구에 따라 다릅니다:771* `tool_parameters` (`OTEL_LOG_TOOL_DETAILS=1`일 때): 도구별 매개변수를 포함하는 JSON 문자열. Claude Desktop의 기본 제공 서버의 경우, Claude Desktop이 소유한 세션에서 `mcp_server_name`/`mcp_tool_name` 쌍은 플래그 없이도 포함됩니다. 이는 [도구 결정 이벤트](#tool-decision-event)와 동일한 호스트 작성 예외입니다. Claude Code v2.1.214 이상 필요. 매개변수는 도구에 따라 다릅니다:
745 * Bash 도구의 경우: `bash_command`, `full_command`, `timeout`, `description`, `dangerouslyDisableSandbox`, 및 `git_commit_id`(git commit 명령이 성공할 때의 커밋 SHA)를 포함합니다. 데스크톱 앱의 작업 공간 bash 도구도 `tool_name`을 `Bash`로 보고하지만 `bash_command`, `full_command`, 및 `timeout`만 포함합니다.772 * Bash 도구의 경우: `bash_command`, `full_command`, `timeout`, `description`, `dangerouslyDisableSandbox`, 및 `git_commit_id`와 `git_branch`(git commit 명령이 성공할 때)를 포함합니다. `git_commit_id`는 커밋이 세션의 작업 디렉토리의 HEAD일 때 전체 커밋 SHA이고, 그 외에는 git의 축약된 SHA입니다. `git_branch`는 커밋된 브랜치이며, 분리된 HEAD에서는 생략됩니다.
773 * 데스크톱 앱의 작업 공간 Bash 도구(또한 `tool_name`을 `Bash`로 보고함): `bash_command`, `full_command`, 및 `timeout`만 포함합니다.
746 * MCP 도구의 경우: `mcp_server_name`, `mcp_tool_name`을 포함합니다.774 * MCP 도구의 경우: `mcp_server_name`, `mcp_tool_name`을 포함합니다.
747 * Skill 도구의 경우: `skill_name`을 포함합니다.775 * Skill 도구의 경우: `skill_name`을 포함합니다.
748 * Agent 도구 또는 레거시 Task 도구의 경우: `subagent_type`을 포함합니다.776 * Agent 도구 또는 레거시 Task 도구의 경우: `subagent_type`을 포함합니다.
761* 모든 [표준 속성](#standard-attributes)789* 모든 [표준 속성](#standard-attributes)
762* `event.name`: `"api_request"`790* `event.name`: `"api_request"`
763* `event.timestamp`: ISO 8601 타임스탬프791* `event.timestamp`: ISO 8601 타임스탬프
764* `event.sequence`: 세션 내 이벤트 순서 지정을 위한 단조 증가 카운터792* `event.sequence`: 이벤트 순서 지정을 위한 프로세스별 카운터([이벤트 상관 속성](#event-correlation-attributes)에 설명됨)
765* `model`: 사용된 모델(예: "claude-sonnet-5")793* `model`: 사용된 모델(예: "claude-sonnet-5")
766* `cost_usd`: USD 단위의 예상 비용794* `cost_usd`: USD 단위의 예상 비용
767* `cost_usd_micros`: 미국 달러의 백만분의 일 단위의 예상 비용(정수로 내보냄)795* `cost_usd_micros`: 미국 달러의 백만분의 일 단위의 예상 비용(정수로 내보냄)
790* 모든 [표준 속성](#standard-attributes)818* 모든 [표준 속성](#standard-attributes)
791* `event.name`: `"api_error"`819* `event.name`: `"api_error"`
792* `event.timestamp`: ISO 8601 타임스탬프820* `event.timestamp`: ISO 8601 타임스탬프
793* `event.sequence`: 세션 내 이벤트 순서 지정을 위한 단조 증가 카운터821* `event.sequence`: 이벤트 순서 지정을 위한 프로세스별 카운터([이벤트 상관 속성](#event-correlation-attributes)에 설명됨)
794* `model`: 사용된 모델(예: "claude-sonnet-5")822* `model`: 사용된 모델(예: "claude-sonnet-5")
795* `error`: 오류 메시지823* `error`: 오류 메시지
796* `status_code`: HTTP 상태 코드(숫자). 연결 실패와 같은 비HTTP 오류의 경우 없습니다.824* `status_code`: HTTP 상태 코드(숫자). 연결 실패와 같은 비HTTP 오류의 경우 없습니다.
816* 모든 [표준 속성](#standard-attributes)844* 모든 [표준 속성](#standard-attributes)
817* `event.name`: `"api_refusal"`845* `event.name`: `"api_refusal"`
818* `event.timestamp`: ISO 8601 타임스탬프846* `event.timestamp`: ISO 8601 타임스탬프
819* `event.sequence`: 세션 내 이벤트 순서 지정을 위한 단조 증가 카운터847* `event.sequence`: 이벤트 순서 지정을 위한 프로세스별 카운터([이벤트 상관 속성](#event-correlation-attributes)에 설명됨)
820* `model`: 요청의 모델 식별자848* `model`: 요청의 모델 식별자
821* `request_id`: 응답의 `request-id` 헤더에서 Anthropic API 요청 ID(예: `"req_011..."`). API가 반환할 때만 있습니다.849* `request_id`: 응답의 `request-id` 헤더에서 Anthropic API 요청 ID(예: `"req_011..."`). API가 반환할 때만 있습니다.
822* `query_source`: 요청을 발급한 하위 시스템(예: `"repl_main_thread"`, `"compact"`, 또는 하위 에이전트 이름). 정의는 [`api_request`](#api-request-event)를 참조하세요.850* `query_source`: 요청을 발급한 하위 시스템(예: `"repl_main_thread"`, `"compact"`, 또는 하위 에이전트 이름). 정의는 [`api_request`](#api-request-event)를 참조하세요.
842* 모든 [표준 속성](#standard-attributes)870* 모든 [표준 속성](#standard-attributes)
843* `event.name`: `"api_request_body"`871* `event.name`: `"api_request_body"`
844* `event.timestamp`: ISO 8601 타임스탬프872* `event.timestamp`: ISO 8601 타임스탬프
845* `event.sequence`: 세션 내 이벤트 순서 지정을 위한 단조 증가 카운터873* `event.sequence`: 이벤트 순서 지정을 위한 프로세스별 카운터([이벤트 상관 속성](#event-correlation-attributes)에 설명됨)
846* `body`: JSON 직렬화된 Messages API 요청 매개변수(예: 시스템 프롬프트, 메시지, 및 도구)(콘텐츠 제한(기본값 60KB)에서 잘림). 이전 어시스턴트 턴의 확장 사고 콘텐츠는 수정됩니다. 인라인 모드(`OTEL_LOG_RAW_API_BODIES=1`)에서만 내보냅니다.874* `body`: JSON 직렬화된 Messages API 요청 매개변수(예: 시스템 프롬프트, 메시지, 및 도구)(콘텐츠 제한(기본값 60KB)에서 잘림). 이전 어시스턴트 턴의 확장 사고 콘텐츠는 수정됩니다. 인라인 모드(`OTEL_LOG_RAW_API_BODIES=1`)에서만 내보냅니다.
847* `body_ref`: 잘리지 않은 본문을 포함하는 `<dir>/<uuid>.request.json` 파일의 절대 경로. 파일 모드(`OTEL_LOG_RAW_API_BODIES=file:<dir>`)에서만 내보냅니다.875* `body_ref`: 잘리지 않은 본문을 포함하는 `<dir>/<uuid>.request.json` 파일의 절대 경로. 파일 모드(`OTEL_LOG_RAW_API_BODIES=file:<dir>`)에서만 내보냅니다.
848* `body_length`: 잘리지 않은 본문 길이. `OTEL_LOG_RAW_API_BODIES=file:<dir>`일 때 UTF-8 바이트, 또는 `=1`일 때 UTF-16 코드 단위876* `body_length`: 잘리지 않은 본문 길이. `OTEL_LOG_RAW_API_BODIES=file:<dir>`일 때 UTF-8 바이트, 또는 `=1`일 때 UTF-16 코드 단위
863* 모든 [표준 속성](#standard-attributes)891* 모든 [표준 속성](#standard-attributes)
864* `event.name`: `"api_response_body"`892* `event.name`: `"api_response_body"`
865* `event.timestamp`: ISO 8601 타임스탬프893* `event.timestamp`: ISO 8601 타임스탬프
866* `event.sequence`: 세션 내 이벤트 순서 지정을 위한 단조 증가 카운터894* `event.sequence`: 이벤트 순서 지정을 위한 프로세스별 카운터([이벤트 상관 속성](#event-correlation-attributes)에 설명됨)
867* `body`: JSON 직렬화된 Messages API 응답(id, 콘텐츠 블록, 사용량, 및 중지 이유 포함)(콘텐츠 제한(기본값 60KB)에서 잘림). 확장 사고 콘텐츠는 수정됩니다. 인라인 모드(`OTEL_LOG_RAW_API_BODIES=1`)에서만 내보냅니다.895* `body`: JSON 직렬화된 Messages API 응답(id, 콘텐츠 블록, 사용량, 및 중지 이유 포함)(콘텐츠 제한(기본값 60KB)에서 잘림). 확장 사고 콘텐츠는 수정됩니다. 인라인 모드(`OTEL_LOG_RAW_API_BODIES=1`)에서만 내보냅니다.
868* `body_ref`: 잘리지 않은 본문을 포함하는 `<dir>/<request_id>.response.json` 파일의 절대 경로. 파일 모드(`OTEL_LOG_RAW_API_BODIES=file:<dir>`)에서만 내보냅니다.896* `body_ref`: 잘리지 않은 본문을 포함하는 `<dir>/<request_id>.response.json` 파일의 절대 경로. 파일 모드(`OTEL_LOG_RAW_API_BODIES=file:<dir>`)에서만 내보냅니다.
869* `body_length`: 잘리지 않은 본문 길이. `OTEL_LOG_RAW_API_BODIES=file:<dir>`일 때 UTF-8 바이트, 또는 `=1`일 때 UTF-16 코드 단위897* `body_length`: 잘리지 않은 본문 길이. `OTEL_LOG_RAW_API_BODIES=file:<dir>`일 때 UTF-8 바이트, 또는 `=1`일 때 UTF-16 코드 단위
885* 모든 [표준 속성](#standard-attributes)913* 모든 [표준 속성](#standard-attributes)
886* `event.name`: `"tool_decision"`914* `event.name`: `"tool_decision"`
887* `event.timestamp`: ISO 8601 타임스탬프915* `event.timestamp`: ISO 8601 타임스탬프
888* `event.sequence`: 세션 내 이벤트 순서 지정을 위한 단조 증가 카운터916* `event.sequence`: 이벤트 순서 지정을 위한 프로세스별 카운터([이벤트 상관 속성](#event-correlation-attributes)에 설명됨)
889* `tool_name`: 도구의 이름(예: "Read", "Edit", "Write", "NotebookEdit")917* `tool_name`: 도구의 이름(예: "Read", "Edit", "Write", "NotebookEdit")
890* `tool_use_id`: 이 도구 호출의 고유 식별자. 훅에 전달된 `tool_use_id`와 일치하여 OTel 이벤트와 훅 캡처 데이터 간의 상관 관계를 허용합니다.918* `tool_use_id`: 이 도구 호출의 고유 식별자. 훅에 전달된 `tool_use_id`와 일치하여 OTel 이벤트와 훅 캡처 데이터 간의 상관 관계를 허용합니다.
891* `decision`: `"accept"` 또는 `"reject"`919* `decision`: `"accept"` 또는 `"reject"`
920* 모든 [표준 속성](#standard-attributes)948* 모든 [표준 속성](#standard-attributes)
921* `event.name`: `"permission_mode_changed"`949* `event.name`: `"permission_mode_changed"`
922* `event.timestamp`: ISO 8601 타임스탬프950* `event.timestamp`: ISO 8601 타임스탬프
923* `event.sequence`: 세션 내 이벤트 순서 지정을 위한 단조 증가 카운터951* `event.sequence`: 이벤트 순서 지정을 위한 프로세스별 카운터([이벤트 상관 속성](#event-correlation-attributes)에 설명됨)
924* `from_mode`: 이전 권한 모드(예: `"default"`, `"plan"`, `"acceptEdits"`, `"auto"`, 또는 `"bypassPermissions"`)952* `from_mode`: 이전 권한 모드(예: `"default"`, `"plan"`, `"acceptEdits"`, `"auto"`, 또는 `"bypassPermissions"`)
925* `to_mode`: 새 권한 모드953* `to_mode`: 새 권한 모드
926* `trigger`: 변경을 야기한 것. `"shift_tab"`, `"exit_plan_mode"`, `"auto_gate_denied"`, 또는 `"auto_opt_in"` 중 하나. SDK 또는 브리지에서 전환이 시작될 때는 없습니다.954* `trigger`: 변경을 야기한 것. `"shift_tab"`, `"exit_plan_mode"`, `"auto_gate_denied"`, 또는 `"auto_opt_in"` 중 하나. SDK 또는 브리지에서 전환이 시작될 때는 없습니다.
938* 모든 [표준 속성](#standard-attributes)966* 모든 [표준 속성](#standard-attributes)
939* `event.name`: `"auth"`967* `event.name`: `"auth"`
940* `event.timestamp`: ISO 8601 타임스탬프968* `event.timestamp`: ISO 8601 타임스탬프
941* `event.sequence`: 세션 내 이벤트 순서 지정을 위한 단조 증가 카운터969* `event.sequence`: 이벤트 순서 지정을 위한 프로세스별 카운터([이벤트 상관 속성](#event-correlation-attributes)에 설명됨)
942* `action`: `"login"` 또는 `"logout"`970* `action`: `"login"` 또는 `"logout"`
943* `success`: `"true"` 또는 `"false"`971* `success`: `"true"` 또는 `"false"`
944* `auth_method`: 인증 방법(예: `"oauth"`)972* `auth_method`: 인증 방법(예: `"oauth"`)
958* 모든 [표준 속성](#standard-attributes)986* 모든 [표준 속성](#standard-attributes)
959* `event.name`: `"mcp_server_connection"`987* `event.name`: `"mcp_server_connection"`
960* `event.timestamp`: ISO 8601 타임스탬프988* `event.timestamp`: ISO 8601 타임스탬프
961* `event.sequence`: 세션 내 이벤트 순서 지정을 위한 단조 증가 카운터989* `event.sequence`: 이벤트 순서 지정을 위한 프로세스별 카운터([이벤트 상관 속성](#event-correlation-attributes)에 설명됨)
962* `status`: `"connected"`, `"failed"`, 또는 `"disconnected"`990* `status`: `"connected"`, `"failed"`, 또는 `"disconnected"`
963* `transport_type`: 서버 전송(예: `"stdio"`, `"sse"`, 또는 `"http"`)991* `transport_type`: 서버 전송(예: `"stdio"`, `"sse"`, 또는 `"http"`)
964* `server_scope`: 서버가 구성된 범위(예: `"user"`, `"project"`, 또는 `"local"`)992* `server_scope`: 서버가 구성된 범위(예: `"user"`, `"project"`, 또는 `"local"`)
983* 모든 [표준 속성](#standard-attributes)1011* 모든 [표준 속성](#standard-attributes)
984* `event.name`: `"internal_error"`1012* `event.name`: `"internal_error"`
985* `event.timestamp`: ISO 8601 타임스탬프1013* `event.timestamp`: ISO 8601 타임스탬프
986* `event.sequence`: 세션 내 이벤트 순서 지정을 위한 단조 증가 카운터1014* `event.sequence`: 이벤트 순서 지정을 위한 프로세스별 카운터([이벤트 상관 속성](#event-correlation-attributes)에 설명됨)
987* `error_name`: 오류 클래스 이름(예: `"TypeError"` 또는 `"SyntaxError"`)1015* `error_name`: 오류 클래스 이름(예: `"TypeError"` 또는 `"SyntaxError"`)
988* `error_code`: 오류에 있을 때의 Node.js errno 코드(예: `"ENOENT"`)1016* `error_code`: 오류에 있을 때의 Node.js errno 코드(예: `"ENOENT"`)
989 1017
1000* 모든 [표준 속성](#standard-attributes)1028* 모든 [표준 속성](#standard-attributes)
1001* `event.name`: `"plugin_installed"`1029* `event.name`: `"plugin_installed"`
1002* `event.timestamp`: ISO 8601 타임스탬프1030* `event.timestamp`: ISO 8601 타임스탬프
1003* `event.sequence`: 세션 내 이벤트 순서 지정을 위한 단조 증가 카운터1031* `event.sequence`: 이벤트 순서 지정을 위한 프로세스별 카운터([이벤트 상관 속성](#event-correlation-attributes)에 설명됨)
1004* `marketplace.is_official`: 마켓플레이스가 공식 Anthropic 마켓플레이스일 때 `"true"`, 그 외에는 `"false"`1032* `marketplace.is_official`: 마켓플레이스가 공식 Anthropic 마켓플레이스일 때 `"true"`, 그 외에는 `"false"`
1005* `install.trigger`: `"cli"` 또는 `"ui"`1033* `install.trigger`: `"cli"` 또는 `"ui"`
1006* `plugin.name`: 설치된 플러그인의 이름. 타사 마켓플레이스의 경우 `OTEL_LOG_TOOL_DETAILS=1`일 때만 포함됩니다.1034* `plugin.name`: 설치된 플러그인의 이름. 타사 마켓플레이스의 경우 `OTEL_LOG_TOOL_DETAILS=1`일 때만 포함됩니다.
1020* 모든 [표준 속성](#standard-attributes)1048* 모든 [표준 속성](#standard-attributes)
1021* `event.name`: `"plugin_loaded"`1049* `event.name`: `"plugin_loaded"`
1022* `event.timestamp`: ISO 8601 타임스탬프1050* `event.timestamp`: ISO 8601 타임스탬프
1023* `event.sequence`: 세션 내 이벤트 순서 지정을 위한 단조 증가 카운터1051* `event.sequence`: 이벤트 순서 지정을 위한 프로세스별 카운터([이벤트 상관 속성](#event-correlation-attributes)에 설명됨)
1024* `plugin.name`: 플러그인의 이름. 공식 마켓플레이스 및 기본 제공 번들 외부의 플러그인의 경우 `OTEL_LOG_TOOL_DETAILS=1`이 설정되지 않으면 `"third-party"`입니다.1052* `plugin.name`: 플러그인의 이름. 공식 마켓플레이스 및 기본 제공 번들 외부의 플러그인의 경우 `OTEL_LOG_TOOL_DETAILS=1`이 설정되지 않으면 `"third-party"`입니다.
1025* `marketplace.name`: 플러그인이 설치된 마켓플레이스(알려진 경우). `plugin.name`과 동일한 조건에서 `"third-party"`로 수정됩니다.1053* `marketplace.name`: 플러그인이 설치된 마켓플레이스(알려진 경우). `plugin.name`과 동일한 조건에서 `"third-party"`로 수정됩니다.
1026* `plugin.version`: 플러그인 매니페스트의 버전. 이름이 수정되지 않고 매니페스트가 버전을 선언할 때만 포함됩니다.1054* `plugin.version`: 플러그인 매니페스트의 버전. 이름이 수정되지 않고 매니페스트가 버전을 선언할 때만 포함됩니다.
1048* 모든 [표준 속성](#standard-attributes)1076* 모든 [표준 속성](#standard-attributes)
1049* `event.name`: `"skill_activated"`1077* `event.name`: `"skill_activated"`
1050* `event.timestamp`: ISO 8601 타임스탬프1078* `event.timestamp`: ISO 8601 타임스탬프
1051* `event.sequence`: 세션 내 이벤트 순서 지정을 위한 단조 증가 카운터1079* `event.sequence`: 이벤트 순서 지정을 위한 프로세스별 카운터([이벤트 상관 속성](#event-correlation-attributes)에 설명됨)
1052* `skill.name`: 스킬의 이름. 사용자 정의 및 타사 플러그인 스킬의 경우 `OTEL_LOG_TOOL_DETAILS=1`이 설정되지 않으면 플레이스홀더 `"custom_skill"`입니다.1080* `skill.name`: 스킬의 이름. 사용자 정의 및 타사 플러그인 스킬의 경우 `OTEL_LOG_TOOL_DETAILS=1`이 설정되지 않으면 플레이스홀더 `"custom_skill"`입니다.
1053* `invocation_trigger`: 스킬이 트리거된 방식(`"user-slash"`, `"claude-proactive"`, 또는 `"nested-skill"`)1081* `invocation_trigger`: 스킬이 트리거된 방식(`"user-slash"`, `"claude-proactive"`, 또는 `"nested-skill"`)
1054* `skill.source`: 스킬이 로드된 위치(예: `"bundled"`, `"userSettings"`, `"projectSettings"`, `"plugin"`)1082* `skill.source`: 스킬이 로드된 위치(예: `"bundled"`, `"userSettings"`, `"projectSettings"`, `"plugin"`)
1069* 모든 [표준 속성](#standard-attributes)1097* 모든 [표준 속성](#standard-attributes)
1070* `event.name`: `"at_mention"`1098* `event.name`: `"at_mention"`
1071* `event.timestamp`: ISO 8601 타임스탬프1099* `event.timestamp`: ISO 8601 타임스탬프
1072* `event.sequence`: 세션 내 이벤트 순서 지정을 위한 단조 증가 카운터1100* `event.sequence`: 이벤트 순서 지정을 위한 프로세스별 카운터([이벤트 상관 속성](#event-correlation-attributes)에 설명됨)
1073* `mention_type`: 멘션의 유형(`"file"`, `"directory"`, `"agent"`, `"mcp_resource"`, `"peer"`). `"peer"` 값은 [다른 Claude Code 세션](/docs/ko/cross-session-messaging) 중 하나를 멘션했음을 의미합니다. Claude Code v2.1.232 이상 필요1101* `mention_type`: 멘션의 유형(`"file"`, `"directory"`, `"agent"`, `"mcp_resource"`, `"peer"`). `"peer"` 값은 [다른 Claude Code 세션](/docs/ko/cross-session-messaging) 중 하나를 멘션했음을 의미합니다. Claude Code v2.1.232 이상 필요
1074* `success`: 멘션이 성공적으로 해결되었는지 여부(`"true"` 또는 `"false"`)1102* `success`: 멘션이 성공적으로 해결되었는지 여부(`"true"` 또는 `"false"`)
1075 1103
1086* 모든 [표준 속성](#standard-attributes)1114* 모든 [표준 속성](#standard-attributes)
1087* `event.name`: `"api_retries_exhausted"`1115* `event.name`: `"api_retries_exhausted"`
1088* `event.timestamp`: ISO 8601 타임스탬프1116* `event.timestamp`: ISO 8601 타임스탬프
1089* `event.sequence`: 세션 내 이벤트 순서 지정을 위한 단조 증가 카운터1117* `event.sequence`: 이벤트 순서 지정을 위한 프로세스별 카운터([이벤트 상관 속성](#event-correlation-attributes)에 설명됨)
1090* `model`: 사용된 모델1118* `model`: 사용된 모델
1091* `error`: 최종 오류 메시지1119* `error`: 최종 오류 메시지
1092* `status_code`: HTTP 상태 코드(숫자). 비HTTP 오류의 경우 없습니다.1120* `status_code`: HTTP 상태 코드(숫자). 비HTTP 오류의 경우 없습니다.
1107* 모든 [표준 속성](#standard-attributes)1135* 모든 [표준 속성](#standard-attributes)
1108* `event.name`: `"hook_registered"`1136* `event.name`: `"hook_registered"`
1109* `event.timestamp`: ISO 8601 타임스탬프1137* `event.timestamp`: ISO 8601 타임스탬프
1110* `event.sequence`: 세션 내 이벤트 순서 지정을 위한 단조 증가 카운터1138* `event.sequence`: 이벤트 순서 지정을 위한 프로세스별 카운터([이벤트 상관 속성](#event-correlation-attributes)에 설명됨)
1111* `hook_event`: 훅 이벤트 유형(예: `"PreToolUse"` 또는 `"PostToolUse"`)1139* `hook_event`: 훅 이벤트 유형(예: `"PreToolUse"` 또는 `"PostToolUse"`)
1112* `hook_type`: 훅 구현 유형: `"command"`, `"prompt"`, `"mcp_tool"`, `"http"`, 또는 `"agent"`1140* `hook_type`: 훅 구현 유형: `"command"`, `"prompt"`, `"mcp_tool"`, `"http"`, 또는 `"agent"`
1113* `hook_source`: 훅이 정의된 위치: `"userSettings"`, `"projectSettings"`, `"localSettings"`, `"flagSettings"`, `"policySettings"`, 또는 `"pluginHook"`1141* `hook_source`: 훅이 정의된 위치: `"userSettings"`, `"projectSettings"`, `"localSettings"`, `"flagSettings"`, `"policySettings"`, 또는 `"pluginHook"`
1129* 모든 [표준 속성](#standard-attributes)1157* 모든 [표준 속성](#standard-attributes)
1130* `event.name`: `"hook_execution_start"`1158* `event.name`: `"hook_execution_start"`
1131* `event.timestamp`: ISO 8601 타임스탬프1159* `event.timestamp`: ISO 8601 타임스탬프
1132* `event.sequence`: 세션 내 이벤트 순서 지정을 위한 단조 증가 카운터1160* `event.sequence`: 이벤트 순서 지정을 위한 프로세스별 카운터([이벤트 상관 속성](#event-correlation-attributes)에 설명됨)
1133* `hook_event`: 훅 이벤트 유형(예: `"PreToolUse"` 또는 `"PostToolUse"`)1161* `hook_event`: 훅 이벤트 유형(예: `"PreToolUse"` 또는 `"PostToolUse"`)
1134* `hook_name`: 매처를 포함한 전체 훅 이름(예: `"PreToolUse:Write"`)1162* `hook_name`: 매처를 포함한 전체 훅 이름(예: `"PreToolUse:Write"`)
1135* `num_hooks`: 일치하는 훅 명령 수1163* `num_hooks`: 일치하는 훅 명령 수
1151* 모든 [표준 속성](#standard-attributes)1179* 모든 [표준 속성](#standard-attributes)
1152* `event.name`: `"hook_execution_complete"`1180* `event.name`: `"hook_execution_complete"`
1153* `event.timestamp`: ISO 8601 타임스탬프1181* `event.timestamp`: ISO 8601 타임스탬프
1154* `event.sequence`: 세션 내 이벤트 순서 지정을 위한 단조 증가 카운터1182* `event.sequence`: 이벤트 순서 지정을 위한 프로세스별 카운터([이벤트 상관 속성](#event-correlation-attributes)에 설명됨)
1155* `hook_event`: 훅 이벤트 유형1183* `hook_event`: 훅 이벤트 유형
1156* `hook_name`: 매처를 포함한 전체 훅 이름1184* `hook_name`: 매처를 포함한 전체 훅 이름
1157* `num_hooks`: 일치하는 훅 명령 수1185* `num_hooks`: 일치하는 훅 명령 수
1178* 모든 [표준 속성](#standard-attributes)1206* 모든 [표준 속성](#standard-attributes)
1179* `event.name`: `"hook_plugin_metrics"`1207* `event.name`: `"hook_plugin_metrics"`
1180* `event.timestamp`: ISO 8601 타임스탬프1208* `event.timestamp`: ISO 8601 타임스탬프
1181* `event.sequence`: 세션 내 이벤트 순서 지정을 위한 단조 증가 카운터1209* `event.sequence`: 이벤트 순서 지정을 위한 프로세스별 카운터([이벤트 상관 속성](#event-correlation-attributes)에 설명됨)
1182* `plugin_id`: `<name>@<marketplace>` 형식의 플러그인 식별자1210* `plugin_id`: `<name>@<marketplace>` 형식의 플러그인 식별자
1183* `hook_event`: 메트릭을 내보낸 훅 이벤트 유형1211* `hook_event`: 메트릭을 내보낸 훅 이벤트 유형
1184* 최대 20개의 플러그인 내보낸 메트릭 키. 이름은 `^[a-z][a-z0-9_]{0,39}$`와 일치합니다. 값은 부울 또는 숫자입니다.1212* 최대 20개의 플러그인 내보낸 메트릭 키. 이름은 `^[a-z][a-z0-9_]{0,39}$`와 일치합니다. 값은 부울 또는 숫자입니다.
1196* 모든 [표준 속성](#standard-attributes)1224* 모든 [표준 속성](#standard-attributes)
1197* `event.name`: `"compaction"`1225* `event.name`: `"compaction"`
1198* `event.timestamp`: ISO 8601 타임스탬프1226* `event.timestamp`: ISO 8601 타임스탬프
1199* `event.sequence`: 세션 내 이벤트 순서 지정을 위한 단조 증가 카운터1227* `event.sequence`: 이벤트 순서 지정을 위한 프로세스별 카운터([이벤트 상관 속성](#event-correlation-attributes)에 설명됨)
1200* `trigger`: `"auto"` 또는 `"manual"`1228* `trigger`: `"auto"` 또는 `"manual"`
1201* `success`: `"true"` 또는 `"false"`1229* `success`: `"true"` 또는 `"false"`
1202* `duration_ms`: 압축 지속 시간1230* `duration_ms`: 압축 지속 시간
1218* 모든 [표준 속성](#standard-attributes)1246* 모든 [표준 속성](#standard-attributes)
1219* `event.name`: `"subagent_completed"`1247* `event.name`: `"subagent_completed"`
1220* `event.timestamp`: ISO 8601 타임스탬프1248* `event.timestamp`: ISO 8601 타임스탬프
1221* `event.sequence`: 세션 내 이벤트 순서 지정을 위한 단조 증가 카운터1249* `event.sequence`: 이벤트 순서 지정을 위한 프로세스별 카운터([이벤트 상관 속성](#event-correlation-attributes)에 설명됨)
1222* `agent_type`: 하위 에이전트 유형. 기본 제공 에이전트 이름과 공식 마켓플레이스 플러그인의 에이전트는 그대로 나타납니다. 다른 에이전트 이름은 `OTEL_LOG_TOOL_DETAILS=1`이 설정되지 않으면 `"custom"`으로 대체됩니다.1250* `agent_type`: 하위 에이전트 유형. 기본 제공 에이전트 이름과 공식 마켓플레이스 플러그인의 에이전트는 그대로 나타납니다. 다른 에이전트 이름은 `OTEL_LOG_TOOL_DETAILS=1`이 설정되지 않으면 `"custom"`으로 대체됩니다.
1223* `agent.source`: 에이전트 정의가 어디서 나왔는지: `built-in`, `plugin`, 또는 `userSettings` 또는 `projectSettings`와 같은 사용자 정의 에이전트를 정의한 설정 소스1251* `agent.source`: 에이전트 정의가 어디서 나왔는지: `built-in`, `plugin`, 또는 `userSettings` 또는 `projectSettings`와 같은 사용자 정의 에이전트를 정의한 설정 소스
1224* `is_built_in`: 하위 에이전트가 기본 제공 에이전트 유형인지 여부1252* `is_built_in`: 하위 에이전트가 기본 제공 에이전트 유형인지 여부
1244* 모든 [표준 속성](#standard-attributes)1272* 모든 [표준 속성](#standard-attributes)
1245* `event.name`: `"feedback_survey"`1273* `event.name`: `"feedback_survey"`
1246* `event.timestamp`: ISO 8601 타임스탬프1274* `event.timestamp`: ISO 8601 타임스탬프
1247* `event.sequence`: 세션 내 이벤트 순서 지정을 위한 단조 증가 카운터1275* `event.sequence`: 이벤트 순서 지정을 위한 프로세스별 카운터([이벤트 상관 속성](#event-correlation-attributes)에 설명됨)
1248* `event_type`: 설문 생명 주기 이벤트(예: `"appeared"`, `"responded"`, 또는 `"transcript_prompt_appeared"`)1276* `event_type`: 설문 생명 주기 이벤트(예: `"appeared"`, `"responded"`, 또는 `"transcript_prompt_appeared"`)
1249* `appearance_id`: 하나의 설문 인스턴스에 대해 내보낸 이벤트를 연결하는 고유 ID1277* `appearance_id`: 하나의 설문 인스턴스에 대해 내보낸 이벤트를 연결하는 고유 ID
1250* `survey_type`: 이벤트를 생성한 설문. `"session"`은 "Claude가 어떻게 하고 있나요?" 평가 프롬프트입니다.1278* `survey_type`: 이벤트를 생성한 설문. `"session"`은 "Claude가 어떻게 하고 있나요?" 평가 프롬프트입니다.
1268* 모든 [표준 속성](#standard-attributes)1296* 모든 [표준 속성](#standard-attributes)
1269* `event.name`: `"retention_sweep"`1297* `event.name`: `"retention_sweep"`
1270* `event.timestamp`: ISO 8601 타임스탬프1298* `event.timestamp`: ISO 8601 타임스탬프
1271* `event.sequence`: 세션 내 이벤트 순서 지정을 위한 단조 증가 카운터1299* `event.sequence`: 이벤트 순서 지정을 위한 프로세스별 카운터([이벤트 상관 속성](#event-correlation-attributes)에 설명됨)
1272* `result`: 스윕이 실행되었을 때 `"complete"`, Claude Code가 일시 중지했을 때 `"skipped"`1300* `result`: 스윕이 실행되었을 때 `"complete"`, Claude Code가 일시 중지했을 때 `"skipped"`
1273* `period_days`: 병합된 설정의 `cleanupPeriodDays` 값(일 단위) 또는 소스가 설정하지 않을 때 `30`. 건너뛴 이벤트에서, 스윕이 사용했을 값(Claude Code가 읽을 수 있는 설정 소스에서 계산됨)1301* `period_days`: 병합된 설정의 `cleanupPeriodDays` 값(일 단위) 또는 소스가 설정하지 않을 때 `30`. 건너뛴 이벤트에서, 스윕이 사용했을 값(Claude Code가 읽을 수 있는 설정 소스에서 계산됨)
1274* `used_default`: 읽을 수 있는 설정 소스가 `cleanupPeriodDays`를 설정하지 않을 때 `"true"`, 그 외에는 `"false"`. 완료 이벤트에서, `"true"`는 30일 기본값이 적용되었음을 의미합니다.1302* `used_default`: 읽을 수 있는 설정 소스가 `cleanupPeriodDays`를 설정하지 않을 때 `"true"`, 그 외에는 `"false"`. 완료 이벤트에서, `"true"`는 30일 기본값이 적용되었음을 의미합니다.
