---
title: Справочник по спанам OpenTelemetry
url: https://platform.claude.com/docs/ru/api/opentelemetry/spans
description: Спаны OpenTelemetry и атрибуты спанов, которые генерируют Claude API и Claude SDK.
featureMetadata:
topic:
title: OpenTelemetry
url: https://platform.claude.com/docs/en/manage-claude/opentelemetry
status: beta
---
Экспорт OpenTelemetry находится в бета-версии. Он предоставляется в соответствии с вашим соглашением с Anthropic, включая раздел Beta Services в [Условиях для отдельных сервисов](https://www.anthropic.com/legal/service-specific-terms). Имена и атрибуты спанов могут измениться в ходе бета-тестирования.
Чтобы настроить экспорт, см. [Использование OpenTelemetry с Claude SDK](https://platform.claude.com/docs/ru/manage-claude/opentelemetry/sdk) и [Использование OpenTelemetry с Claude API](https://platform.claude.com/docs/ru/manage-claude/opentelemetry/api).
## Имена и виды спанов
| Свойство | Спаны SDK | Спаны API |
| -------------------------- | ----------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------- |
| `service.name` | `service.name` приложения | `claude-platform` |
| Область инструментирования | `com.anthropic.sdk.` или `com.anthropic.sdk.cli`, плюс `.` в клиенте облачной платформы, с версией пакета | `com.anthropic.claude-platform` |
| Вид спана | `CLIENT` на спане для запроса, иначе `INTERNAL` | `SERVER` на спане для запроса, иначе `INTERNAL` |
* **Спаны для запросов** («span» (спан) — единица трассировки) имеют имя метода API, соответствующего запросу: `anthropic.`, за которым следует путь метода в справочнике API, с точками вместо косых черт и без `beta`. Например, `client.beta.sessions.events.send()` (csharp, go: `client.Beta.Sessions.Events.Send()`; java: `client.beta().sessions().events().send()`; php: `$client->beta->sessions->events->send()`; ruby: `client.beta.sessions.events.send_()`) отправляет запрос на [отправку событий сессии](https://platform.claude.com/docs/ru/api/beta/sessions/events/send), и его спаны имеют имя [`anthropic.sessions.events.send`](https://platform.claude.com/docs/ru/api/opentelemetry/spans#anthropic-sessions-events-send).
* **Спаны инструментов** имеют фиксированное имя, пробел и имя инструмента, например [`anthropic.tool_use bash`](https://platform.claude.com/docs/ru/api/opentelemetry/spans#anthropic-tool-use-anthropic-mcp-tool-use-and-anthropic-custom-tool-use).
## Статус спана
* **`OK`:** Шаг завершился.
* **`ERROR`:** Шаг завершился с ошибкой.
* **Не задан:** Приложение отменило шаг, например когда оно отправило событие [`user.interrupt`](https://platform.claude.com/docs/ru/api/beta/sessions/events#beta_managed_agents_user_interrupt_event).
Спан потока завершается, когда завершается поток. Если приложение закрывает поток досрочно, спан SDK имеет незаданный статус, поэтому спан SDK потока, который никогда не завершается, например [`anthropic.sessions.events.stream`](https://platform.claude.com/docs/ru/api/opentelemetry/spans#anthropic-sessions-method), имеет незаданный статус или `ERROR`.
## Атрибуты
Атрибуты используют [семантические соглашения OpenTelemetry для генеративного ИИ](https://github.com/open-telemetry/semantic-conventions-genai) (`gen_ai.*`), если соответствующее соглашение существует. Атрибуты Anthropic начинаются с `anthropic.`. Спаны следуют соглашениям на момент коммита [`e57c543b`](https://github.com/open-telemetry/semantic-conventions-genai/tree/e57c543b4889619eb2a05702471937db5119165d) от 24 сентября 2026 года. Соглашения всё ещё находятся в разработке.
### Общие атрибуты
Каждый спан запроса имеет следующие атрибуты, если в описании не указано иное. Другие спаны могут иметь только первые три:
| Атрибут | Тип | Описание |
| --------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `gen_ai.provider.name` | `string` | `anthropic`. Присутствует в каждом спане.
**SDK:** `aws.bedrock` в клиентах Amazon Bedrock (включая Mantle) и `gcp.vertex_ai` в клиенте для Google Cloud's Agent Platform. |
| `anthropic.organization.id` | `string` | ID организации. |
| `anthropic.workspace.id` | `string` | ID рабочего пространства, в котором выполняется работа. |
| `anthropic.request.id` | `string` | Значение заголовка ответа `request-id`. |
| `http.request.method` | `string` | HTTP-метод запроса, например `POST`. |
| `http.route` | `string` | Путь эндпоинта с заполнителями для его параметров пути, например `/v1/sessions/{session_id}`. |
| `http.response.status_code` | `int` | Код состояния HTTP итогового ответа. Для потока — код состояния, отправленный вместе с заголовками. Отсутствует, если ответа не было. |
| `server.address` | `string` | Хост, на который был отправлен запрос, например `api.anthropic.com`. |
| `server.port` | `int` | Порт URL запроса или порт по умолчанию для его схемы, если в URL его нет. |
| `url.scheme` | `string` | Схема URL, например `https`. |
| `url.path` | `string` | Путь URL, например `/v1/messages`. |
| `url.query` | `string` | Строка запроса URL, содержащая только те параметры запроса, которые определены в эндпоинте. Отсутствует, если таких параметров нет. |
| `url.full` | `string` | URL запроса. |
В Claude Platform on AWS спаны API не содержат `server.address`, `server.port` и `url.full`.
### Атрибуты сессии
В сессии Managed Agents спаны имеют следующие атрибуты. Спаны сессии могут находиться в нескольких трассировках, поэтому, чтобы собрать представление сессии, например стенограмму, [сгруппируйте её спаны по этим ID](https://platform.claude.com/docs/ru/manage-claude/opentelemetry#a-managed-agents-session).
| Атрибут | Тип | Описание |
| ------------------------ | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `anthropic.session.id` | `string` | ID сессии. Отсутствует в спанах методов, которые не работают с одной сессией, например [`anthropic.sessions.list`](https://platform.claude.com/docs/ru/api/opentelemetry/spans#anthropic-sessions-method). |
| `gen_ai.conversation.id` | `string` | ID потока сессии, к которому относится спан. В SDK [параметр `conversation_id` (typescript, java, php: `conversationId`; csharp: `ConversationId`; go: `option.WithOpenTelemetryConversationID()`)](https://platform.claude.com/docs/ru/manage-claude/opentelemetry/sdk#configure-the-sdk) заменяет его вашим собственным ID беседы. Отсутствует в спанах SDK без потока, если не задан этот параметр, а также в спанах API для запросов к Sessions API, кроме запросов к одному потоку. |
### Атрибуты содержимого
Атрибуты, помеченные Content, присутствуют только в спанах в режиме содержимого, как от SDK, так и от API. См. [чем различаются режимы содержимого в руководстве](https://platform.claude.com/docs/ru/manage-claude/opentelemetry#choose-a-content-mode). Если это содержимое слишком велико, SDK и API [сокращают его](https://platform.claude.com/docs/ru/manage-claude/opentelemetry#content-limits) и устанавливают `anthropic.content.truncated` в `true`. Если меры защиты Anthropic исключают содержимое из ответа, спаны API его тоже не включают.
Атрибуты сообщений — это строки JSON в формате сообщений соглашений OpenTelemetry GenAI. Каждый блок содержимого Anthropic становится одной частью сообщения соглашений GenAI — в Messages API и в событиях сообщений Managed Agents, таких как `agent.message`:
| Блок содержимого Anthropic | Часть сообщения соглашений GenAI |
| ----------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `text` | `text` |
| `tool_use`, `server_tool_use` | `tool_call`, с `anthropic_toolset_name` для блока `tool_use`, у которого есть `toolset_name`, например `computer` |
| `mcp_tool_use` | `tool_call` с `anthropic_mcp_server_name` |
| `tool_result`, `mcp_tool_result`, блок результата серверного инструмента, например `web_search_tool_result` | `tool_call_response` |
| `thinking` | `reasoning` без подписи блока `thinking`. Отсутствует в спанах Managed Agents, поскольку событие `agent.thinking` не содержит самого содержимого размышлений. |
| Любой другой блок, например `image` | `type` блока с префиксом `anthropic_`, например `anthropic_image`. Часть не содержит других полей. |
Каждое событие использования инструмента или результата инструмента Managed Agents также становится одной частью сообщения соглашений GenAI:
| Событие Managed Agents | Часть сообщения соглашений GenAI |
| ------------------------------------------------------------------------------------------- | ----------------------------------------- |
| `agent.tool_use`, `agent.custom_tool_use` | `tool_call` |
| `agent.mcp_tool_use` | `tool_call` с `anthropic_mcp_server_name` |
| `user.tool_result`, `user.custom_tool_result`, `agent.tool_result`, `agent.mcp_tool_result` | `tool_call_response` |
### Использование токенов
Следующие спаны имеют атрибуты использования токенов: [`anthropic.messages.create`](https://platform.claude.com/docs/ru/api/opentelemetry/spans#anthropic-messages-create), [`anthropic.model_request`](https://platform.claude.com/docs/ru/api/opentelemetry/spans#anthropic-model-request), [`anthropic.compaction`](https://platform.claude.com/docs/ru/api/opentelemetry/spans#anthropic-compaction) и [`anthropic.session.outcome_evaluation`](https://platform.claude.com/docs/ru/api/opentelemetry/spans#anthropic-session-outcome-evaluation). Значения относятся к шагу каждого спана, например к запросу, запросу к модели или сжатию. Чтобы учесть каждый токен один раз, см. [как подсчитывать токены в руководстве](https://platform.claude.com/docs/ru/manage-claude/opentelemetry#count-tokens).
| Атрибут | Тип | Описание |
| ---------------------------------------------------------- | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `gen_ai.usage.input_tokens` | `int` | Входные токены, включая чтение из кэша и запись в кэш. |
| `gen_ai.usage.output_tokens` | `int` | Выходные токены. |
| `gen_ai.usage.cache_write.input_tokens` | `int` | Токены, записанные в кэш подсказок. Отсутствует в спанах [`anthropic.session.outcome_evaluation`](https://platform.claude.com/docs/ru/api/opentelemetry/spans#anthropic-session-outcome-evaluation). |
| `anthropic.usage.cache_creation.ephemeral_5m_input_tokens` | `int` | Токены, записанные в 5-минутный кэш. Только в спанах для запросов Messages API. В спане SDK для ответа с потоковой передачей — только токены, записанные до первого выходного токена. |
| `anthropic.usage.cache_creation.ephemeral_1h_input_tokens` | `int` | Токены, записанные в 1-часовой кэш. Только в спанах запросов Messages API. В спане SDK для ответа с потоковой передачей — только токены, записанные до первого выходного токена. |
| `gen_ai.usage.cache_read.input_tokens` | `int` | Токены, прочитанные из кэша подсказок. Отсутствует в спанах [`anthropic.session.outcome_evaluation`](https://platform.claude.com/docs/ru/api/opentelemetry/spans#anthropic-session-outcome-evaluation). |
## Спаны
Спан может поступать от SDK в приложении или от API, поэтому для каждого спана в этом справочнике указаны его источники. Описания, начинающиеся с **Messages API:** или **Managed Agents:**, относятся к спанам соответствующего продукта. Описания атрибутов, начинающиеся с источника, например **SDK:** или **API:**, относятся к спанам этого источника.
### `anthropic.messages.create`
* **Источник:** SDK и API.
* **Вид:** `CLIENT` от SDK, `SERVER` от API.
* **Родитель спана SDK:** Спан, который является текущим в приложении в момент вызова метода. Если текущего спана нет, родителя нет.
* **Родитель спана API:** Спан из заголовка `traceparent` запроса, которым является спан SDK, если запрос поступает от SDK. Без этого заголовка спан API не имеет родителя. См. [как отправлять заголовок `traceparent`](https://platform.claude.com/docs/ru/manage-claude/opentelemetry/api#connect-api-spans-to-your-own-traces).
* **Дочерние спаны спана SDK:** Спан API для этого запроса.
* **Дочерние спаны спана API:** Спан [`anthropic.model_request`](https://platform.claude.com/docs/ru/api/opentelemetry/spans#anthropic-model-request) для каждого запроса к модели, [спан инструмента](https://platform.claude.com/docs/ru/api/opentelemetry/spans#anthropic-tool-use-anthropic-mcp-tool-use-and-anthropic-custom-tool-use) для каждого использования серверного инструмента или инструмента коннектора MCP, который API выполняет в запросе, и спан [`anthropic.compaction`](https://platform.claude.com/docs/ru/api/opentelemetry/spans#anthropic-compaction) для каждого сжатия.
SDK генерирует этот спан для каждого запроса Messages, с потоковой передачей или без неё.
API генерирует этот спан для каждого запроса [`POST /v1/messages`](https://platform.claude.com/docs/ru/api/messages/create), который он аутентифицирует. Он не генерирует спан для запроса к [OpenAI-совместимой конечной точке](https://platform.claude.com/docs/ru/cli-sdks-libraries/libraries/openai-sdk) `POST /v1/chat/completions`.
API генерирует один спан для запроса, даже когда его обслуживает [резервная модель](https://platform.claude.com/docs/ru/build-with-claude/refusals-and-fallback).
Спан имеет [атрибуты использования токенов](https://platform.claude.com/docs/ru/api/opentelemetry/spans#token-usage). Спан SDK также имеет атрибуты каждого [спана SDK для запроса](https://platform.claude.com/docs/ru/api/opentelemetry/spans#anthropic-resources-method).
| Атрибут | Тип | Описание |
| ------------------------------------------ | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `gen_ai.operation.name` | `string` | `chat` |
| `gen_ai.request.model` | `string` | [`model`](https://platform.claude.com/docs/ru/api/messages/create#create.model) запроса. |
| `gen_ai.response.id` | `string` | [`id`](https://platform.claude.com/docs/ru/api/messages/create#message) ответа. |
| `gen_ai.response.model` | `string` | Модель, которая обслужила запрос. Она отличается от запрошенной модели, когда запрос использует псевдоним модели или когда запрос обслужила [резервная модель](https://platform.claude.com/docs/ru/build-with-claude/refusals-and-fallback). |
| `anthropic.message.stop_reason` | `string` | [`stop_reason`](https://platform.claude.com/docs/ru/api/messages#stop_reason) ответа, например `end_turn`. |
| `anthropic.response.service_tier` | `string` | Уровень обслуживания, на котором был обслужен запрос: [`usage.service_tier`](https://platform.claude.com/docs/ru/api/messages#usage) ответа. См. [как запросам назначаются уровни](https://platform.claude.com/docs/ru/api/service-tiers#how-requests-get-assigned-tiers). |
| `error.type` | `string` | [Тип ошибки](https://platform.claude.com/docs/ru/api/errors#http-errors) неудавшегося запроса, например `rate_limit_error`.
**SDK:** Также другие значения из раздела [спаны SDK для запросов](https://platform.claude.com/docs/ru/api/opentelemetry/spans#anthropic-resources-method).
**API:** `api_error`, когда API завершает запрос без ответа с ошибкой. |
| `gen_ai.response.time_to_first_chunk` | `double` | Только в спане SDK для ответа с потоковой передачей. Количество секунд с момента первой отправки запроса SDK до первого события `content_block_delta` потока, если оно есть. |
| `gen_ai.usage.reasoning.output_tokens` | `int` | Токены размышлений ответа. Они входят в число выходных токенов. Отсутствует, если данные об использовании в ответе не содержат подробностей о выходных токенах. |
| `anthropic.usage.compaction.input_tokens` | `int` | Входные токены [сжатий](https://platform.claude.com/docs/ru/build-with-claude/compaction) запроса, включая чтение из кэша и запись в кэш. Не входят в `gen_ai.usage.input_tokens`. Отсутствует, если в ответе нет сжатия. |
| `anthropic.usage.compaction.output_tokens` | `int` | Выходные токены сжатий запроса. Не входят в `gen_ai.usage.output_tokens`. Отсутствует, если в ответе нет сжатия. |
| `gen_ai.request.max_tokens` | `int` | [`max_tokens`](https://platform.claude.com/docs/ru/api/messages/create#create.max_tokens) запроса. |
| `gen_ai.request.temperature` | `double` | [`temperature`](https://platform.claude.com/docs/ru/api/messages/create#create.temperature) запроса. Отсутствует, если запрос его не задаёт. |
| `gen_ai.request.top_p` | `double` | [`top_p`](https://platform.claude.com/docs/ru/api/messages/create#create.top_p) запроса. Отсутствует, если запрос его не задаёт. |
| `gen_ai.request.top_k` | `int` | [`top_k`](https://platform.claude.com/docs/ru/api/messages/create#create.top_k) запроса. Отсутствует, если запрос его не задаёт. |
| `gen_ai.request.stream` | `boolean` | `true`, когда запрос задаёт [`stream: true`](https://platform.claude.com/docs/ru/api/messages/create#create.stream). В противном случае отсутствует. |
| `gen_ai.request.reasoning.level` | `string` | [`effort`](https://platform.claude.com/docs/ru/api/messages/create#create.output_config.effort) в [`output_config`](https://platform.claude.com/docs/ru/api/messages/create#create.output_config) запроса. Отсутствует, если запрос его не задаёт. |
| `gen_ai.output.type` | `string` | `json`, когда запрос задаёт формат вывода JSON. В противном случае отсутствует. |
| `anthropic.request.service_tier` | `string` | [`service_tier`](https://platform.claude.com/docs/ru/api/messages/create#create.service_tier) запроса. Отсутствует, если запрос его не задаёт. |
| `anthropic.thinking.type` | `string` | [`thinking.type`](https://platform.claude.com/docs/ru/api/messages/create#create.thinking) запроса. Отсутствует, если запрос его не задаёт. |
| `anthropic.thinking.budget_tokens` | `int` | [`budget_tokens`](https://platform.claude.com/docs/ru/api/messages#thinking_config_enabled.budget_tokens) в объекте [`thinking`](https://platform.claude.com/docs/ru/api/messages/create#create.thinking) запроса. Отсутствует, если запрос его не задаёт. |
| `anthropic.beta` | `string[]` | Только в спане SDK. Имена бета-функций в заголовке [`anthropic-beta`](https://platform.claude.com/docs/ru/api/beta/messages/create#create.betas) запроса. |
| `gen_ai.system_instructions` | `string` | Content Строка JSON, соответствующая схеме OpenTelemetry [`SystemInstructions`](https://github.com/open-telemetry/semantic-conventions-genai/blob/e57c543b4889619eb2a05702471937db5119165d/model/gen-ai/gen-ai-system-instructions.json). Системная подсказка [`system`](https://platform.claude.com/docs/ru/api/messages/create#create.system) запроса. |
| `gen_ai.input.messages` | `string` | Content Строка JSON, соответствующая схеме OpenTelemetry [`InputMessages`](https://github.com/open-telemetry/semantic-conventions-genai/blob/e57c543b4889619eb2a05702471937db5119165d/model/gen-ai/gen-ai-input-messages.json). [`messages`](https://platform.claude.com/docs/ru/api/messages/create#create.messages) запроса. |
| `gen_ai.output.messages` | `string` | Content Строка JSON, соответствующая схеме OpenTelemetry [`OutputMessages`](https://github.com/open-telemetry/semantic-conventions-genai/blob/e57c543b4889619eb2a05702471937db5119165d/model/gen-ai/gen-ai-output-messages.json). [`content`](https://platform.claude.com/docs/ru/api/messages/create#message) ответа в виде одного сообщения `assistant`.
**SDK:** Для потока — только когда приложение читает поток так, как описано в разделе [Трассировка потока](https://platform.claude.com/docs/ru/manage-claude/opentelemetry/sdk#trace-a-stream). |
| `gen_ai.request.stop_sequences` | `string[]` | Content [`stop_sequences`](https://platform.claude.com/docs/ru/api/messages/create#create.stop_sequences) запроса. |
Спаны запроса не содержат счётчиков использования серверных инструментов из ответа, таких как `web_search_requests`. Вместо этого API генерирует [спан инструмента](https://platform.claude.com/docs/ru/api/opentelemetry/spans#anthropic-tool-use-anthropic-mcp-tool-use-and-anthropic-custom-tool-use) для каждого использования серверного инструмента.
### `anthropic.messages.count_tokens`
* **Источник:** SDK. API не генерирует спан для [`POST /v1/messages/count_tokens`](https://platform.claude.com/docs/ru/api/messages/count_tokens).
* **Вид:** `CLIENT`.
* **Родитель:** Спан, который является текущим в приложении в момент вызова метода, или отсутствует, если текущего спана нет.
* **Дочерние спаны:** Нет.
| Атрибут | Тип | Описание |
| --------------------------------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------- |
| `gen_ai.request.model` | `string` | Модель запроса. |
| `anthropic.message.count_tokens.input_tokens` | `int` | Количество токенов в ответе. Это количество не является использованием. Не включайте его при суммировании использования токенов. |
### `anthropic.sessions.create`
То же, что и [`anthropic.sessions.`](https://platform.claude.com/docs/ru/api/opentelemetry/spans#anthropic-sessions-method), за исключением следующих дочерних спанов и атрибутов:
* **Дочерние спаны спана SDK:** Спан API для этого запроса.
* **Дочерние спаны спана API:** Спан [`anthropic.session.turn`](https://platform.claude.com/docs/ru/api/opentelemetry/spans#anthropic-session-turn) первого хода, когда запрос содержит непустой [`initial_events`](https://platform.claude.com/docs/ru/api/beta/sessions/create#create.initial_events).
| Атрибут | Тип | Описание |
| ---------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------- |
| `gen_ai.agent.id` | `string` | ID агента, на основе которого была создана сессия. |
| `gen_ai.agent.name` | `string` | Имя этого агента.
**SDK:** Отсутствует, если запрос завершился с ошибкой. |
| `gen_ai.request.model` | `string` | Модель этого агента, которая выполняет основной поток.
**SDK:** Отсутствует, если запрос завершился с ошибкой. |
| `anthropic.session.environment.id` | `string` | ID окружения сессии. |
### `anthropic.sessions.events.send`
То же, что и [`anthropic.sessions.`](https://platform.claude.com/docs/ru/api/opentelemetry/spans#anthropic-sessions-method), за исключением дочерних спанов спана API.
* **Дочерние спаны спана SDK:** Спан API для этого запроса.
* **Дочерние спаны спана API:** Спан [`anthropic.session.turn`](https://platform.claude.com/docs/ru/api/opentelemetry/spans#anthropic-session-turn) каждого хода, который начинается из-за событий запроса.
### `anthropic.sessions.update`
То же, что и [`anthropic.sessions.`](https://platform.claude.com/docs/ru/api/opentelemetry/spans#anthropic-sessions-method), за исключением дочерних спанов спана API.
* **Дочерние спаны спана SDK:** Спан API для этого запроса.
* **Дочерние спаны спана API:** Спан [`anthropic.session.turn`](https://platform.claude.com/docs/ru/api/opentelemetry/spans#anthropic-session-turn) каждого хода, который возобновляется, потому что запрос увеличивает или снимает [бюджет сессии](https://platform.claude.com/docs/ru/managed-agents/budgets#resume-a-session-at-its-budget).
### `anthropic.session.turn`
* **Источник:** API, для сессий Managed Agents.
* **Вид:** `INTERNAL`.
* **Родитель:** Зависит от того, почему начался ход:
* Спан [`anthropic.sessions.create`](https://platform.claude.com/docs/ru/api/opentelemetry/spans#anthropic-sessions-create) — для первого хода сессии, созданной с непустым [`initial_events`](https://platform.claude.com/docs/ru/api/beta/sessions/create#create.initial_events).
* Спан [`anthropic.sessions.events.send`](https://platform.claude.com/docs/ru/api/opentelemetry/spans#anthropic-sessions-events-send) для запроса, в котором было отправлено событие, — для хода, который начался из-за события, например события [`user.message`](https://platform.claude.com/docs/ru/api/beta/sessions/events#beta_managed_agents_user_message_event).
* Спан [`anthropic.sessions.update`](https://platform.claude.com/docs/ru/api/opentelemetry/spans#anthropic-sessions-update) — для хода, который возобновляется, потому что бюджет сессии был повышен или снят через запрос.
* Спан `anthropic.session.turn` хода [агента, которого запускает сессия](https://platform.claude.com/docs/ru/managed-agents/multiagent-orchestration), во время которого этот агент начал этот ход, — для хода в другом потоке.
* Нет родителя — для хода, который начинается потому, что агент в другом потоке ответил или завершил свой ход, например агент, вызванный основным агентом.
* **Дочерние спаны:**
* Спан [`anthropic.model_request`](https://platform.claude.com/docs/ru/api/opentelemetry/spans#anthropic-model-request) для каждого запроса к модели в ходе.
* Спан инструмента каждый раз, когда API выполняет инструмент в ходе, за исключением [случаев, перечисленных в разделе о спанах инструментов](https://platform.claude.com/docs/ru/api/opentelemetry/spans#anthropic-tool-use-anthropic-mcp-tool-use-and-anthropic-custom-tool-use).
* Спан `anthropic.session.turn` для каждого хода, который агент, запускаемый сессией, начал в другом потоке во время этого хода.
* Спан [`anthropic.session.outcome_evaluation`](https://platform.claude.com/docs/ru/api/opentelemetry/spans#anthropic-session-outcome-evaluation) для каждой итерации оценки результата, которую начинает этот ход.
Ход начинается, когда его поток переходит в состояние `running`, и заканчивается, когда поток выходит из него.
| Атрибут | Тип | Описание |
| ------------------------------------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `gen_ai.operation.name` | `string` | `invoke_agent` |
| `gen_ai.agent.id` | `string` | ID агента, который выполняет поток хода. Отсутствует в потоке [советника](https://platform.claude.com/docs/ru/managed-agents/multiagent-orchestration#advisor-threads). |
| `gen_ai.agent.name` | `string` | Имя этого агента. `anthropic.advisor` в потоке советника. |
| `gen_ai.request.model` | `string` | Модель этого агента. В потоке советника — модель советника. |
| `anthropic.session.turn.stop_reason` | `string` | Почему ход завершился: [`stop_reason.type`](https://platform.claude.com/docs/ru/api/beta/sessions/events#beta_managed_agents_session_thread_status_idle_event) события [`session.thread_status_idle`](https://platform.claude.com/docs/ru/api/beta/sessions/events#beta_managed_agents_session_thread_status_idle_event), например `requires_action`. Отсутствует, если поток не перешёл в состояние простоя. |
| `error.type` | `string` | [`error.type`](https://platform.claude.com/docs/ru/api/beta/sessions/events#beta_managed_agents_session_error_event) события [`session.error`](https://platform.claude.com/docs/ru/api/beta/sessions/events#beta_managed_agents_session_error_event), которое завершило ход, если ход завершился с ошибкой. |
| `gen_ai.agent.description` | `string` | Описание этого агента. Отсутствует в потоке советника или если у агента нет описания. |
| `gen_ai.system_instructions` | `string` | Content Строка JSON, соответствующая схеме OpenTelemetry [`SystemInstructions`](https://github.com/open-telemetry/semantic-conventions-genai/blob/e57c543b4889619eb2a05702471937db5119165d/model/gen-ai/gen-ai-system-instructions.json). Системная подсказка, действующая для хода. Есть только в первом ходе потока. Отсутствует в потоке советника. |
| `gen_ai.input.messages` | `string` | Content Строка JSON, соответствующая схеме OpenTelemetry [`InputMessages`](https://github.com/open-telemetry/semantic-conventions-genai/blob/e57c543b4889619eb2a05702471937db5119165d/model/gen-ai/gen-ai-input-messages.json). Входные события хода: сообщения пользователя и результаты инструментов, события [`system.message`](https://platform.claude.com/docs/ru/api/beta/sessions/events#beta_managed_agents_system_message_event_params) и сообщения из других потоков. Отсутствует в потоке советника. |
| `gen_ai.output.messages` | `string` | Content Строка JSON, соответствующая схеме OpenTelemetry [`OutputMessages`](https://github.com/open-telemetry/semantic-conventions-genai/blob/e57c543b4889619eb2a05702471937db5119165d/model/gen-ai/gen-ai-output-messages.json). Выходные события хода: сообщения, использования инструментов и результаты инструментов агента. |
### `anthropic.model_request`
* **Источник:** API, для запросов Messages API и сессий Managed Agents.
* **Вид:** `INTERNAL`.
* **Родитель:**
* **Messages API:** Спан [`anthropic.messages.create`](https://platform.claude.com/docs/ru/api/opentelemetry/spans#anthropic-messages-create) для запроса.
* **Managed Agents:** Спан [`anthropic.session.turn`](https://platform.claude.com/docs/ru/api/opentelemetry/spans#anthropic-session-turn) хода, который выполняет запрос.
* **Дочерние спаны:** Нет.
В Messages API каждый спан — это один запрос к модели в рамках запроса API.
Спан имеет [атрибуты использования токенов](https://platform.claude.com/docs/ru/api/opentelemetry/spans#token-usage).
| Атрибут | Тип | Описание |
| ----------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `gen_ai.operation.name` | `string` | Только в спанах сессий Managed Agents, где он равен `chat`. В Messages API операцией `chat` является спан [`anthropic.messages.create`](https://platform.claude.com/docs/ru/api/opentelemetry/spans#anthropic-messages-create) для запроса. |
| `gen_ai.request.model` | `string` | Модель запроса. |
| `gen_ai.response.model` | `string` | Только в спанах запросов Messages API. Модель, которая выполнила запрос к модели. |
| `error.type` | `string` | **Messages API:** `error.type` спана [`anthropic.messages.create`](https://platform.claude.com/docs/ru/api/opentelemetry/spans#anthropic-messages-create), если запрос завершился с ошибкой во время этого запроса к модели.
**Managed Agents:** Если запрос к модели завершился с ошибкой — его [тип ошибки](https://platform.claude.com/docs/ru/api/errors#http-errors), например `rate_limit_error`. `api_error`, если запрос к модели завершился с ошибкой без ответа. |
### `anthropic.tool_use`, `anthropic.mcp_tool_use` и `anthropic.custom_tool_use`
* **Источник:** SDK и API.
* **Имя:** `anthropic.tool_use `, `anthropic.mcp_tool_use ` или `anthropic.custom_tool_use `, где `` — имя инструмента.
* **Вид:** `INTERNAL`.
* **Родитель спана SDK:** Спан, который является текущим в приложении в момент запуска инструмента; в средстве запуска инструментов Messages это спан [`anthropic.messages.tool_runner`](https://platform.claude.com/docs/ru/api/opentelemetry/spans#anthropic-messages-tool-runner). Если текущего спана нет, родителя нет.
* **Родитель спана API:**
* **Messages API:** Спан [`anthropic.messages.create`](https://platform.claude.com/docs/ru/api/opentelemetry/spans#anthropic-messages-create) для запроса, в котором API выполняет инструмент.
* **Managed Agents:** Спан [`anthropic.session.turn`](https://platform.claude.com/docs/ru/api/opentelemetry/spans#anthropic-session-turn) хода, в котором выполняется инструмент. Для использования инструмента, которое ожидает события [`user.tool_confirmation`](https://platform.claude.com/docs/ru/api/beta/sessions/events#beta_managed_agents_user_tool_confirmation_event), это ход, который начинается из-за подтверждения.
* Для использования инструмента из кода, который выполняет другой инструмент, — спан инструмента этого инструмента. В Messages API этим инструментом является [инструмент выполнения кода](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/code-execution-tool).
* **Дочерние спаны спана SDK:** Спаны, которые запускает код инструмента.
* **Дочерние спаны спана API:** Спан инструмента для каждого использования инструмента из кода, который выполняет этот инструмент. Например, код, который выполняет инструмент выполнения кода, может использовать `web_search`.
Префикс имени спана зависит от типа инструмента:
* `anthropic.tool_use ` — это спан каждого использования [серверного инструмента](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/server-tools) в Messages API или инструмента из набора инструментов агента Managed Agents. API выполняет инструменты из набора инструментов агента, за исключением [самостоятельно размещённой песочницы](https://platform.claude.com/docs/ru/manage-claude/opentelemetry/sdk#trace-a-self-hosted-sandbox), где их выполняет рабочий процесс окружения.
* `anthropic.mcp_tool_use ` — спан каждого использования инструмента MCP в SDK, в Messages API и в Managed Agents. В SDK это инструмент из вспомогательного средства MCP, который запускает [средство запуска инструментов Messages](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/tool-runner) или [средство запуска инструментов сессии](https://platform.claude.com/docs/ru/managed-agents/self-hosted-sandboxes-reference#session-tool-runner). В Messages API инструмент поступает из [коннектора MCP](https://platform.claude.com/docs/ru/agents-and-tools/mcp-connector). В Managed Agents, если [подключение к серверу MCP не удаётся](https://platform.claude.com/docs/ru/managed-agents/mcp-connector#handle-connection-and-authentication-failures), имя спана не включает имя инструмента.
* `anthropic.custom_tool_use ` — спан каждого использования инструмента, который определяет приложение и запускает средство запуска инструментов. Этот спан генерирует только SDK.
API не генерирует спан инструмента в следующих случаях:
* Модель запрашивает использование инструмента, который запускает приложение, например [пользовательского инструмента](https://platform.claude.com/docs/ru/managed-agents/tools). Если инструмент запускает средство запуска инструментов в SDK, его спан генерирует это средство запуска инструментов.
* **Managed Agents:** Агент использует инструмент, который выполняется в самостоятельно размещённой песочнице. Его спан генерирует рабочий процесс в SDK, который выполняет инструмент. См. [как трассировать самостоятельно размещённую песочницу](https://platform.claude.com/docs/ru/manage-claude/opentelemetry/sdk#trace-a-self-hosted-sandbox).
* **Managed Agents:** Агент использует [мультиагентный](https://platform.claude.com/docs/ru/managed-agents/multiagent-orchestration) инструмент или [инструмент советника](https://platform.claude.com/docs/ru/managed-agents/multiagent-orchestration#give-the-session-an-advisor).
* **Managed Agents:** Агент запрашивает использование инструмента, но сервер отклоняет использование в соответствии с [политикой разрешений `auto`](https://platform.claude.com/docs/ru/managed-agents/permission-policies#let-the-server-evaluate-each-call-with-auto), или приложение отклоняет его в событии [`user.tool_confirmation`](https://platform.claude.com/docs/ru/api/beta/sessions/events#beta_managed_agents_user_tool_confirmation_event).
| Атрибут | Тип | Описание |
| ------------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `gen_ai.operation.name` | `string` | `execute_tool` |
| `gen_ai.tool.name` | `string` | Имя инструмента, например `bash`. В спанах API имя инструмента MCP не содержит имени сервера. В Managed Agents, если подключение к серверу MCP не удалось, это имя, которое сгенерировала модель, и оно присутствует только в спанах в режиме содержимого. |
| `gen_ai.tool.call.id` | `string` | **Messages API:** `id` блока, в котором модель запросила использование инструмента: блока [`tool_use`](https://platform.claude.com/docs/ru/api/messages#tool_use_block), [`server_tool_use`](https://platform.claude.com/docs/ru/api/messages#server_tool_use_block) или [`mcp_tool_use`](https://platform.claude.com/docs/ru/api/beta/messages#beta_mcp_tool_use_block).
**Managed Agents:** ID события, в котором агент запросил использование инструмента: события [`agent.tool_use`](https://platform.claude.com/docs/ru/api/beta/sessions/events#beta_managed_agents_agent_tool_use_event), [`agent.mcp_tool_use`](https://platform.claude.com/docs/ru/api/beta/sessions/events#beta_managed_agents_agent_mcp_tool_use_event) или [`agent.custom_tool_use`](https://platform.claude.com/docs/ru/api/beta/sessions/events#beta_managed_agents_agent_custom_tool_use_event). |
| `anthropic.mcp.server.name` | `string` | Только в спанах API для инструментов MCP. Имя сервера MCP инструмента. В Messages API — [`server_name`](https://platform.claude.com/docs/ru/api/beta/messages#beta_mcp_tool_use_block.server_name) блока [`mcp_tool_use`](https://platform.claude.com/docs/ru/api/beta/messages#beta_mcp_tool_use_block). |
| `gen_ai.conversation.id` | `string` | ID потока сессии, как описано в разделе [Атрибуты сессии](https://platform.claude.com/docs/ru/api/opentelemetry/spans#session-attributes). В средстве запуска инструментов Messages — ID беседы, переданный с помощью [параметра `conversation_id` (typescript, java, php: `conversationId`; csharp: `ConversationId`; go: `option.WithOpenTelemetryConversationID()`)](https://platform.claude.com/docs/ru/manage-claude/opentelemetry/sdk#configure-the-sdk); отсутствует, если он не передан. Отсутствует в спанах API для запроса Messages API. |
| `anthropic.session.id` | `string` | ID сессии. Отсутствует для использования инструмента вне сессии Managed Agents, например в Messages API или в средстве запуска инструментов Messages. |
| `anthropic.session.thread.id` | `string` | Только в спанах SDK средства запуска инструментов сессии. ID потока сессии. Отсутствует для использования инструмента в основном потоке. |
| `anthropic.tool.evaluated_permission` | `string` | Только в спанах, которые API генерирует в сессиях Managed Agents. Результат оценки [политики разрешений](https://platform.claude.com/docs/ru/managed-agents/permission-policies) для использования инструмента: `allow` или `ask`. |
| `error.type` | `string` | Тип ошибки, если использование инструмента завершилось с ошибкой: `tool_error`, когда код инструмента выбрасывает ошибку или когда инструмент возвращает результат с ошибкой.
**API:** В Messages API результат с ошибкой серверного инструмента вместо этого содержит его [`error_code`](https://platform.claude.com/docs/ru/api/messages#web_search_tool_result_error.error_code), например `max_uses_exceeded`. В Managed Agents, если подключение к серверу MCP не удалось, — `mcp_authentication_failed_error`, когда не удалась аутентификация, иначе `mcp_connection_failed_error`. Если запрос завершился с ошибкой во время использования инструмента — [тип ошибки](https://platform.claude.com/docs/ru/api/errors#http-errors) запроса. |
| `gen_ai.tool.description` | `string` | Только в спанах SDK. Описание в определении инструмента. Отсутствует, если описание пустое. |
| `gen_ai.tool.type` | `string` | Только в спанах SDK. `function` |
| `gen_ai.tool.call.arguments` | `string` | Content Строка JSON, соответствующая схеме OpenTelemetry [`ToolCallArguments`](https://github.com/open-telemetry/semantic-conventions-genai/blob/e57c543b4889619eb2a05702471937db5119165d/model/gen-ai/gen-ai-tool-call-arguments.json). [`input`](https://platform.claude.com/docs/ru/api/messages#tool_use_block) использования инструмента. |
| `anthropic.tool_result.content` | `string` | Content Строка JSON с массивом блоков содержимого или с одним объектом. `content` результата инструмента, который возвращается модели. Также для результата с ошибкой, за исключением Managed Agents, когда подключение к серверу MCP не удалось.
**API:** В Messages API строковый `content` становится массивом с одним блоком [`text`](https://platform.claude.com/docs/ru/api/messages#text_block). |
### `anthropic.compaction`
* **Источник:** API, для запросов Messages API.
* **Вид:** `INTERNAL`.
* **Родитель:** Span [`anthropic.messages.create`](https://platform.claude.com/docs/ru/api/opentelemetry/spans#anthropic-messages-create) для запроса.
* **Дочерние элементы:** Нет.
Span имеет [атрибуты использования токенов](https://platform.claude.com/docs/ru/api/opentelemetry/spans#token-usage) сжатия. В [`anthropic.messages.create`](https://platform.claude.com/docs/ru/api/opentelemetry/spans#anthropic-messages-create) использование сжатия находится в атрибутах `anthropic.usage.compaction.*`, а не в итоговых значениях `gen_ai.usage.*`.
| Атрибут | Тип | Описание |
| ------------ | -------- | ------------------------------------------------------------------------------------------------------------------------------- |
| `error.type` | `string` | [Тип ошибки](https://platform.claude.com/docs/ru/api/errors#http-errors) запроса, если запрос завершился сбоем во время сжатия. |
### `anthropic.session.outcome_evaluation`
* **Источник:** API, для сеансов Managed Agents.
* **Вид:** `INTERNAL`.
* **Родитель:** Span [`anthropic.session.turn`](https://platform.claude.com/docs/ru/api/opentelemetry/spans#anthropic-session-turn) хода, который начал итерацию, даже если этот ход завершается раньше итерации.
* **Дочерние элементы:** Нет.
Статус не задан, когда результат равен `interrupted`, и равен `OK` для любого другого результата.
Span имеет два из [атрибутов использования токенов](https://platform.claude.com/docs/ru/api/opentelemetry/spans#token-usage): `gen_ai.usage.input_tokens` и `gen_ai.usage.output_tokens`.
| Атрибут | Тип | Описание |
| -------------------------------------------------- | -------- | -------------------------------------------------------------------------------------------------------- |
| `anthropic.session.outcome.id` | `string` | ID результата, который оценивает итерация. |
| `anthropic.session.outcome_evaluation.result` | `string` | Результат итерации: `satisfied`, `needs_revision`, `max_iterations_reached`, `failed` или `interrupted`. |
| `anthropic.session.outcome_evaluation.iteration` | `int` | Номер итерации. |
| `anthropic.session.outcome_evaluation.explanation` | `string` | Content Объяснение результата от оценщика в виде обычного текста. |
### `anthropic.messages.tool_runner`
* **Источник:** SDK.
* **Вид:** `INTERNAL`.
* **Родитель:** Span, который является текущим в приложении при запуске цикла, или отсутствует, если текущего span нет.
* **Дочерние элементы:** Span [`anthropic.messages.create`](https://platform.claude.com/docs/ru/api/opentelemetry/spans#anthropic-messages-create) для каждого запроса в цикле и [span инструмента](https://platform.claude.com/docs/ru/api/opentelemetry/spans#anthropic-tool-use-anthropic-mcp-tool-use-and-anthropic-custom-tool-use) каждого использования инструмента, которое выполняет runner.
Span завершается вместе с циклом. Если приложение останавливает runner, статус не задаётся. Если код инструмента вызывает ошибку, его span инструмента получает статус `ERROR`, и цикл продолжается. Span не имеет атрибутов использования, поэтому считывайте использование из его дочерних span [`anthropic.messages.create`](https://platform.claude.com/docs/ru/api/opentelemetry/spans#anthropic-messages-create).
| Атрибут | Тип | Описание |
| ------------------------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `gen_ai.operation.name` | `string` | `invoke_agent` |
| `gen_ai.request.model` | `string` | Модель первого запроса в цикле. |
| `gen_ai.conversation.id` | `string` | ID разговора, переданный с помощью [параметра `conversation_id` (typescript, java, php: `conversationId`; csharp: `ConversationId`; go: `option.WithOpenTelemetryConversationID()`)](https://platform.claude.com/docs/ru/manage-claude/opentelemetry/sdk#configure-the-sdk). Отсутствует, если он не передан. |
| `error.type` | `string` | [Тип ошибки](https://platform.claude.com/docs/ru/api/errors#http-errors) запроса, который завершил цикл, если цикл завершился сбоем. `client_error`, когда сбой произошёл в самом runner. |
| `gen_ai.output.type` | `string` | `json`, когда запросы задают формат вывода JSON. В противном случае отсутствует. |
### `anthropic.messages.batches.`
* **Источник:** SDK, для каждого метода Message Batches.
* **Вид:** `CLIENT`.
* **Родитель:** Span, который является текущим в приложении при вызове метода, или отсутствует, если текущего span нет.
* **Дочерние элементы:** Нет.
Эти span также имеют атрибуты каждого [span SDK для запроса](https://platform.claude.com/docs/ru/api/opentelemetry/spans#anthropic-resources-method).
| Атрибут | Тип | Описание |
| --------------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| `anthropic.message.batch.id` | `string` | ID пакета, с которым работает метод, или, для `create`, ID нового пакета. Отсутствует в `list` и при неудачном `create`. |
| `anthropic.message.batch.request_count` | `int` | Только в `create`. Количество элементов в массиве [`requests`](https://platform.claude.com/docs/ru/api/messages/batches/create#create.requests). |
### `anthropic.sessions.`
* **Источник:** SDK и API.
* **Вид:** `CLIENT` от SDK, `SERVER` от API.
* **Родитель span SDK:** Span, который является текущим в приложении при вызове метода, или отсутствует, если текущего span нет.
* **Родитель span API:** Span в [заголовке `traceparent`](https://platform.claude.com/docs/ru/manage-claude/opentelemetry/api#connect-api-spans-to-your-own-traces) запроса, которым является span SDK, когда запрос поступает от SDK, или отсутствует без этого заголовка.
* **Дочерние элементы span SDK:** Span API для этого запроса.
* **Дочерние элементы span API:** Нет.
API создаёт span `anthropic.sessions.` для каждого аутентифицированного запроса к конечной точке [Sessions API](https://platform.claude.com/docs/ru/managed-agents/sessions). Запросы, которые платформа отправляет от имени пользователя, например сообщение, отправленное в Claude Console, или сеанс, запускаемый [запланированным развёртыванием](https://platform.claude.com/docs/ru/managed-agents/scheduled-deployments), также имеют такой span, каждый в новой трассировке.
| Span | Конечная точка |
| ------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------- |
| `anthropic.sessions.create` | [`POST /v1/sessions`](https://platform.claude.com/docs/ru/api/beta/sessions/create) |
| `anthropic.sessions.list` | [`GET /v1/sessions`](https://platform.claude.com/docs/ru/api/beta/sessions/list) |
| `anthropic.sessions.retrieve` | [`GET /v1/sessions/{session_id}`](https://platform.claude.com/docs/ru/api/beta/sessions/retrieve) |
| `anthropic.sessions.update` | [`POST /v1/sessions/{session_id}`](https://platform.claude.com/docs/ru/api/beta/sessions/update) |
| `anthropic.sessions.delete` | [`DELETE /v1/sessions/{session_id}`](https://platform.claude.com/docs/ru/api/beta/sessions/delete) |
| `anthropic.sessions.archive` | [`POST /v1/sessions/{session_id}/archive`](https://platform.claude.com/docs/ru/api/beta/sessions/archive) |
| `anthropic.sessions.events.send` | [`POST /v1/sessions/{session_id}/events`](https://platform.claude.com/docs/ru/api/beta/sessions/events/send) |
| `anthropic.sessions.events.list` | [`GET /v1/sessions/{session_id}/events`](https://platform.claude.com/docs/ru/api/beta/sessions/events/list) |
| `anthropic.sessions.events.stream` | [`GET /v1/sessions/{session_id}/events/stream`](https://platform.claude.com/docs/ru/api/beta/sessions/events/stream) |
| `anthropic.sessions.resources.add` | [`POST /v1/sessions/{session_id}/resources`](https://platform.claude.com/docs/ru/api/beta/sessions/resources/add) |
| `anthropic.sessions.resources.list` | [`GET /v1/sessions/{session_id}/resources`](https://platform.claude.com/docs/ru/api/beta/sessions/resources/list) |
| `anthropic.sessions.resources.retrieve` | [`GET /v1/sessions/{session_id}/resources/{resource_id}`](https://platform.claude.com/docs/ru/api/beta/sessions/resources/retrieve) |
| `anthropic.sessions.resources.update` | [`POST /v1/sessions/{session_id}/resources/{resource_id}`](https://platform.claude.com/docs/ru/api/beta/sessions/resources/update) |
| `anthropic.sessions.resources.delete` | [`DELETE /v1/sessions/{session_id}/resources/{resource_id}`](https://platform.claude.com/docs/ru/api/beta/sessions/resources/delete) |
| `anthropic.sessions.threads.list` | [`GET /v1/sessions/{session_id}/threads`](https://platform.claude.com/docs/ru/api/beta/sessions/threads/list) |
| `anthropic.sessions.threads.retrieve` | [`GET /v1/sessions/{session_id}/threads/{thread_id}`](https://platform.claude.com/docs/ru/api/beta/sessions/threads/retrieve) |
| `anthropic.sessions.threads.archive` | [`POST /v1/sessions/{session_id}/threads/{thread_id}/archive`](https://platform.claude.com/docs/ru/api/beta/sessions/threads/archive) |
| `anthropic.sessions.threads.events.list` | [`GET /v1/sessions/{session_id}/threads/{thread_id}/events`](https://platform.claude.com/docs/ru/api/beta/sessions/threads/events/list) |
| `anthropic.sessions.threads.events.stream` | [`GET /v1/sessions/{session_id}/threads/{thread_id}/stream`](https://platform.claude.com/docs/ru/api/beta/sessions/threads/events/stream) |
Span имеет [атрибуты сеанса](https://platform.claude.com/docs/ru/api/opentelemetry/spans#session-attributes). Span SDK также имеет атрибуты каждого [span SDK для запроса](https://platform.claude.com/docs/ru/api/opentelemetry/spans#anthropic-resources-method).
| Атрибут | Тип | Описание |
| ------------ | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `error.type` | `string` | [Тип ошибки](https://platform.claude.com/docs/ru/api/errors#http-errors) неудачного запроса, например `rate_limit_error`.
**SDK:** Также другие значения из [span SDK для запросов](https://platform.claude.com/docs/ru/api/opentelemetry/spans#anthropic-resources-method).
**API:** `api_error`, когда API закрыл соединение без ответа с ошибкой или когда поток завершился из-за сбоя в API. |
### `anthropic.environment.work`
* **Источник:** CLI и SDK на Python, TypeScript и Go.
* **Вид:** `INTERNAL`.
* **Родитель:** Span, который является текущим в приложении, когда environment worker или work poller получает рабочий элемент, или отсутствует, если текущего span нет. В `ant beta:worker poll` этот span является корневым.
* **Дочерние элементы:** Span для запросов, которые environment worker отправляет при обработке рабочего элемента, и [span инструмента](https://platform.claude.com/docs/ru/api/opentelemetry/spans#anthropic-tool-use-anthropic-mcp-tool-use-and-anthropic-custom-tool-use) каждого инструмента, который он запускает для рабочего элемента.
Environment worker и work poller — это [вспомогательные средства SDK](https://platform.claude.com/docs/ru/managed-agents/self-hosted-sandboxes#sdk-helpers), которые забирают рабочие элементы в самостоятельно размещённой песочнице. Они создают один span `anthropic.environment.work` для каждого рабочего элемента — с момента, когда опрос возвращает рабочий элемент, до завершения его обработки.
| Атрибут | Тип | Описание |
| ------------------------------- | -------- | ----------------------------------------------------------------------------------------------------------------- |
| `anthropic.environment.id` | `string` | ID окружения. |
| `anthropic.environment.work.id` | `string` | ID рабочего элемента. |
| `anthropic.session.id` | `string` | ID сеанса, к которому относится рабочий элемент. |
| `error.type` | `string` | `error.type` span для неудачного запроса, если обработку завершил запрос. `client_error` для любого другого сбоя. |
### `anthropic..`
* **Источник:** SDK.
* **Вид:** `CLIENT`.
* **Родитель:** Span, который является текущим в приложении при вызове метода, или отсутствует, если текущего span нет.
* **Дочерние элементы:** Нет.
Каждый метод SDK, который отправляет запрос и не имеет отдельного раздела на этой странице, создаёт span `anthropic..`, например `anthropic.models.list` или `anthropic.files.upload`. Запрос каждой последующей страницы списка имеет собственный span.
Span охватывает весь свой запрос, включая повторные попытки, и имеет каждый атрибут одноимённого span API, если у SDK есть это значение. SDK задаёт `http.request.method` и `http.route` при запуске span, поэтому сэмплер может их использовать.
Каждый span SDK для запроса, включая [`anthropic.messages.create`](https://platform.claude.com/docs/ru/api/opentelemetry/spans#anthropic-messages-create), [`anthropic.messages.count_tokens`](https://platform.claude.com/docs/ru/api/opentelemetry/spans#anthropic-messages-count-tokens) и [`anthropic.messages.batches.`](https://platform.claude.com/docs/ru/api/opentelemetry/spans#anthropic-messages-batches-method), имеет следующие атрибуты:
| Атрибут | Тип | Описание |
| --------------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `gen_ai.conversation.id` | `string` | ID разговора, переданный с помощью [параметра `conversation_id` (typescript, java, php: `conversationId`; csharp: `ConversationId`; go: `option.WithOpenTelemetryConversationID()`)](https://platform.claude.com/docs/ru/manage-claude/opentelemetry/sdk#configure-the-sdk). Если он не передан — ID потока сеанса в запросах Managed Agents, перечисленных в разделе [Атрибуты сеанса](https://platform.claude.com/docs/ru/api/opentelemetry/spans#session-attributes), и отсутствует в других запросах. |
| `anthropic..id` | `string` | Один атрибут для каждого ID в пути запроса и один для ID объекта, который создаёт метод. Имя берётся из пути в единственном числе, например `anthropic.session.id` или `anthropic.session.thread.id`. |
| `gen_ai.agent.id` | `string` | ID агента, в методах агентов. |
| `gen_ai.memory.store.id` | `string` | ID хранилища памяти, в методах хранилищ памяти. |
| `gen_ai.memory.record.id` | `string` | ID памяти, в методах памяти. |
| `http.request.resend_count` | `int` | Количество раз, когда SDK повторно отправлял запрос по любой причине, например при повторной попытке. Отсутствует, если SDK не отправлял его повторно. |
| `error.type` | `string` | [Тип ошибки](https://platform.claude.com/docs/ru/api/errors#http-errors) неудачного вызова, например `rate_limit_error`. HTTP-код состояния, например `502`, когда ответ с ошибкой не содержит типа ошибки. `connection_error`, `client_timeout_error` или `client_error`, когда вызов завершился сбоем в SDK. `api_error`, когда сервер досрочно завершил поток. |
| `server.address` | `string` | Хост базового URL клиента, по умолчанию `api.anthropic.com`. В клиенте облачной платформы — хост этой платформы. |
| `url.query` | `string` | Строка запроса URL, содержащая только параметры запроса, определённые конечной точкой. Отсутствует, если их нет. В режиме только метаданных отсутствует, когда запрос содержит конфиденциальный параметр, например `email`. |
| `url.full` | `string` | URL, составленный из `url.scheme`, `server.address`, порта (если он есть в базовом URL), `url.path` и `url.query`. В режиме только метаданных отсутствует всякий раз, когда этот режим опускает `url.query`. |