Мониторинг

​

Быстрый старт

# 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 endpoint (для 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. Для отладки: сократить интервалы экспорта, и сбросить их для использования в production
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

• Endpoints: когда вы устанавливаете OTEL_EXPORTER_OTLP_ENDPOINT, Claude Code удаляет каждый endpoint для конкретного сигнала, установленный разработчиком. Разработчики не могут направить один сигнал на другой сборщик, поэтому вам не нужно также устанавливать переменные endpoint для конкретного сигнала в управляемых па��аметрах.
• Протоколы: когда вы устанавливаете OTEL_EXPORTER_OTLP_PROTOCOL, Claude Code удаляет каждый протокол для конкретного сигнала, установленный разработчиком.
• Учетные данные: когда вы устанавливаете OTEL_EXPORTER_OTLP_HEADERS, OTEL_EXPORTER_OTLP_CLIENT_KEY или OTEL_EXPORTER_OTLP_CLIENT_CERTIFICATE, Claude Code удаляет версии этой переменной для конкретного сигнала, установленные разработчиком, плюс каждую переменную endpoint, установленную разработчиком, общую или для конкретного сигнала, поскольку эти учетные данные в противном случае достигли бы сборщика, который не выбрали управляемые параметры.
• Селекторы экспортера: OTEL_METRICS_EXPORTER, OTEL_LOGS_EXPORTER и бета-версия OTEL_TRACES_EXPORTER следуют обычному приоритету для каждого ключа. Параметр разработчика все еще может отключить сигнал или переключить его на экспортер консоли, поэтому установите селекторы в управляемых параметрах также, если вам нужно их заблокировать. Во всех источниках администратора, OTEL_LOGS_EXPORTER следует единице телеметрии, в то время как два других селектора объединяются для каждого ключа. Требуется Claude Code v2.1.223 или позже.
• Бета-версия endpoints трассировки: с активной детальной бета-версией трассировки, Claude Code экспортирует логи и трассировки в BETA_TRACING_ENDPOINT вместо использования экспортеров логов и трассировок. Claude Code поэтому удаляет установленный разработчиком BETA_TRACING_ENDPOINT всякий раз, когда любой из этих управляемых параметров определяет назначение любого из этих сигналов:
  • Общий endpoint или endpoint логов/трассировок или учетные данные
  • otelHeadersHelper
  • Селектор экспортера логов или трассировок, установленный на none, console или пустой, значения, которые держат сигнал вне сборщика
  • CLAUDE_CODE_ENABLE_TELEMETRY отключен
  Endpoint или учетные данные только для метрик его не удаляют. До v2.1.251, установленный разработчиком BETA_TRACING_ENDPOINT перенаправлял логи и трассировки, которые экспортирует детальная бета-версия трассировки, даже когда управляемые параметры закрепили сборщик.

​

Детали конфигурации

​

Общие переменные конфигурации

​

Аутентификация mTLS

​

Контроль кардинальности метрик

​

Traces (beta)

​

Иерархия span

claude_code.interaction
├── claude_code.llm_request
├── claude_code.hook                    (требует детальную бета-трассировку)
└── claude_code.tool
    ├── claude_code.tool.blocked_on_user
    ├── claude_code.tool.execution
    └── (инструмент Agent) spans субагента claude_code.llm_request / claude_code.tool

​

Атрибуты span

• Вызова любого инструмента, отличного от Read, Edit, Write, Bash, WebFetch, WebSearch и инструментов MCP
• Read, который возвращает что-либо, отличное от текста файла, такое как изображение, PDF или повторное чтение файла, содержимое которого не изменилось
• Вызова Edit или Write, если вы также не установите OTEL_LOG_TOOL_DETAILS=1
• Вызова WebFetch или WebSearch, который Claude Code перевёл в фоновый режим во время выполнения, чтобы ожидающее сообщение могло дойти до Claude. Результат, поступающий позже, также не записывается. Чтобы узнать, когда Claude Code переводит вызов в фон, см. Когда Claude Code отправляет то, что вы поставили в очередь для терминала и поле priority для сессий Agent SDK

​

Динамические заголовки

​

Конфигурация параметров

{
  "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 в сеансе
• stderr, в неинтерактивных сеансах, запущенных с -p

​

Поведение обновления

​

Поддержка организаций с несколькими командами

# Добавить пользовательские атрибуты для идентификации команды
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"

​

Привязка телеметрии к сессиям Desktop SSH

{
  "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_RESOURCE_ATTRIBUTES": "host.name=build-7"
  }
}

• Вы задали её на компьютере, где запущен Desktop: Desktop не передаёт заданное там значение в сессию SSH
• Вы экспортировали её в /etc/profile или другом файле, который читают только оболочки входа (login shell): имя поступает, когда вы запускаете claude из оболочки входа, но не в сессии Desktop SSH. Desktop запускает Claude Code не через оболочку входа. Вместо этого задайте переменную в env в файле управляемых настроек на удалённой машине.
• Значение содержит пробел: в этом случае Claude Code не копирует ни один из ключей в события или точки данных и не сообщает об ошибке. Уберите пробел из значения.
• Переменную уже задаёт что-то другое: в сессии, запускаемой десктопным приложением, переменная, уже заданная в окружении запуска, имеет приоритет над файлами настроек. В логе отладки указывается каждая проигнорированная переменная. Когда стороннее развёртывание Desktop указывает эндпоинт OTLP в предоставляемом им окружении, это окружение содержит собственную OTEL_RESOURCE_ATTRIBUTES Desktop.

​

Примеры конфигураций

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

​

Телеметрия из облачных сеансов и Claude Tag

• Параметры, управляемые сервером: добавьте их в блок env параметров, управляемых сервером вашей организации. Claude Code получает эти параметры при запуске везде, где применяются параметры, управляемые сервером, что включает машины ваших пользователей и облачные сеансы, кроме сеансов канала Claude Tag. Сеансы Claude Tag не получают ваши параметры, управляемые сервером, поэтому этот способ их не настраивает.
• Переменные окружения: добавьте их в переменные окружения облачного окружения, чтобы настроить только сеансы, работающие в этом окружении. Это способ, который достигает сеансов Claude Tag.

• Позвольте сеансам достичь сборщика: Claude Code отправляет экспорт через сеть сеанса, поэтому достигнет ли он хоста в вашем OTEL_EXPORTER_OTLP_ENDPOINT, зависит от уровня сетевого доступа окружения. Если сеансы не могут достичь домена сборщика на выбранном вами уровне, добавьте домен в список разрешений окружения, потому что ни один параметр, управляемый сервером, не добавляет домены в список разрешений сети окружения.
• Каналы Claude Tag: вносите изменения в список разрешённых доменов и любые переменные окружения в общем окружении, установленном как окружение по умолчанию для вашей организации или закреплённом за каналом.
• Cowork настраивается отдельно: сеансы Cowork не получают параметры, управляемые сервером, как показывает таблица охвата поверхности, поэтому блок env, управляемый сервером, не настраивает их телеметрию.

​

Атрибутирование телеметрии облачным сеансам

• Определить сеансы Claude Tag: установите OTEL_METRICS_INCLUDE_ENTRYPOINT=true, как описано в разделе Контроль кардинальности метрик. Метрики затем содержат app.entrypoint, значение которого — claude-in-slack для сеансов Claude Tag.
• Добавить пользовательские атрибуты: установите OTEL_RESOURCE_ATTRIBUTES в том же месте, где вы устанавливаете другие переменные OTEL_* для этих сеансов. Если вы export его в скрипте настройки окружения вместо этого, значение не достигает Claude Code: скрипт настройки — это отдельный скрипт Bash, который запускается перед запуском Claude Code, и переменные, которые он экспортирует, заканчиваются с ним.

​

Доступные метрики и события

​

Стандартные атрибуты

• prompt.id: UUID, связывающий промпт пользователя со всеми последующими событиями до следующего промпта. См. Атрибуты корреляции событий.
• workspace.host_paths: каталоги рабочего пространства хоста, выбранные в настольном приложении, в виде массива строк
• workflow.run_id: идентификатор запуска с префиксом wf_ в событиях API и инструментов, которые генерируют агенты, относящиеся к запуску инструмента Workflow. Фильтрация событий по одному workflow.run_id позволяет восстановить API-запросы и результаты инструментов этого запуска. Идентификатор охватывает агентов, порождаемых скриптом workflow, и всех агентов, которых порождают уже они, например вызовы скиллов. Он совпадает с идентификатором запуска, сообщаемым в результате инструмента Workflow.
• workflow.name: имя workflow, meta.name его скрипта, генерируется вместе с workflow.run_id. Имена встроенных workflow отображаются как есть, когда запуск выполняет неизменённый встроенный скрипт. Имена, заданные пользователем, включая отредактированные копии встроенных скриптов, заменяются на custom, если не задано OTEL_LOG_TOOL_DETAILS=1.
• agent_id: идентификатор субагента, вызвавшего событие, например a3f2c1b4d5e6f7a80. Он присутствует в событиях API и инструментов субагента, в его событиях assistant_response и в subagent_completed для завершённого субагента. Отсутствует в событиях основной сессии и внутрипроцессных участников команды. agent_id спана субагента имеет то же значение или добавляет метку после начальной a, как в acompact-3f2c1b4d5e6f7a80. Требуется Claude Code v2.1.310 или новее
• parent_agent_id: agent_id агента, который породил или последним возобновил субагента, вызвавшего событие. Отсутствует, если этот агент — основная сессия. Требуется Claude Code v2.1.310 или новее

​

Атрибуты репозитория

​

Метрики

​

Подробности метрик

​

Счётчик сессий

• Все стандартные атрибуты
• start_type: Способ запуска сессии. Одно из значений "fresh", "resume", "continue" или "agents_view". Значение "agents_view" обозначает процесс панели claude agents — локальный интерфейс, запускаемый пользователем, а не диалоговую сессию. Фильтруйте по этому значению, чтобы отделять запуски процессов интерфейса от диалоговых сессий на ваших дашбордах.

​

Счётчик строк кода

• Все стандартные атрибуты
• type: ("added", "removed")
• model: Идентификатор модели, внёсшей изменение (например, “claude-sonnet-5”)

​

Счётчик pull request

• Все стандартные атрибуты

​

Счётчик коммитов

• Все стандартные атрибуты

​

Счётчик стоимости

• Все стандартные атрибуты
• model: Идентификатор модели (например, “claude-sonnet-5”)
• query_source: Категория подсистемы, отправившей запрос. Одно из значений "main", "subagent" или "auxiliary"
• speed: "fast", если запрос использовал быстрый режим. В остальных случаях отсутствует
• effort: Уровень effort, применённый к запросу: "low", "medium", "high", "xhigh" или "max". Отсутствует, если Claude Code не отправляет уровень effort, например для модели, которая не поддерживает effort.
• 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"). Тип "input" не включает токены, прочитанные из кэша промптов или записанные в него, — они учитываются в "cacheRead" и "cacheCreation". Тип "cacheCreation" учитывает записи в кэш с пятиминутным и часовым временем жизни кэша вместе.
• model: Идентификатор модели (например, “claude-sonnet-5”)
• query_source: Категория подсистемы, отправившей запрос. Одно из значений "main", "subagent" или "auxiliary"
• speed: "fast", если запрос использовал быстрый режим. В остальных случаях отсутствует
• effort: Уровень 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" для взаимодействий с клавиатурой, "cli" для выполнения инструментов и ответов ИИ

​

События

​

Атрибуты корреляции событий

• message.uuid в user_prompt, assistant_response и api_response_body
• request_id в событиях API, сохраняемый как requestId в записях ассистента в транскрипте
• tool_use_id в событиях tool_result и tool_decision, а также в событиях safety_event, кроме относящихся к завершению хода

​

Событие промпта пользователя

• Все стандартные атрибуты
• event.name: "user_prompt"
• event.timestamp: Метка времени ISO 8601
• event.sequence: счётчик процесса для упорядочивания событий, описанный в разделе Атрибуты корреляции событий
• prompt_length: Длина промпта
• prompt: Содержимое промпта. По умолчанию скрыто. Задайте OTEL_LOG_USER_PROMPTS=1, чтобы включить его
• prompt_text: То же значение, что и prompt, скрываемое по тому же условию. Бэкенд, который хранит имена атрибутов с точками как вложенные объекты, читает prompt.id как id внутри объекта с именем prompt и может потерять строку промпта. В этом случае читайте prompt_text. Требуется Claude Code v2.1.287 или новее
• message.uuid: UUID итогового сообщения пользователя, совпадающий с сохранённой записью транскрипта. Отсутствует при вызовах команд, которые могут породить ноль или много сообщений.
• command_name: Имя команды, если промпт вызывает команду. Имена встроенных и поставляемых в комплекте команд, например compact или debug, передаются как есть; псевдонимы, например reset, передаются в том виде, в каком они введены, а не каноническим именем. Имена пользовательских команд, команд плагинов и MCP сводятся к custom или mcp, если не задано OTEL_LOG_TOOL_DETAILS=1
• command_source: Происхождение команды, если она есть: builtin, custom или mcp. Команды, предоставляемые плагинами, сообщаются как custom

​

Событие ответа ассистента

• Все стандартные атрибуты
• event.name: "assistant_response"
• event.timestamp: Метка времени ISO 8601
• event.sequence: счётчик процесса для упорядочивания событий, описанный в разделе Атрибуты корреляции событий
• response_length: Длина текста ответа в символах
• response: Текст ответа, усечённый до лимита содержимого (по умолчанию 60 КБ). По умолчанию заменяется на <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: ID API-запроса, описанный в разделе Атрибуты корреляции событий
• message.uuid: UUID последней записи ответа в транскрипте. Ответ API сохраняется как одна запись транскрипта на каждый блок содержимого; это последняя из них, от которой выстраивается цепочка parentUuid следующего хода.
• 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 с данными, собранными хуками.
• request_id: request_id ответа API, содержавшего этот вызов инструмента, чтобы вы могли связать вызов с событиями API этого ответа. Отсутствует, если у этого ответа не было ID запроса или если ни один ответ API не содержал этот вызов. Требуется Claude Code v2.1.310 или новее
• 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): идентификация коммита для успешного git commit, выполненного инструментом Bash или PowerShell. 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 включается даже при выключенном флаге — то же исключение для имён, заданных хостом, что и в Событии решения по инструменту. Параметры зависят от инструмента:
  • Для инструмента Bash: включает bash_command, full_command, timeout, description и dangerouslyDisableSandbox, а также git_commit_id и git_branch, когда команда git commit выполнена успешно. git_commit_id — полный SHA коммита, если коммит является HEAD рабочего каталога сессии, и сокращённый SHA git в остальных случаях. 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 символов усекаются, а общий объём данных ограничен ~4 тыс. символов. Применяется ко всем инструментам, включая инструменты 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: Количество токенов, использованных для создания кэша
• cache_creation_5m_tokens, cache_creation_1h_tokens: количество токенов, которые, согласно ответу API, были записаны в кэш с пятиминутным временем жизни кэша, и количество записанных с часовым временем жизни. Оба равны 0, если ответ API их не сообщает, даже когда cache_creation_tokens больше нуля. Требуется Claude Code v2.1.300 или новее
• request_id: ID API-запроса, например "req_011...", описанный в разделе Атрибуты корреляции событий.
• client_request_id: Сгенерированный клиентом UUID, отправляемый в заголовке запроса x-client-request-id; когда он присутствует, см. в таблице атрибутов корреляции событий
• speed: "fast" или "normal", указывает, был ли активен быстрый режим
• query_source: Подсистема, отправившая запрос, например "repl_main_thread", "compact" или имя субагента
• effort: Уровень effort, применённый к запросу: "low", "medium", "high", "xhigh" или "max". Отсутствует, если Claude Code не отправляет уровень effort, например для модели, которая не поддерживает effort.
• 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: Количество выполненных попыток, включая первоначальный запрос. Когда счёт начинается заново, описано в разделе Обнаружение исчерпания повторных попыток
• request_id: ID API-запроса, например "req_011...", описанный в разделе Атрибуты корреляции событий.
• client_request_id: Сгенерированный клиентом UUID, отправляемый в заголовке запроса x-client-request-id. Доступен, даже если сбой, например таймаут или ошибка подключения, так и не дал серверный request_id; когда он присутствует, см. в таблице атрибутов корреляции событий.
• speed: "fast" или "normal", указывает, был ли активен быстрый режим
• query_source: Подсистема, отправившая запрос, например "repl_main_thread", "compact" или имя субагента
• effort: Уровень effort, применённый к запросу. Отсутствует, если Claude Code не отправляет уровень effort, например для модели, которая не поддерживает effort.
• 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: ID API-запроса, например "req_011...", описанный в разделе Атрибуты корреляции событий.
• query_source: Подсистема, отправившая запрос, например "repl_main_thread", "compact" или имя субагента. Определения см. в api_request.
• speed: Либо "fast", когда активен быстрый режим, либо "normal"
• attempt: Номер повторной попытки. Первая попытка — 1.
• effort: Уровень effort, применённый к запросу. Отсутствует, если Claude Code не отправляет уровень effort, например для модели, которая не поддерживает effort.
• server_fallback_hop: true, когда серверный резервный вариант модели в API уже повторил этот отказ на другой модели, так что пользователь не увидел этот конкретный отказ. false, когда запрос завершился отказом. Один ход может сгенерировать как событие перехода с true, так и последующее итоговое событие с false, если резервная модель тоже отказывает.
• has_category: true, когда ответ API содержал stop_details.category со значением "cyber", "bio", "frontier_llm" или "reasoning_extraction". false, когда ответ не содержал категории или содержал значение вне этого набора. Отсутствует, когда server_fallback_hop равно true, поскольку блоки перехода не содержат stop_details.
• has_explanation: true, когда ответ API содержал stop_details.explanation, иначе false. Отсутствует, когда server_fallback_hop равно true.
• category: Значение stop_details.category из ответа API. Одно из значений "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: Параметры запроса Messages API в формате JSON, например системный промпт, сообщения и инструменты, усечённые до лимита содержимого (по умолчанию 60 КБ). Содержимое расширенного мышления в предыдущих ходах ассистента скрывается. Генерируется только во встроенном режиме (OTEL_LOG_RAW_API_BODIES=1).
• body_ref: Абсолютный путь к файлу <dir>/<uuid>.request.json, содержащему неусечённое тело. Генерируется только в файловом режиме (OTEL_LOG_RAW_API_BODIES=file:<dir>).
• body_length: Длина неусечённого тела. В байтах UTF-8 при OTEL_LOG_RAW_API_BODIES=file:<dir> или в кодовых единицах UTF-16 при =1
• 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: Ответ Messages API в формате JSON, включая id, блоки содержимого, использование и причину остановки, усечённый до лимита содержимого (по умолчанию 60 КБ). Содержимое расширенного мышления скрывается. Генерируется только во встроенном режиме (OTEL_LOG_RAW_API_BODIES=1).
• body_ref: Абсолютный путь к файлу <dir>/<request_id>.response.json, содержащему неусечённое тело. Генерируется только в файловом режиме (OTEL_LOG_RAW_API_BODIES=file:<dir>).
• body_length: Длина неусечённого тела. В байтах UTF-8 при OTEL_LOG_RAW_API_BODIES=file:<dir> или в кодовых единицах UTF-16 при =1
• body_truncated: "true", если произошло встроенное усечение. Отсутствует в файловом режиме и если усечения не было.
• model: Идентификатор модели
• query_source: Подсистема, отправившая запрос
• request_id: ID API-запроса, например "req_011...", описанный в разделе Атрибуты корреляции событий.
• request_body_id: request_body_id события api_request_body, на которое отвечает этот ответ. Требуется Claude Code v2.1.274 или новее
• message.id: ID сообщения, назначенный ответу API, — поле 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 с данными, собранными хуками.
• request_id: request_id ответа API, содержавшего этот вызов инструмента, чтобы вы могли связать вызов с событиями API этого ответа. Отсутствует, если у этого ответа не было ID запроса или если ни один ответ API не содержал этот вызов. Требуется Claude Code v2.1.310 или новее
• decision: Либо "accept", либо "reject"
• tool_source: Присутствует всегда. Происхождение инструмента в виде закрытого набора значений, заданных CLI:
  • "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
    • Активный режим разрешений
    • Классификатор авторежима, вердикт которого то же событие записывает в classifier_verdict
    • Разрешение на оставшуюся часть сессии, выданное при более раннем запросе разрешения в той же интерактивной сессии CLI
    • Изначальная безопасность инструмента
    Значение source не указывает, какой из этих источников сработал. Чтобы узнать, какой из них отклонил вызов, найдите событие безопасности с тем же tool_use_id и прочитайте его атрибуты category и rule_source. У некоторых отклонённых вызовов нет события безопасности. Claude Code также указывает "config", когда сам запрос разрешения завершается сбоем. Например, такой запрос завершается сбоем, когда обратный вызов canUseTool в Agent SDK или инструмент --permission-prompt-tool возвращает недопустимый результат либо когда входной поток закрывается, пока запрос ожидает ответа.
  • "hook": Решение вернул хук PreToolUse или PermissionRequest.
  • "user_permanent": Передаётся, когда пользователь выбрал «Yes, and don’t ask again for …» в запросе разрешения, что сохраняет правило разрешения в его личные настройки. В интерактивном CLI передаётся только для самого этого выбора; последующие вызовы, соответствующие сохранённому правилу, передают "config". В сессиях Agent SDK или неинтерактивных сессиях -p "user_permanent" передаётся как для первоначального выбора, так и для последующих совпадений с правилом. Рассматривается как принятие.
  • "user_temporary": Передаётся, когда пользователь выбрал «Yes» в запросе разрешения для однократного подтверждения либо выбрал вариант, предоставляющий доступ на оставшуюся часть сессии, в запросе на редактирование или чтение файла. В интерактивном CLI передаётся только для самого выбора; последующие вызовы, разрешённые этим разрешением в рамках сессии, передают "config". В сессиях Agent SDK или неинтерактивных сессиях -p "user_temporary" передаётся как для выбора, так и для последующих совпадений. Рассматривается как принятие.
  • "user_abort": Передаётся, когда пользователь закрыл запрос разрешения, не ответив. В сессиях Agent SDK и неинтерактивных сессиях -p сюда относится и прерывание хода, пока ожидает ответа запрос разрешения canUseTool или --permission-prompt-tool. Рассматривается как отклонение.
  • "user_reject": Передаётся, когда пользователь выбрал «No» в запросе. В интерактивном CLI передаётся только для самого этого выбора; вызовы, соответствующие правилу запрета в личных настройках пользователя, передают "config". В сессиях Agent SDK или неинтерактивных сессиях -p вызовы, соответствующие правилу запрета в личных настройках, передают "user_reject". Рассматривается как отклонение.
• classifier_verdict: Вердикт классификатора авторежима для вызова или причина, по которой Claude Code отклонил вызов, если вердикт не был получен. Требуется Claude Code v2.1.301 или новее
  • "allow": классификатор одобрил вызов
  • "block": классификатор заблокировал вызов. Проверка классификатором, завершившаяся сбоем на полпути, тоже может закончиться "block", поэтому частичный сбой классификатора может проявляться как увеличение числа блокировок, а не как "unavailable"
  • "no_verdict": проверка выполнилась, но не дала пригодного вердикта, поэтому Claude Code отклонил вызов. Отклонение не означает, что классификатор счёл вызов небезопасным
  • "unavailable": запрос к классификатору завершился сбоем, например из-за ограничения частоты запросов, таймаута или ошибки подключения, поэтому Claude Code отклонил вызов. При серверной проверке классификатором это значение также помечает вызов, отклонённый потому, что сервер не вернул вердикт безопасности
  Атрибут также появляется в вызовах режима планирования, когда классификатор проверяет команды в режиме планирования. Атрибут отсутствует в следующих случаях:
  • Вызов был решён правилом ра��решений на разрешение или запрет
  • Claude Code одобрил вызов в авторежиме, не обращаясь к классификатору
  • Пользователь ответил на запрос, который Claude Code показал после повторных блокировок
  • В запуске -p без --permission-prompt-tool Claude Code отклонил вызов после повторных блокировок, потому что некому было ответить на запрос. Такое событие сообщает decision как "reject" и source как "config"
• classifier_category (при OTEL_LOG_TOOL_DETAILS=1): Имя встроенного правила, которое назвал классификатор, заблокировав вызов, в нижнем регистре с подчёркиваниями, например "data_exfiltration" для правила Data Exfiltration. Требуется Claude Code v2.1.301 или новее. Атрибут присутствует, когда выполняются оба условия:
  • classifier_verdict равно "block"
  • Классификатор назвал ровно одно правило, и это правило встроенное, а не написанное вами
  До v2.1.302 атрибут также отсутствовал для любой блокировки, решение о которой приняла серверная проверка классификатором.
• permission_mode: Режим разрешений, активный в момент начала проверки разрешения для этого вызова: "default", "plan", "acceptEdits", "bypassPermissions", "dontAsk" или "auto". Ручной режим отображается как "default". Вызов субагента сообщает режим разрешений субагента, а не сессии. Требуется Claude Code v2.1.301 или новее
• tool_parameters (при OTEL_LOG_TOOL_DETAILS=1): Строка JSON с параметрами, специфичными для инструмента. Та же структура, что и в Событии результата инструмента, за исключением полей, появляющихся после выполнения, например git_commit_id. Значения могут отличаться от tool_result для принятого вызова, если решение о разрешении переписывает входные данные инструмента через updatedInput. Используйте этот атрибут, чтобы увидеть, какая команда была отклонена, когда decision равно "reject".
  • Для инструментов "sdk_host_builtin_mcp": mcp_server_name и mcp_tool_name включаются, даже когда OTEL_LOG_TOOL_DETAILS выключена, поскольку эти имена определяет хост-приложение; без них отклонённый вызов одного из этих встроенных серверов было бы невозможно атрибутировать в потоке по умолчанию. Для MCP-серверов, настроенных пользователем, tool_name события всегда равно буквальному "mcp_tool", а имена сервера и инструмента появляются только в tool_parameters при включённом флаге; для содержимого аргументов флаг требуется везде.
  • Для инструмента 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

1. parent_agent_id
2. agent_id
3. request_id
4. permission_mode
5. classifier_category
6. classifier_verdict

​

Событие безопасности

• Все стандартные атрибуты
• event.name: "safety_event"
• event.timestamp: Метка времени ISO 8601
• event.sequence: счётчик процесса для упорядочивания событий, описанный в разделе Атрибуты корреляции событий
• category: Проверка или результат, значение категории
• decision: "accept", "reject" или "sent_back", если хук заблокировал результат или завершение хода
• decision_source: Кто или что приняло решение: значение source из tool_decision или "other"
• reason_code: Причина проверки, например "rule:policySettings", "mode:dontAsk", "hook:PreToolUse", "classifier:auto-mode", "bashMiss:too-complex" или "unknown"
• reason_type: Тип причины проверки, например "rule", "subcommandResults", "mode", "hook", "classifier" или "asyncAgent"
• rule_source: Источник настроек для задействованного правила, например "policySettings", "userSettings", "projectSettings", "localSettings", "flagSettings", "cliArg" или "session"
• grant_scope: "once" или "session" для запроса, одобренного без сохранения правила в файл настроек
• circuit_breaker: Встроенная проверка безопасности, например "dangerousRemoval", "outsideReadsBlocked" или "claudeSettingsFile"
• classifier_category: При OTEL_LOG_TOOL_DETAILS=1 — встроенное правило, стоящее за блокировкой в авторежиме, например "data_exfiltration"
• hook_event: "pre_tool_use" для хука PreToolUse или "post_tool_use", "post_tool_use_failure", "stop" либо "subagent_stop" в событиях "hook_review"
• tool_class: "bash" для Bash и Monitor, "powershell", "file" для Read, Edit, Write, NotebookEdit, Glob и Grep, "web" для WebFetch и WebSearch, "mcp" или "other"
• tool_name: Имя инструмента, например "Bash" для встроенного инструмента, либо "mcp_tool", "skill_tool", "dynamic_tool" или "other_tool"
• tool_source: "builtin", "mcp" или "sdk_host_builtin_mcp", как в tool_decision
• permission_mode: Режим разрешений вызова на момент проверки: "default", "plan", "acceptEdits", "bypassPermissions", "dontAsk" или "auto"
• tool_use_id: ID вызова, как в tool_decision и tool_result
• sandbox_violation_count: Сколько различных подключений или запросов от команды вызова отклонил сетевой прокси песочницы, от "0" до "20" в виде строки. Отказы учитываются для команды в песочнице, завершившейся на переднем плане
• sandbox_enabled: "true", если изоляция в песочнице включена для сессии, иначе "false"

{
  "event.name": "safety_event",
  "category": "managed_policy",
  "decision": "reject",
  "decision_source": "config",
  "reason_code": "rule:policySettings",
  "rule_source": "policySettings",
  "tool_class": "bash",
  "tool_name": "Bash",
  "tool_source": "builtin",
  "permission_mode": "default",
  "tool_use_id": "toolu_01ABC123...",
  "sandbox_violation_count": "0",
  "sandbox_enabled": "false"
}

• Вызов, одобренный в ответ на запрос без категории
• Вызов, который callback canUseTool или инструмент --permission-prompt-tool одобрил в ответ на запрос, требовавшийся только хуку PreToolUse
• Вызов AskUserQuestion или ExitPlanMode, отклонённый или нет

​

Событие изменения режима разрешений

• Все стандартные атрибуты
• 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". Отсутствует для некоторых изменений, например когда SDK задаёт режим разрешений через setPermissionMode()

​

Событие аутентификации

• Все стандартные атрибуты
• 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): Имя плагина, предоставляющего сервер. Для сторонних плагинов это буквальная строка "third-party", если не задано OTEL_LOG_TOOL_DETAILS=1; это защищает имена сторонних плагинов от попадания в логи по умолчанию. Плагины из официальных источников 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: Код errno Node.js, например "ENOENT", если он присутствует в ошибке

​

Событие установки плагина

• Все стандартные атрибуты
• event.name: "plugin_installed"
• event.timestamp: Метка времени ISO 8601
• event.sequence: счётчик процесса для упорядочивания событий, описанный в разделе Атрибуты корреляции событий
• marketplace.is_official: "true", если маркетплейс является официальным маркетплейсом Anthropic, иначе "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: имя плагина. Для плагинов вне официального маркетплейса и встроенного комплекта значение равно "third-party", если не задано OTEL_LOG_TOOL_DETAILS=1
• marketplace.name: маркетплейс, из которого установлен плагин, если он известен. Заменяется на "third-party" при том же условии, что и plugin.name
• 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" означает, что плагин задан как обязательный или автоматически устанавливаемый для вашей организации в Organization settings > Plugins & skills. До 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: true, когда хост SDK управляет подключениями MCP этого плагина и Claude Code пропустил чтение конфигурации MCP-серверов плагина, иначе false
• skill_path_count: количество каталогов скиллов, объявленных плагином
• command_path_count: количество каталогов команд, объявленных плагином
• agent_path_count: количество каталогов агентов, объявленных плагином
• safe_mode: "true", если сессия запущена с --safe-mode, иначе "false". В безопасном режиме это событие сообщает только настроенную инвентаризацию; команды, скиллы, хуки и MCP-серверы плагина не загружаются. Требуется Claude Code v2.1.169 или новее

​

Событие активации скилла

• Все стандартные атрибуты
• event.name: "skill_activated"
• event.timestamp: Метка времени ISO 8601
• event.sequence: счётчик процесса для упорядочивания событий, описанный в разделе Атрибуты корреляции событий
• skill.name: Имя скилла. Для скиллов, определённых пользователем, и скиллов сторонних плагинов значение равно заполнителю "custom_skill", если не задано OTEL_LOG_TOOL_DETAILS=1
• invocation_trigger: Способ вызова скилла ("user-slash", "claude-proactive" или "nested-skill")
• skill.source: Откуда загружен скилл (например, "bundled", "userSettings", "projectSettings", "plugin")
• skill.kind: "workflow", если скилл является скиллом 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: "true", если сессия запущена с --safe-mode, иначе "false". Требуется Claude Code v2.1.169 или новее
• hook_matcher (при OTEL_LOG_TOOL_DETAILS=1): строка matcher из конфигурации хука, если она задана
• plugin.name (когда hook_source равно "pluginHook"): имя плагина, предоставившего хук. Для плагинов вне официального маркетплейса и встроенного комплекта значение равно "third-party", если не задано OTEL_LOG_TOOL_DETAILS=1
• 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: Полное имя хука, включая matcher, например "PreToolUse:Write"
• num_hooks: Количество подходящих команд хуков
• managed_only: "true", если разрешены только хуки управляемой политики
• hook_source: "policySettings" или "merged"
• safe_mode: "true", если сессия запущена с --safe-mode, иначе "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: Полное имя хука, включая matcher
• 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: "true", если сессия запущена с --safe-mode, иначе "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", или если trigger равно "auto" для сжатия при простое в интерактивной сессии терминала. Автосжатие может подготовить сводку в фоновом режиме до заполнения контекстного окна, и этот атрибут фиксирует, была ли при сжатии повторно использована подготовленная сводка. "hit" означает, что она была использована повторно; "miss_custom_instructions", "miss_hook" и "miss_not_ready" указывают причину, по которой вместо этого была вычислена новая сводка

​

Событие завершения субагента

• Все стандартные атрибуты
• event.name: "subagent_completed"
• event.timestamp: временная метка в формате ISO 8601
• event.sequence: счётчик в пределах процесса для упор��дочивания событий, описанный в разделе Атрибуты корреляции событий
• agent_type: тип субагента. Имена встроенных агентов и агентов из плагинов официального маркетплейса отображаются как есть; имена других агентов заменяются на "custom", если не задано OTEL_LOG_TOOL_DETAILS=1
• agent.source: откуда взято определение агента: built-in, plugin или источник настроек, определивший пользовательского агента, например userSettings или projectSettings
• is_built_in: является ли субагент встроенным типом агента
• is_async: выполнялся ли субагент в фоновом режиме
• total_tokens: объём токенов последнего API-запроса субагента: входные токены, токены создания кэша, чтения кэша и выходные токены этого одного запроса, что примерно соответствует размеру контекста субагента на момент завершения. Это не сумма за весь запуск
• total_tool_uses: количество вызовов инструментов, сделанных субагентом за весь запуск
• duration_ms: время выполнения в миллисекундах
• model: модель, на которой было определено выполнять субагента
• final_model: модель, сформировавшая финальный ответ субагента; отличается от model после смены модели в ходе выполнения, например при переключении на резервный вариант
• model_swapped: обслуживала ли запросы субагента более чем одна модель
• plugin_id_hash, plugin.name: присутствуют для агентов, предоставленных плагинами. Имена плагинов официального маркетплейса отображаются как есть; имена других плагинов заменяются на "third-party", если не задано OTEL_LOG_TOOL_DETAILS=1

​

Событие опроса обратной связи

• Все стандартные атрибуты
• event.name: "feedback_survey"
• event.timestamp: временная метка в формате ISO 8601
• event.sequence: счётчик в пределах процесса для упорядочивания событий, описанный в разделе Атрибуты корреляции событий
• event_type: событие жизненного цикла опроса, например "appeared", "responded" или "transcript_prompt_appeared"
• appearance_id: уникальный идентификатор, связывающий события, сгенерированные для одного экземпляра опроса
• survey_type: какой опрос сгенерировал событие. "session" — это промпт с оценкой «How is Claude doing?»
• response: выбор пользователя в событиях responded
• enabled_via_override: true, когда задана переменная CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL. Передаётся как Boolean, а не как строка. Присутствует в событиях опроса session. Фильтруйте по этому атрибуту, чтобы убедиться, что переопределение применено на всём парке машин

​

Событие очистки по сроку хранения

• Все стандартные атрибуты
• event.name: "retention_sweep"
• event.timestamp: временная метка в формате ISO 8601
• event.sequence: счётчик в пределах процесса для упорядочивания событий, описанный в разделе Атрибуты корреляции событий
• result: "complete", если очистка выполнена, "skipped", если Claude Code её приостановил
• period_days: значение cleanupPeriodDays из объединённых настроек в днях или 30, если ни один источник его не задаёт. В пропущенных событиях — значение, которое использовала бы очистка, вычисленное из источников настроек, которые Claude Code смог прочитать
• used_default: "true", если ни один доступный для чтения источник настроек не задаёт cleanupPeriodDays, иначе "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 задан явно, поэтому использование значения по умолчанию могло бы удалить или сохранить файлы вопреки этой настройке
  • "remote_settings_unknowable": сессия на вкладке Code в Claude Desktop в стороннем развёртывании запросила серверные управляемые настройки. Она не получила пригодного ответа, поэтому cleanupPeriodDays может иметь значение, которое Claude Code не видит
• transcripts_deleted: количество транскриптов сессий — файлов верхнего уровня ~/.claude/projects/*/*.jsonl, — удалённых очисткой
• transcripts_exempted_desktop: количество транскриптов с истёкшим сроком хранения, которые очистка сохранила согласно правилу Claude Desktop и Cowork. Они не учитываются в files_past_cutoff. Требуется Claude Code v2.1.248 или новее
• session_files_deleted: количество артефактов, удалённых очисткой файлов сессий: транскрипты плюс сопутствующие файлы каждой сессии, такие как sidecar-файлы, записи и результаты инструментов
• artifacts_deleted: общее количество элементов, удалённых очисткой во всех охватываемых ею каталогах данных, включая файлы сессий. Некоторые очистки считают целое удалённое дерево каталогов одним элементом, а несколько проходов очистки не учитываются в счётчике, поэтому рассматривайте значение как нижнюю границу, а не как точное количество файлов
• files_retained_fresh: файлы, проверенные и оставленные на месте, поскольку срок их хранения ещё не истёк. Их учитывают только пофайловые очистки, поэтому значение является нижней границей; ненулевое значение — нормальное устойчивое состояние
• files_past_cutoff: файлы старше срока хранения, которые очистке не удалось удалить, например из-за ошибки прав доступа или из-за того, что файл открыт. Счётчик также включает каждую устаревшую папку, найденную очисткой в skills/synced/ или plugins/synced/, независимо от того, переместила ли она папку в корзину. Не считая этих папок, значение больше нуля означает, что файлы пережили настроенный срок хранения; ноль не доказывает обратного, поскольку неудачное удаление целого каталога учитывается в error_count
• error_count: количество ошибок, возникших у очистки при получении списка или удалении файлов

​

Событие определения управляемых настроек

• Задайте её в блоке env управляемых настроек, пользовательских настроек или --settings, либо в окружении, в котором вы запускаете 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 не может проверить вход в организацию или принудительное применен��е провайдера
  • "provider_not_allowed": сессия использовала бы API-провайдера или отправляла бы трафик провайдера на хост, которые не разрешены управляемым списком allowedProviders. Требуется Claude Code v2.1.285 или новее
  • "consent_rejected": пользователь отклонил диалоговое окно подтверждения безопасности для серверных управляемых настроек
  • "force_refresh_failed": не удалось получить настройки, которые требует forceRemoteSettingsRefresh
  • "gateway_rejected": шлюз Claude apps ответил на загрузку управляемых настроек кодом HTTP 403
  • "version_below_minimum": эта версия Claude Code ниже requiredMinimumVersion или выше requiredMaximumVersion
  • "_OTHER": загрузка управляемых настроек шлюза Claude apps завершилась ошибкой по другой причине
• managed_settings.sources: каждый управляемый источник, который предоставляет хотя бы один ключ политики, в порядке убывания приоритета, включая источники, ключи которых не вступают в силу при first-wins. Возможные значения: "remote", "plist" или "hklm" для политики MDM или уровня ОС, "file" для файлов управляемых настроек и дополнительных файлов, "parent", когда настройки предоставляет встраивающий хост, и "hkcu" для значения реестра Windows HKCU, когда Claude Code его читает. Источник, который содержит только управляющие ключи или который Claude Code не смог прочитать, не указывается. Передаётся как массив строк; пуст, если ни один управляемый источник не предоставляет ключ политики
• managed_settings.source_behavior: значение managedSourcesBehavior, прочитанное Claude Code: "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: "policyHelper", когда Claude Code выбрал 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 и идентификаторы плагинов, экспортируются как есть. Настройка, записи которой схема не типизирует, например vimInsertModeRemaps, экспортируется как единое "[REDACTED]", а sandbox.ignoreViolations экспортируется как список его списков путей без шаблонов команд
  • Список сохраняет свою длину, а каждая запись редактируется по тем же правилам
  • Правило permissions.allow, permissions.deny или permissions.ask экспортируется как имя инструмента с отредактированным содержимым, например Read([REDACTED]), если инструмент встроен в эту версию Claude Code или является ссылкой mcp__, например mcp__jira__create_issue. Любое другое правило экспортируется как "[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 обрезает значение до 8 КБ в UTF-8, и обрезанное значение не является корректным JSON
• managed_settings.settings_truncated (когда присутствует managed_settings.settings): true, если Claude Code обрезал managed_settings.settings до 8 КБ, иначе false. Передаётся как Boolean, а не как строка

​

Интерпретация данных метрик и событий

​

Мониторинг использования

​

Мониторинг затрат

• Отслеживанием тенденций использования по командам или отдельным лицам
• Выявлением сеансов с высоким использованием для оптимизации
• Атрибуцией расходов конкретным навыкам, плагинам или типам подагентов через атрибуты skill.name, plugin.name и agent.name

​

Оповещения и сегментация

• Скачки затрат
• Необычное потребление токенов
• Высокий объем сеансов от конкретных пользователей

​

Обнаружение исчерпания повторных попыток

​

Анализ событий

• Наиболее часто используемых инструментов
• Показателей успеха инструментов
• Среднего времени выполнения инструментов
• Паттернов ошибок по типам инструментов

​

Сопоставление входных токенов с семантическими соглашениями OpenTelemetry GenAI

• input_tokens в спане claude_code.llm_request и событии api_request
• Тип "input" метрики claude_code.token.usage

• Из спана или события: сложите input_tokens, cache_read_tokens и cache_creation_tokens
• Из метрики claude_code.token.usage: сложите её типы "input", "cacheRead" и "cacheCreation"

• cache_read_tokens соответствует gen_ai.usage.cache_read.input_tokens
• cache_creation_tokens соответствует gen_ai.usage.cache_write.input_tokens. В более старых версиях соглашений атрибут записи в кэш называется gen_ai.usage.cache_creation.input_tokens, поэтому используйте имя, которое ожидает ваш бэкенд.

​

Аудит событий безопасности

​

Атрибуция действий пользователям

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, он также сохраняет пару mcp_server_name/mcp_tool_name внутри tool_parameters — то же исключение для данных, заданных хостом, что и у tool_decision
• tool_decision: сохраняет tool_source и tool_name, заменённый на буквальное значение "mcp_tool" для пользовательских серверов, опускает содержимое аргументов. Для встроенных серверов Claude Desktop в сессиях, которыми владеет Claude Desktop, он также сохраняет пару mcp_server_name/mcp_tool_name внутри tool_parameters
• mcp_server_connection: опускает server_name и сообщение об ошибке, но сохраняет is_plugin, plugin_id_hash и plugin.name, с именами плагинов, не относящихся к Anthropic, заменёнными на буквальное значение "third-party", поэтому серверы, предоставляемые плагинами, остаются различимыми без подробного логирования

​

Сопоставление вопросов безопасности с событиями

​

Сопоставление путей утечки данных с управляемыми настройками и событиями

• allowedHttpHookUrls: записи объединяются между файлами настроек, поэтому разработчик может дополнить пустой управляемый список. Какие хуки выполняются, определяет allowManagedHooksOnly
• managed-mcp.json: чтобы отключить MCP, см. Полное отключение MCP. Чтобы убедиться, что Claude Code читает файл, см. Проверка конфигурации
• События хуков: Claude Code записывает в лог hook_execution_start и hook_execution_complete один раз на событие хука, охватывая все подходящие хуки. Сам по себе OTEL_LOG_TOOL_DETAILS=1 не записывает URL HTTP-хука. Конфигурация хука появляется только в hook_definitions, для чего также нужна подробная бета-трассировка

​

Проверка очистки по сроку хранения

• Никто не запускает Claude Code: очистка не выполняется, и машина хранит свои данные до следующего запуска
• Сессия остаётся открытой: Claude Code выполняет очистку не более одного раза за сессию
• Сессия завершается рано: очистка, не завершившаяся к моменту выхода из сессии, ничего не отправляет, как и очистка, остановившаяся из-за непредвиденной ошибки

​

Отправка событий в 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"
  }
}

​

Рассмотрения бэкенда

​

Бэкенды для метрик

• Базы данных временных рядов: Расчеты скорости, агрегированные метрики
• Колончатые хранилища: Сложные запросы, анализ уникальных пользователей
• Полнофункциональные платформы наблюдаемости: Продвинутые запросы, визуализация, оповещения

​

Бэкенды для событий и логов

• Системы агрегации логов: Полнотекстовый поиск, анализ логов
• Колончатые хранилища: Анализ структурированных событий
• Полнофункциональные платформы наблюдаемости: Корреляция между метриками и событиями

​

Бэкенды для трассировок

• Системы распределенной трассировки: Визуализация span, водопады запросов, анализ задержки
• Полнофункциональные платформы наблюдаемости: Поиск трассировок и корреляция с метриками и логами

​

Информация о сервисе

• service.name: claude-code для сессий терминала, claude-code-desktop для локальных сессий, запущенных с вкладки Code в приложении Claude Desktop
• service.version: Текущая версия Claude Code или версия приложения Desktop для локальных сессий вкладки Code
• 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 и о том, как её отключить, см. в разделе Data usage
• Содержимое файлов в исходном виде и фрагменты кода не включа��тся в метрики или события. Span трассировок — это отдельный путь данных: см. пункт OTEL_LOG_TOOL_CONTENT ниже
• При аутентификации через OAuth user.email включается в атрибуты телеметрии, отправляется только на endpoint OTel, который вы настраиваете, никогда на Anthropic. Если это вызывает беспокойство для вашей организации, работайте с вашим бэкендом телеметрии для фильтрации или скрытия этого поля
• Содержимое пользовательского промпта не собирается по умолчанию. Записывается только длина промпта. Чтобы включить содержимое промпта, установите OTEL_LOG_USER_PROMPTS=1. Когда включено:
  • События user_prompt содержат текст промпта в двух атрибутах: prompt и prompt_text. Если вы удаляете или маскируете текст промпта события по имени атрибута в вашем коллекторе, укажите в правиле оба атрибута Этот процессор attributes OpenTelemetry Collector удаляет оба атрибута в конвейерах, в которых он указан:
    processors:
      attributes/drop-prompt-text:
        actions:
          - key: prompt
            action: delete
          - key: prompt_text
            action: delete
    
  • При включённой трассировке span claude_code.interaction содержит текст промпта в своём атрибуте user_prompt
  • При детальной бета-трассировке span также содержат новые пользовательские сообщения, результаты инстр��ментов и системные напоминания, отправляемые с каждым запросом, текст системного промпта и выходные данные модели. В разделе Атрибуты содержимого при детальной бета-трассировке перечислен каждый атрибут. Событие claude_code.system_prompt содержит полный системный промпт
• Текст ответа помощника не собирается по умолчанию. Записывается только длина ответа. Чтобы включить текст ответа, установите OTEL_LOG_ASSISTANT_RESPONSES=1. Как и все данные OpenTelemetry из Claude Code, текст ответа отправляется только на эндпоинт OTel, который вы настраиваете, никогда на Anthropic. Когда эта переменная не установлена, OTEL_LOG_USER_PROMPTS используется как резервный вариант, поэтому установите OTEL_LOG_ASSISTANT_RESPONSES=0, если вы хотите получать в событиях содержимое промпта без содержимого ответа. При детальной бета-трассировке span claude_code.llm_request всё равно содержит выходные данные модели в response.model_output, который управляется OTEL_LOG_USER_PROMPTS, а не этой переменной
• Аргументы входных данных инструмента и параметры не логируются по умолчанию. Чтобы включить их, установите OTEL_LOG_TOOL_DETAILS=1. Для встроенных серверов Claude Desktop в сессиях, которыми владеет Claude Desktop, tool_decision и tool_result содержат пару mcp_server_name/mcp_tool_name, имена, созданные хостом, а не содержимое аргументов, даже с отключённым флагом. Эти данные отправляются только на эндпоинт OTEL, который вы настраиваете, никогда на Anthropic. Аргументы могут по-прежнему содержать конфиденциальные значения, поэтому настройте ваш бэкенд телеметрии для фильтрации или скрытия этих атрибутов по мере необходимости. Когда включено:
  • События tool_result и tool_decision включают атрибут tool_parameters с командами Bash, именами MCP-сервера и инструмента и именами скиллов. Поля, такие как full_command, выдаются неусеченными
  • События tool_result дополнительно включают атрибут tool_input с путями к файлам, URL-адресами, шаблонами поиска и другими аргументами. Отдельные значения более 512 символов усекаются, и общее количество ограничено примерно 4 K символами
  • События user_prompt включают буквальное command_name для пользовательских команд, команд плагинов и команд MCP
  • Счётчики стоимости и токенов и события api_request, api_error и api_refusal содержат реальные имена агента, скилла, плагина, MCP-сервера и инструмента в их атрибутах атрибуции
  • Span claude_code.tool содержит атрибуты, полученные из входных данных, такие как file_path. При детальной бета-трассировке он также содержит атрибут tool_input
• Содержимое инструмента не логируется в span трассировок по умолчанию. Чтобы включить его, установите OTEL_LOG_TOOL_CONTENT=1. Span claude_code.tool затем содержит событие span tool.output с содержимым файлов в исходном виде, выходными данными команды Bash и тем, что возвращают MCP инструменты, WebFetch и WebSearch, усеченными на лимит содержимого (60 КБ по умолчанию) на атрибут. Результаты от MCP инструментов, WebFetch и WebSearch требуют Claude Code v2.1.283 или позже. Содержимое инструмента также достигает span через new_context, чей gate отличается для каждого span. Настройте ваш бэкенд телеметрии для фильтрации или скрытия этих атрибутов по мере необходимости
• Тела запроса и ответа Anthropic Messages API в исходном виде не логируются по умолчанию. Чтобы включить их, установите OTEL_LOG_RAW_API_BODIES в вашей оболочке, пользовательских параметрах или управляемых параметрах. Это игнорируется в project and local settings. Тела содержат полную историю разговора, включая системную подсказку, каждый предыдущий ход пользователя и помощника, и результаты инструментов, поэтому включение этого подразумевает согласие со всем, что раскрыли бы другие флаги содержимого OTEL_LOG_*. Claude Code всегда скрывает содержимое расширенного мышления Claude из этих тел, независимо от других параметров. Значение, которое вы установите, определяет, как Claude Code доставляет тела:
  • С =1, Claude Code выдает события логов api_request_body и api_response_body для каждого вызова API. Атрибут body событий содержит JSON-сериализованную нагрузку, усеченную на лимит содержимого (60 КБ по умолчанию)
  • С =file:<dir>, Claude Code записывает неусеченные тела в файлы .request.json и .response.json в этом каталоге, и события содержат путь body_ref вместо встроенного тела. Отправьте каталог с коллектором логов или sidecar, а не через поток телеметрии. Для каждого успешного ответа Claude Code также добавляет одну строку в файл index.jsonl в этом каталоге, связывая файл ответа с файлом запроса, который его создал, и с сообщением транскрипта, которым он стал. Каждая строка не содержит содержимого сообщения, и раздел API response body event перечисляет его поля. Файл индекса требует Claude Code v2.1.274 или позже

​

Мониторинг Claude Code на Amazon Bedrock