Мониторинг

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

​

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

# 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. Для отладки: сократить интервалы экспорта
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"
  }
}

​

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

​

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

​

Аутентификация 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
    └── (инструмент Task) spans claude_code.llm_request / claude_code.tool подагента

​

Атрибуты span

​

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

​

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

{
  "otelHeadersHelper": "/bin/generate_opentelemetry_headers.sh"
}

​

Требования к скрипту

#!/bin/bash
# Пример: несколько заголовков
echo "{\"Authorization\": \"Bearer $(get-token.sh)\", \"X-API-Key\": \"$(get-api-key.sh)\"}"

​

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

​

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

# Добавить пользовательские атрибуты для идентификации команды
export OTEL_RESOURCE_ATTRIBUTES="department=engineering,team.id=platform,cost_center=eng-123"

• Фильтровать метрики по команде или отделу
• Отслеживать затраты по центру затрат
• Создавать панели мониторинга для конкретных команд
• Настраивать оповещения для конкретных команд

# ❌ Недопустимо - содержит пробелы
export OTEL_RESOURCE_ATTRIBUTES="org.name=John's Organization"

# ✅ Допустимо - используйте подчеркивания или camelCase вместо этого
export OTEL_RESOURCE_ATTRIBUTES="org.name=Johns_Organization"
export OTEL_RESOURCE_ATTRIBUTES="org.name=JohnsOrganization"

# ✅ Допустимо - закодируйте специальные символы в процентах, если необходимо
export OTEL_RESOURCE_ATTRIBUTES="org.name=John%27s%20Organization"

​

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

# Отладка консоли (интервалы 1 секунда)
export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=console
export OTEL_METRIC_EXPORT_INTERVAL=1000

# OTLP/gRPC
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

# Prometheus
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

# Разные endpoints/бэкенды для метрик и логов
export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=otlp
export OTEL_LOGS_EXPORTER=otlp
export OTEL_EXPORTER_OTLP_METRICS_PROTOCOL=http/protobuf
export OTEL_EXPORTER_OTLP_METRICS_ENDPOINT=http://metrics.example.com:4318
export OTEL_EXPORTER_OTLP_LOGS_PROTOCOL=grpc
export OTEL_EXPORTER_OTLP_LOGS_ENDPOINT=http://logs.example.com:4317

# Только метрики (без событий/логов)
export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=otlp
export OTEL_EXPORTER_OTLP_PROTOCOL=grpc
export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317

# Только события/логи (без метрик)
export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_LOGS_EXPORTER=otlp
export OTEL_EXPORTER_OTLP_PROTOCOL=grpc
export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317

​

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

​

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

• prompt.id: UUID, коррелирующий пользовательскую подсказку со всеми последующими событиями до следующей подсказки. См. Атрибуты корреляции событий.
• workspace.host_paths: каталоги рабочей области хоста, выбранные в приложении для рабочего стола, как массив строк

​

Метрики

​

Детали метрик

​

Счетчик сеансов

• Все стандартные атрибуты
• start_type: Как был запущен сеанс. Один из "fresh", "resume" или "continue"

​

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

• Все стандартные атрибуты
• type: ("added", "removed")

​

Счетчик pull request

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

​

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

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

​

Счетчик затрат

• Все стандартные атрибуты
• model: Идентификатор модели (например, “claude-sonnet-4-6”)
• query_source: Категория подсистемы, которая выдала запрос. Один из "main", "subagent" или "auxiliary"
• speed: "fast" когда запрос использовал быстрый режим. Отсутствует в противном случае
• effort: Уровень усилий, применяемый к запросу: "low", "medium", "high", "xhigh" или "max". Отсутствует, когда модель не поддерживает усилия.
• agent.name: Тип подагента, который выдал запрос. Встроенные имена агентов и агенты из официальных плагинов маркетплейса появляются как есть. Другие определяемые пользователем имена агентов заменяются на "custom". Отсутствует, когда запрос не был выдан именованным типом подагента.
• skill.name: Навык, активный для запроса, установленный инструментом Skill, командой / или унаследованный порожденным подагентом. Встроенные, поставляемые, определяемые пользователем и навыки плагинов официального маркетплейса появляются как есть. Навыки плагинов третьих сторон заменяются на "third-party". Отсутствует, когда нет активного навыка.
• plugin.name: Владельцы плагина, когда активный навык или подагент предоставляются плагином. Имена плагинов официального маркетплейса появляются как есть. Имена плагинов третьих сторон заменяются на "third-party". Отсутствует, когда ни навык, ни подагент не имеют владельца плагина.
• marketplace.name: Маркетплейс, из которого был установлен владельцы плагин. Выдается только для плагинов официального маркетплейса. Отсутствует в противном случае.

​

Счетчик токенов

• Все стандартные атрибуты
• type: ("input", "output", "cacheRead", "cacheCreation")
• model: Идентификатор модели (например, “claude-sonnet-4-6”)
• query_source: Категория подсистемы, которая выдала запрос. Один из "main", "subagent" или "auxiliary"
• speed: "fast" когда запрос использовал быстрый режим. Отсутствует в противном случае
• effort: Уровень усилий, применяемый к запросу. Подробности см. в разделе Счетчик затрат.
• agent.name, skill.name, plugin.name, marketplace.name: Атрибуция навыка, плагина и агента для запроса. Определения и поведение редактирования см. в разделе Счетчик затрат.

​

Счетчик решений инструмента редактирования кода

• Все стандартные атрибуты
• 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" для выполнения инструментов и ответов AI

​

События

​

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

​

Событие пользовательской подсказки

• Все стандартные атрибуты
• event.name: "user_prompt"
• event.timestamp: Временная метка ISO 8601
• event.sequence: монотонно возрастающий счетчик для упорядочивания событий в сеансе
• prompt_length: Длина подсказки
• prompt: Содержимое подсказки (скрыто по умолчанию, включите с помощью OTEL_LOG_USER_PROMPTS=1)
• command_name: Имя команды, когда подсказка вызывает одну. Встроенные и поставляемые имена команд, такие как compact или debug, выдаются как есть; псевдонимы, такие как reset, выдаются как введено, а не как каноническое имя. Пользовательские, плагин и MCP имена команд сворачиваются в custom или mcp, если не установлен OTEL_LOG_TOOL_DETAILS=1
• command_source: Происхождение команды, когда присутствует: builtin, custom или mcp. Команды, предоставляемые плагинами, сообщают как custom

​

Событие результата инструмента

• Все стандартные атрибуты
• event.name: "tool_result"
• event.timestamp: Временная метка ISO 8601
• event.sequence: монотонно возрастающий счетчик для упорядочивания событий в сеансе
• tool_name: Имя инструмента
• tool_use_id: Уникальный идентификатор для этого вызова инструмента. Совпадает с tool_use_id, переданным в hooks, позволяя корреляцию между событиями OTel и данными, захваченными hooks.
• success: "true" или "false"
• duration_ms: Время выполнения в миллисекундах
• error_type: Строка категории ошибки при сбое инструмента, такая как "Error:ENOENT" или "ShellError"
• error (когда OTEL_LOG_TOOL_DETAILS=1): Полное сообщение об ошибке при сбое инструмента
• decision_type: Либо "accept", либо "reject"
• 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)
• tool_parameters (когда OTEL_LOG_TOOL_DETAILS=1): JSON строка, содержащая параметры, специфичные для инструмента:
  • Для инструмента Bash: включает bash_command, full_command, timeout, description, dangerouslyDisableSandbox и git_commit_id (SHA коммита, когда команда git commit успешна)
  • Для инструментов MCP: включает mcp_server_name, mcp_tool_name
  • Для инструмента Skill: включает skill_name
  • Для инструмента Task: включает subagent_type
• tool_input (когда OTEL_LOG_TOOL_DETAILS=1): JSON-сериализованные аргументы инструмента. Отдельные значения более 512 символов усекаются, и полная нагрузка ограничена примерно 4 K символами. Применяется ко всем инструментам, включая инструменты MCP.

​

Событие запроса API

• Все стандартные атрибуты
• event.name: "api_request"
• event.timestamp: Временная метка ISO 8601
• event.sequence: монотонно возрастающий счетчик для упорядочивания событий в сеансе
• model: Используемая модель (например, “claude-sonnet-4-6”)
• cost_usd: Приблизительная стоимость в USD
• duration_ms: Длительность запроса в миллисекундах
• input_tokens: Количество входных токенов
• output_tokens: Количество выходных токенов
• cache_read_tokens: Количество токенов, прочитанных из кэша
• cache_creation_tokens: Количество токенов, использованных для создания кэша
• request_id: ID запроса Anthropic API из заголовка ответа request-id, такой как "req_011...". Присутствует только, когда API возвращает его.
• speed: "fast" или "normal", указывающий, был ли активен быстрый режим
• query_source: Подсистема, которая выдала запрос, такая как "repl_main_thread", "compact" или имя подагента
• effort: Уровень усилий, применяемый к запросу: "low", "medium", "high", "xhigh" или "max". Отсутствует, когда модель не поддерживает усилия.

​

Событие ошибки API

• Все стандартные атрибуты
• event.name: "api_error"
• event.timestamp: Временная метка ISO 8601
• event.sequence: монотонно возрастающий счетчик для упорядочивания событий в сеансе
• model: Используемая модель (например, “claude-sonnet-4-6”)
• error: Сообщение об ошибке
• status_code: HTTP код состояния в виде числа. Отсутствует для ошибок, не связанных с HTTP, таких как сбои соединения.
• duration_ms: Длительность запроса в миллисекундах
• attempt: Общее количество попыток, включая исходный запрос (1 означает, что повторных попыток не было)
• request_id: ID запроса Anthropic API из заголовка ответа request-id, такой как "req_011...". Присутствует только, когда API возвращает его.
• speed: "fast" или "normal", указывающий, был ли активен быстрый режим
• query_source: Подсистема, которая выдала запрос, такая как "repl_main_thread", "compact" или имя подагента
• effort: Уровень усилий, применяемый к запросу. Отсутствует, когда модель не поддерживает усилия.

​

Событие тела запроса API

• Все стандартные атрибуты
• event.name: "api_request_body"
• event.timestamp: Временная метка ISO 8601
• event.sequence: монотонно возрастающий счетчик для упорядочивания событий в сеансе
• body: JSON-сериализованные параметры запроса Messages API (системная подсказка, сообщения, инструменты и т.д.), усеченные на 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")

​

Событие тела ответа API

• Все стандартные атрибуты
• event.name: "api_response_body"
• event.timestamp: Временная метка ISO 8601
• event.sequence: монотонно возрастающий счетчик для упорядочивания событий в сеансе
• body: JSON-сериализованный ответ Messages API (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 запроса Anthropic API из заголовка ответа request-id, такой как "req_011...". Присутствует только, когда API возвращает его.

​

Событие решения инструмента

• Все стандартные атрибуты
• event.name: "tool_decision"
• event.timestamp: Временная метка ISO 8601
• event.sequence: монотонно возрастающий счетчик для упорядочивания событий в сеансе
• tool_name: Имя инструмента (например, “Read”, “Edit”, “Write”, “NotebookEdit”)
• tool_use_id: Уникальный идентификатор для этого вызова инструмента. Совпадает с tool_use_id, переданным в hooks, позволяя корреляцию между событиями OTel и данными, захваченными hooks.
• decision: Либо "accept", либо "reject"
• source: Источник решения:
  • "config": Решено автоматически без запроса, на основе параметров проекта, корпоративной управляемой политики, флагов --allowedTools или --disallowedTools, активного режима разрешений или потому что инструмент по своей природе безопасен. Событие не указывает, какой из этих источников совпал.
  • "hook": Hook PreToolUse или PermissionRequest вернул решение.
  • "user_permanent": Выдается, когда пользователь выбрал “Да, и больше не спрашивать для …” при запросе разрешения, что сохраняет правило разрешения в его личных параметрах. В интерактивном CLI это выдается только для самого этого выбора; более поздние вызовы, которые соответствуют сохраненному правилу, выдают "config" вместо этого. В Agent SDK или неинтерактивных сеансах -p как начальный выбор, так и более поздние совпадения правил выдают "user_permanent". Рассматривается как принятие.
  • "user_temporary": Выдается, когда пользователь выбрал “Да” при запросе разрешения для одноразового одобрения, или выбрал один из вариантов ”… во время этого сеанса” на запросе редактирования или чтения файла. В интерактивном CLI это выдается только для самого выбора; более поздние вызовы, разрешенные этим разрешением в области сеанса, выдают "config" вместо этого. В Agent SDK или неинтерактивных сеансах -p как выбор, так и более поздние совпадения выдают "user_temporary". Рассматривается как принятие.
  • "user_abort": Выдается, когда пользователь отклонил запрос разрешения без ответа. Рассматривается как отклонение.
  • "user_reject": Выдается, когда пользователь выбрал “Нет” при запросе, или вызов соответствовал правилу отказа в их личных параметрах. Рассматривается как отклонение.

​

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

• Все стандартные атрибуты
• event.name: "permission_mode_changed"
• event.timestamp: Временная метка ISO 8601
• event.sequence: монотонно возрастающий счетчик для упорядочивания событий в сеансе
• from_mode: Предыдущий режим разрешений, например "default", "plan", "acceptEdits", "auto" или "bypassPermissions"
• to_mode: Новый режим разрешений
• trigger: Что вызвало изменение. Один из "shift_tab", "exit_plan_mode", "auto_gate_denied" или "auto_opt_in". Отсутствует, когда переход исходит из SDK или моста

​

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

• Все стандартные атрибуты
• event.name: "auth"
• event.timestamp: Временная метка ISO 8601
• event.sequence: монотонно возрастающий счетчик для упорядочивания событий в сеансе
• action: "login" или "logout"
• success: "true" или "false"
• auth_method: Метод аутентификации, такой как "oauth"
• error_category: Категориальный вид ошибки при сбое действия. Исходное сообщение об ошибке никогда не включается
• status_code: HTTP код состояния в виде строки при сбое действия с ошибкой HTTP

​

Событие подключения MCP сервера

• Все стандартные атрибуты
• event.name: "mcp_server_connection"
• event.timestamp: Временная метка ISO 8601
• event.sequence: монотонно возрастающий счетчик для упорядочивания событий в сеансе
• status: "connected", "failed" или "disconnected"
• transport_type: Транспорт сервера, такой как "stdio", "sse" или "http"
• server_scope: Область, в которой настроен сервер, такая как "user", "project" или "local"
• duration_ms: Длительность попытки подключения в миллисекундах
• error_code: Код ошибки при сбое подключения
• 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", "org", "user-local" или "default-bundle"
• enabled_via: как плагин был включен: "default-enable", "org-policy", "seed-mount" или "user-install"
• plugin_id_hash: детерминированный хеш имени плагина и маркетплейса, отправляемый только на ваш настроенный экспортер. Позволяет вам подсчитать, сколько различных плагинов третьих сторон загружено в вашем парке, без записи их имен
• has_hooks: предоставляет ли плагин hooks
• has_mcp: предоставляет ли плагин MCP серверы
• skill_path_count: количество каталогов навыков, которые объявляет плагин
• command_path_count: количество каталогов команд, которые объявляет плагин
• agent_path_count: количество каталогов агентов, которые объявляет плагин

​

Событие активации навыка

• Все стандартные атрибуты
• 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")
• 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")
• 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"

​

Событие регистрации hook

• Все стандартные атрибуты
• event.name: "hook_registered"
• event.timestamp: Временная метка ISO 8601
• event.sequence: монотонно возрастающий счетчик для упорядочивания событий в сеансе
• hook_event: тип события hook, такой как "PreToolUse" или "PostToolUse"
• hook_type: тип реализации hook: "command", "prompt", "mcp_tool", "http" или "agent"
• hook_source: где определен hook: "userSettings", "projectSettings", "localSettings", "flagSettings", "policySettings" или "pluginHook"
• hook_matcher (когда OTEL_LOG_TOOL_DETAILS=1): строка matcher из конфигурации hook, когда она установлена
• plugin.name (когда hook_source это "pluginHook"): имя участвующего плагина. Для плагинов вне официального маркетплейса и встроенного пакета значение "third-party", если не установлен OTEL_LOG_TOOL_DETAILS=1
• plugin_id_hash (когда hook_source это "pluginHook"): детерминированный хеш имени плагина и маркетплейса, отправляемый только на ваш настроенный экспортер. Позволяет вам подсчитать различные участвующие плагины без записи их имен

​

Событие начала выполнения hook

• Все стандартные атрибуты
• event.name: "hook_execution_start"
• event.timestamp: Временная метка ISO 8601
• event.sequence: монотонно возрастающий счетчик для упорядочивания событий в сеансе
• hook_event: Тип события hook, такой как "PreToolUse" или "PostToolUse"
• hook_name: Полное имя hook, включая matcher, такой как "PreToolUse:Write"
• num_hooks: Количество соответствующих команд hook
• managed_only: "true" когда разрешены только управляемые политики hooks
• hook_source: "policySettings" или "merged"
• hook_definitions: JSON-сериализованная конфигурация hook. Включается только, когда включены как детальная бета-трассировка, так и OTEL_LOG_TOOL_DETAILS=1

​

Событие завершения выполнения hook

• Все стандартные атрибуты
• event.name: "hook_execution_complete"
• event.timestamp: Временная метка ISO 8601
• event.sequence: монотонно возрастающий счетчик для упорядочивания событий в сеансе
• hook_event: Тип события hook
• hook_name: Полное имя hook, включая matcher
• num_hooks: Количество соответствующих команд hook
• num_success: Количество, которые завершились успешно
• num_blocking: Количество, которые вернули решение блокировки
• num_non_blocking_error: Количество, которые не удались без блокировки
• num_cancelled: Количество, отмененные до завершения
• total_duration_ms: Длительность в реальном времени всех соответствующих hooks
• managed_only: "true" когда разрешены только управляемые политики hooks
• hook_source: "policySettings" или "merged"
• hook_definitions: JSON-сериализованная конфигурация hook. Включается только, когда включены как детальная бета-трассировка, так и OTEL_LOG_TOOL_DETAILS=1

​

Событие компактирования

• Все стандартные атрибуты
• event.name: "compaction"
• event.timestamp: Временная метка ISO 8601
• event.sequence: монотонно возрастающий счетчик для упорядочивания событий в сеансе
• trigger: "auto" или "manual"
• success: "true" или "false"
• duration_ms: Длительность компактирования
• pre_tokens: Приблизительное количество токенов до компактирования
• post_tokens: Приблизительное количество токенов после компактирования
• error: Сообщение об ошибке при сбое компактирования

​

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

• Все стандартные атрибуты
• event.name: "feedback_survey"
• event.timestamp: Временная метка ISO 8601
• event.sequence: монотонно возрастающий счетчик для упорядочивания событий в сеансе
• event_type: Событие жизненного цикла опроса, например "appeared", "responded" или "transcript_prompt_appeared"
• appearance_id: Уникальный ID, связывающий события, выданные для одного экземпляра опроса
• survey_type: Какой опрос произвел событие. "session" это подсказка рейтинга “Как работает Claude?”
• response: Выбор пользователя на событиях responded
• enabled_via_override: true когда установлен CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL. Выдается как логическое значение, а не строка. Присутствует на событиях опроса session. Отфильтруйте по этому атрибуту, чтобы подтвердить, что переопределение применяется в вашем парке

​

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

​

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

​

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

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

​

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

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

​

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

​

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

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

​

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

​

Для метрик

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

​

Для событий/логов

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

​

Для трассировок

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

​

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

• service.name: claude-code
• service.version: Текущая версия Claude 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 включается в атрибуты телеметрии. Если это вызывает беспокойство для вашей организации, работайте с вашим бэкендом телеметрии для фильтрации или редактирования этого поля
• Содержимое пользовательской подсказки не собирается по умолчанию. Записывается только длина подсказки. Чтобы включить содержимое подсказки, установите OTEL_LOG_USER_PROMPTS=1
• Аргументы входных данных инструмента и параметры не логируются по умолчанию. Чтобы включить их, установите OTEL_LOG_TOOL_DETAILS=1. Когда включено, события tool_result включают атрибут tool_parameters с командами Bash, именами MCP сервера и инструмента и именами навыков, плюс атрибут tool_input с путями к файлам, URL-адресами, шаблонами поиска и другими аргументами. События user_prompt включают буквальное command_name для пользовательских, plugin и MCP команд. Span трассировки включают тот же атрибут tool_input и атрибуты, полученные из входных данных, такие как file_path. Отдельные значения более 512 символов усекаются, и общее количество ограничено примерно 4 K символами, но аргументы могут по-прежнему содержать конфиденциальные значения. Настройте ваш бэкенд телеметрии для фильтрации или редактирования этих атрибутов по мере необходимости
• Входные и выходные данные инструмента не логируются в span событиях по умолчанию. Чтобы включить их, установите OTEL_LOG_TOOL_CONTENT=1. Когда включено, события span включают полное содержимое входных и выходных данных инструмента, усеченное на 60 КБ на span. Это может включать содержимое исходного файла из результатов инструмента Read и выходные данные команды Bash. Настройте ваш бэкенд телеметрии для фильтрации или редактирования этих атрибутов по мере необходимости
• Тела запроса и ответа Anthropic Messages API в исходном виде не логируются по умолчанию. Чтобы включить их, установите OTEL_LOG_RAW_API_BODIES. С =1 каждый вызов API выдает события логов api_request_body и api_response_body, чей атрибут body является JSON-сериализованной нагрузкой, усеченной на 60 КБ. С =file:<dir>, неусеченные тела записываются в файлы .request.json и .response.json в этом каталоге, и события несут путь body_ref вместо встроенного тела. Отправьте каталог с коллектором логов или sidecar, а не через поток телеметрии. В обоих режимах тела содержат полную историю разговора (системная подсказка, каждый предыдущий ход пользователя и помощника, результаты инструментов), поэтому включение этого подразумевает согласие со всем, что раскрыли бы другие флаги содержимого OTEL_LOG_*. Содержимое расширенного мышления Claude всегда скрыто из этих тел независимо от других параметров

​

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