Справочник по спанам OpenTelemetry
Спаны OpenTelemetry и атрибуты спанов, которые генерируют Claude API и Anthropic SDK.
Чтобы получать спаны, см. Настройка OpenTelemetry с Anthropic SDK и Настройка OpenTelemetry с Claude API.
Имена и виды спанов
| Свойство | Спаны SDK | Спаны API |
|---|---|---|
service.name | service.name приложения | claude-platform |
| Область инструментирования | com.anthropic.sdk.<language> или com.anthropic.sdk.cli, плюс .<platform> в клиенте облачной платформы, с версией пакета | com.anthropic.claude-platform |
| Вид спана | CLIENT на спане для запроса, иначе INTERNAL | SERVER на спане для запроса, иначе INTERNAL |
- Спаны для запросов («span» (спан) — единица трассировки) имеют имя метода API, соответствующего запросу:
anthropic., за которым следует путь метода в справочнике API, с точками вместо косых черт и безbeta. Например,client.beta.sessions.events.send()отправляет запрос на отправку событий сессииДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape., и его спаны имеют имяanthropic.sessions.events.send. - Спаны инструментов имеют фиксированное имя, пробел и имя инструмента, например
anthropic.tool_use bash.
Статус спана
OK: Шаг завершился.ERROR: Шаг завершился с ошибкой.- Не задан: Приложение отменило шаг, например когда оно отправило событие
user.interruptДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape..
Спан потока завершается, когда завершается поток. Если приложение закрывает поток досрочно, спан SDK имеет незаданный статус, поэтому спан SDK потока, который никогда не завершается, например anthropic.sessions.events.stream, имеет незаданный статус или ERROR.
Атрибуты
Атрибуты используют семантические соглашения OpenTelemetry для генеративного ИИ (gen_ai.*), если соответствующее соглашение существует. Атрибуты Anthropic начинаются с anthropic.. Спаны следуют соглашениям на момент коммита e57c543b от 24 сентября 2026 года. Соглашения всё ещё находятся в разработке.
Общие атрибуты
Любой спан может иметь следующие атрибуты:
| Атрибут | Тип | Описание |
|---|---|---|
gen_ai.provider.name | string | Платформа, которая обслуживает запрос: aws.bedrock в Amazon Bedrock (включая Mantle), gcp.vertex_ai в Google Cloud’s Agent Platform и anthropic во всех остальных случаях. Присутствует в каждом спане. |
anthropic.organization.id | string | ID организации. |
anthropic.workspace.id | string | ID рабочего пространства, в котором выполняется работа. |
user.id | string | ID вашего конечного пользователя, если вы задали его в заголовке W3C baggage (например, baggage: user.id=4f2a). Он присутствует в спане API запроса и в каждом спане API под ним, например в ходах сессии, которые начинает запрос.Используйте непрозрачный ID, например ключ пользователя в вашей базе данных. Не указывайте в этом значении адрес электронной почты. Чтобы защитить конфиденциальность пользователей, API отбрасывает любой user.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 запроса. |
Спаны API для запросов, отправленных через облачную платформу, например Claude Platform on AWS, не содержат server.address, server.port и url.full.
Атрибуты сессии
В сессии Managed Agents спаны имеют следующие атрибуты. Спаны сессии могут находиться в нескольких трассировках, поэтому, чтобы собрать представление сессии, например стенограмму, сгруппируйте её спаны по этим ID.
| Атрибут | Тип | Описание |
|---|---|---|
anthropic.session.id | string | ID сессии. Отсутствует в спанах методов, которые не работают с одной сессией, например anthropic.sessions.list. |
gen_ai.conversation.id | string | ID потока сессии, к которому относится спан. В SDK параметр conversation_id заменяет его вашим собственным ID беседы. Отсутствует в спанах SDK без потока, если не задан этот параметр, а также в спанах API для запросов к Sessions API, кроме запросов к одному потоку. |
Атрибуты содержимого
Атрибуты, помеченные Содержимое, присутствуют только в спанах в режиме содержимого, как от SDK, так и от API. См. чем различаются режимы содержимого в руководстве. Если это содержимое слишком велико, SDK и API сокращают его в соответствии с ограничениями содержимого и устанавливают 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, anthropic.model_request, anthropic.compaction и anthropic.session.outcome_evaluation. Значения относятся к шагу каждого спана, например к запросу, запросу к модели или сжатию. В спанах API для запроса к Messages API количество токенов — это токены, за которые выставляется счёт вашей организации, даже если запрос завершается ошибкой или приложение его отменяет. Спан anthropic.messages.create в SDK вместо этого содержит количество, которое сообщает ответ, поэтому для неудавшегося или отменённого запроса оно может быть меньше, чем в спане API, или отсутствовать. Чтобы учесть каждый токен один раз, см. как подсчитывать токены в руководстве.
| Атрибут | Тип | Описание |
|---|---|---|
gen_ai.usage.input_tokens | int | Входные токены, включая чтение из кэша и запись в кэш. |
gen_ai.usage.output_tokens | int | Выходные токены. |
gen_ai.usage.cache_write.input_tokens | int | Токены, записанные в кэш подсказок. Отсутствует в спанах 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. |
Спаны
Спан может поступать от SDK в приложении или от API, поэтому для каждого спана в этом справочнике указаны его источники. Описания, начинающиеся с Messages API: или Managed Agents:, относятся к спанам соответствующего продукта. Описания атрибутов, начинающиеся с источника, например SDK: или API:, относятся к спанам этого источника.
anthropic.messages.create
- Источник: SDK и API.
- Вид:
CLIENTот SDK,SERVERот API. - Родитель спана SDK: Спан, который является текущим в приложении в момент вызова метода. Если текущего спана нет, родителя нет.
- Родитель спана API: Спан из заголовка
traceparentзапроса, которым является спан SDK, если запрос поступает от SDK. Без этого заголовка спан API не имеет родителя. См. как отправлять заголовокtraceparent. - Дочерние спаны спана SDK: Спан API для этого запроса.
- Дочерние спаны спана API: Спан
anthropic.model_requestдля каждого запроса к модели, спан инструмента для каждого использования серверного инструмента или инструмента коннектора MCP, который API выполняет в запросе, и спанanthropic.compactionдля каждого сжатия.
SDK генерирует этот спан для каждого запроса Messages, с потоковой передачей или без неё.
API генерирует этот спан для каждого запроса POST /v1/messagesДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape., который он аутентифицирует. Он не генерирует спан для запроса к OpenAI-совместимой конечной точке POST /v1/chat/completions.
API генерирует один спан для запроса, даже когда его обслуживает резервная модель.
Спан имеет атрибуты использования токенов. Спан SDK также имеет атрибуты каждого спана SDK для запроса.
| Атрибут | Тип | Описание |
|---|---|---|
gen_ai.operation.name | string | chat |
gen_ai.request.model | string | modelДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. запроса. |
gen_ai.response.id | string | idДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. ответа. |
gen_ai.response.model | string | Модель, которая обслужила запрос. Она отличается от запрошенной модели, когда запрос использует псевдоним модели или когда запрос обслужила резервная модель. |
anthropic.message.stop_reason | string | stop_reasonДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. ответа, например end_turn. |
anthropic.response.service_tier | string | Уровень обслуживания, на котором был обслужен запрос: usage.service_tierДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. ответа. См. как запросам назначаются уровни. |
error.type | string | Тип ошибки неудавшегося запроса, например rate_limit_error.SDK: Также другие значения из раздела спаны SDK для запросов. API: api_error, когда API завершает запрос без ответа с ошибкой. |
gen_ai.response.time_to_first_chunk | double | Только в спанах для ответа с потоковой передачей. Количество секунд до первого события content_block_delta потока, если оно есть. |
gen_ai.usage.reasoning.output_tokens | int | Токены размышлений, которые входят в число выходных токенов. Отсутствует, если токены размышлений не подсчитываются отдельно от остальных выходных токенов, например для модели, ответы которой не содержат подробностей о выходных токенах. |
anthropic.usage.compaction.input_tokens | int | Входные токены сжатий запроса, включая чтение из кэша и запись в кэш. Не входят в gen_ai.usage.input_tokens. Отсутствует, если в запросе нет сжатия. |
anthropic.usage.compaction.output_tokens | int | Выходные токены сжатий запроса. Не входят в gen_ai.usage.output_tokens. Отсутствует, если в запросе нет сжатия. |
gen_ai.request.max_tokens | int | max_tokensДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. запроса. |
gen_ai.request.stream | boolean | true, когда запрос задаёт stream: trueДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape.. В противном случае отсутствует. |
gen_ai.request.reasoning.level | string | effortДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. в output_configДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. запроса. Отсутствует, если запрос его не задаёт. |
gen_ai.output.type | string | json, когда запрос задаёт формат вывода JSON. В противном случае отсутствует. |
anthropic.request.service_tier | string | service_tierДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. запроса. Отсутствует, если запрос его не задаёт. |
anthropic.thinking.type | string | thinking.typeДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. запроса. Отсутствует, если запрос его не задаёт. |
anthropic.thinking.budget_tokens | int | budget_tokensДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. в объекте thinkingДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. запроса. Отсутствует, если запрос его не задаёт. |
anthropic.beta | string[] | Имена бета-функций в заголовке anthropic-betaДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. запроса. |
gen_ai.system_instructions | string | Содержимое Строка JSON, соответствующая схеме OpenTelemetry SystemInstructions. Системная подсказка systemДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. запроса. |
gen_ai.input.messages | string | Содержимое Строка JSON, соответствующая схеме OpenTelemetry InputMessages. messagesДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. запроса. |
gen_ai.output.messages | string | Содержимое Строка JSON, соответствующая схеме OpenTelemetry OutputMessages. contentДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. ответа в виде одного сообщения assistant.SDK: Для потока — только когда приложение читает поток так, как описано в разделе Трассировка потока. |
gen_ai.request.stop_sequences | string[] | Содержимое stop_sequencesДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. запроса. |
Спаны запроса не содержат счётчиков использования серверных инструментов из ответа, таких как web_search_requests. Вместо этого API генерирует спан инструмента для каждого использования серверного инструмента.
anthropic.messages.count_tokens
- Источник: SDK. API не генерирует спан для
POST /v1/messages/count_tokensДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape.. - Вид:
CLIENT. - Родитель: Спан, который является текущим в приложении в момент вызова метода, или отсутствует, если текущего спана нет.
- Дочерние спаны: Нет.
| Атрибут | Тип | Описание |
|---|---|---|
gen_ai.request.model | string | Модель запроса. |
anthropic.message.count_tokens.input_tokens | int | Количество токенов в ответе. Это количество не является использованием. Не включайте его при суммировании использования токенов. |
anthropic.sessions.create
То же, что и anthropic.sessions.<method>, за исключением следующих дочерних спанов и атрибутов:
- Дочерние спаны спана SDK: Спан API для этого запроса.
- Дочерние спаны спана API: Спан
anthropic.session.turnпервого хода, когда запрос содержит непустойinitial_eventsДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape..
| Атрибут | Тип | Описание |
|---|---|---|
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.<method>, за исключением дочерних спанов спана API.
- Дочерние спаны спана SDK: Спан API для этого запроса.
- Дочерние спаны спана API: Спан
anthropic.session.turnкаждого хода, который начинается из-за событий запроса.
anthropic.sessions.update
То же, что и anthropic.sessions.<method>, за исключением дочерних спанов спана API.
- Дочерние спаны спана SDK: Спан API для этого запроса.
- Дочерние спаны спана API: Спан
anthropic.session.turnкаждого хода, который возобновляется, потому что запрос увеличивает или снимает бюджет сессии.
anthropic.session.turn
- Источник: API, для сессий Managed Agents.
- Вид:
INTERNAL. - Родитель: Зависит от того, почему начался ход:
- Спан
anthropic.sessions.create— для первого хода сессии, созданной с непустымinitial_eventsДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape.. - Спан
anthropic.sessions.events.sendдля запроса, в котором было отправлено событие, — для хода, который начался из-за события, например событияuser.messageДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape.. - Спан
anthropic.sessions.update— для хода, который возобновляется, потому что запрос повышает или снимает бюджет сессии. - Спан
anthropic.session.turnхода агента, которого запускает сессия, во время которого этот агент начал этот ход, — для хода в другом потоке. - Спан
anthropic.session.turnхода, в котором был дан ответ, — для хода, который начинается потому, что агент в другом потоке ответил, например агент, вызванный основным агентом. - Нет родителя — для любого другого хода, например для хода, который начинается потому, что завершился запуск рабочего процесса.
- Спан
- Дочерние спаны:
- Спан
anthropic.model_requestдля каждого запроса к модели в ходе. - Спан инструмента каждый раз, когда API выполняет инструмент в ходе, за исключением случаев, перечисленных в разделе о спанах инструментов.
- Спан
anthropic.session.turnдля каждого хода в другом потоке, начатого во время этого хода агентом, запускаемым сессией, или ответом этого хода. - Спан
anthropic.session.outcome_evaluationдля каждой итерации оценки результата, которую начинает этот ход.
- Спан
Ход начинается, когда его поток переходит в состояние running, и заканчивается, когда поток выходит из него.
| Атрибут | Тип | Описание |
|---|---|---|
gen_ai.operation.name | string | invoke_agent |
gen_ai.agent.id | string | ID агента, который выполняет поток хода. Отсутствует в потоке советника. |
gen_ai.agent.name | string | Имя этого агента. anthropic.advisor в потоке советника. |
gen_ai.request.model | string | Модель этого агента. В потоке советника — модель советника. |
anthropic.session.turn.stop_reason | string | Почему ход завершился: stop_reason.typeДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. события session.thread_status_idleДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape., например requires_action. Отсутствует, если поток не перешёл в состояние простоя. |
error.type | string | error.typeДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. события session.errorДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape., которое завершило ход, если ход завершился с ошибкой. |
gen_ai.agent.description | string | Описание этого агента. Отсутствует в потоке советника или если у агента нет описания. |
gen_ai.system_instructions | string | Содержимое Строка JSON, соответствующая схеме OpenTelemetry SystemInstructions. Системная подсказка, действующая для хода. Есть только в первом ходе потока. Отсутствует в потоке советника. |
gen_ai.input.messages | string | Содержимое Строка JSON, соответствующая схеме OpenTelemetry InputMessages. Входные события хода: сообщения пользователя и результаты инструментов, события system.messageДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. и сообщения из других потоков. Отсутствует в потоке советника. |
gen_ai.output.messages | string | Содержимое Строка JSON, соответствующая схеме OpenTelemetry OutputMessages. Выходные события хода: сообщения, использования инструментов и результаты инструментов агента. |
anthropic.model_request
- Источник: API, для запросов Messages API и сессий Managed Agents.
- Вид:
INTERNAL. - Родитель:
- Messages API: Спан
anthropic.messages.createдля запроса. - Managed Agents: Спан
anthropic.session.turnхода, который выполняет запрос.
- Messages API: Спан
- Дочерние спаны: Нет.
В Messages API каждый спан — это один запрос к модели в рамках запроса API.
Спан имеет атрибуты использования токенов.
| Атрибут | Тип | Описание |
|---|---|---|
gen_ai.operation.name | string | Только в спанах сессий Managed Agents, где он равен chat. В Messages API операцией chat является спан 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, если запрос завершился с ошибкой во время этого запроса к модели.Managed Agents: Если запрос к модели завершился с ошибкой — его тип ошибки, например rate_limit_error. api_error, если запрос к модели завершился с ошибкой без ответа. |
anthropic.tool_use, anthropic.mcp_tool_use и anthropic.custom_tool_use
- Источник: SDK и API.
- Имя:
anthropic.tool_use <tool>,anthropic.mcp_tool_use <tool>илиanthropic.custom_tool_use <tool>, где<tool>— имя инструмента. - Вид:
INTERNAL. - Родитель спана SDK: Спан, который является текущим в приложении в момент запуска инструмента; в средстве запуска инструментов Messages это спан
anthropic.messages.tool_runner. Если текущего спана нет, родителя нет. - Родитель спана API:
- Messages API: Спан
anthropic.messages.createдля запроса, в котором API выполняет инструмент. - Managed Agents: Спан
anthropic.session.turnхода, в котором выполняется инструмент. Для использования инструмента, которое ожидает событияuser.tool_confirmationДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape., это ход, который начинается из-за подтверждения. - Для использования инструмента из кода, который выполняет другой инструмент, — спан инструмента этого инструмента. В Messages API этим инструментом является инструмент выполнения кода.
- Messages API: Спан
- Дочерние спаны спана SDK: Спаны, которые запускает код инструмента.
- Дочерние спаны спана API: Спан инструмента для каждого использования инструмента из кода, который выполняет этот инструмент. Например, код, который выполняет инструмент выполнения кода, может использовать
web_search.
Префикс имени спана зависит от типа инструмента:
anthropic.tool_use <tool>— это спан каждого использования серверного инструмента в Messages API или инструмента из набора инструментов агента Managed Agents. API выполняет инструменты из набора инструментов агента, за исключением самостоятельно размещённой песочницы, где их выполняет рабочий процесс окружения.anthropic.mcp_tool_use <tool>— спан каждого использования инструмента MCP в SDK, в Messages API и в Managed Agents. В SDK это инструмент из вспомогательного средства MCP, который запускает средство запуска инструментов Messages или средство запуска инструментов сессии. В Messages API инструмент поступает из коннектора MCP. В Managed Agents, если подключение к серверу MCP не удаётся, имя спана не включает имя инструмента.anthropic.custom_tool_use <tool>— спан каждого использования инструмента, который определяет приложение и запускает средство запуска инструментов. Этот спан генерирует только SDK.
API не генерирует спан инструмента в следующих случаях:
- Модель запрашивает использование инструмента, который запускает приложение, например пользовательского инструмента. Если инструмент запускает средство запуска инструментов в SDK, его спан генерирует это средство запуска инструментов.
- Managed Agents: Агент использует инструмент, который выполняется в самостоятельно размещённой песочнице. Его спан генерирует рабочий процесс в SDK, который выполняет инструмент. См. как трассировать самостоятельно размещённую песочницу.
- Managed Agents: Агент использует мультиагентный инструмент или инструмент советника.
- Managed Agents: Агент запрашивает использование инструмента, но сервер отклоняет использование в соответствии с политикой разрешений
auto, или приложение отклоняет его в событииuser.tool_confirmationДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape..
| Атрибут | Тип | Описание |
|---|---|---|
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Доступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape., server_tool_useДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. или mcp_tool_useДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape..Managed Agents: ID события, в котором агент запросил использование инструмента: события agent.tool_useДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape., agent.mcp_tool_useДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. или agent.custom_tool_useДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape.. |
anthropic.mcp.server.name | string | Только в спанах API для инструментов MCP. Имя сервера MCP инструмента. В Messages API — server_nameДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. блока mcp_tool_useДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape.. |
gen_ai.conversation.id | string | ID потока сессии, как описано в разделе Атрибуты сессии. В средстве запуска инструментов Messages — ID беседы, переданный с помощью параметра conversation_id; отсутствует, если он не передан. Отсутствует в спанах 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. Результат оценки политики разрешений для использования инструмента: allow или ask. |
error.type | string | Тип ошибки, если использование инструмента завершилось с ошибкой: tool_error, когда код инструмента выбрасывает ошибку или когда инструмент возвращает результат с ошибкой.API: В Messages API результат с ошибкой серверного инструмента вместо этого содержит его error_codeДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape., например max_uses_exceeded. В Managed Agents, если подключение к серверу MCP не удалось, — mcp_authentication_failed_error, когда не удалась аутентификация, иначе mcp_connection_failed_error. Если запрос завершился с ошибкой во время использования инструмента — тип ошибки запроса. |
gen_ai.tool.description | string | Только в спанах SDK. Описание в определении инструмента. Отсутствует, если описание пустое. |
gen_ai.tool.type | string | Только в спанах SDK. function |
gen_ai.tool.call.arguments | string | Содержимое Строка JSON, соответствующая схеме OpenTelemetry ToolCallArguments. inputДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. использования инструмента. |
anthropic.tool_result.content | string | Содержимое Строка JSON с массивом блоков содержимого. content результата инструмента, который возвращается модели. Также для результата с ошибкой, за исключением Managed Agents, когда подключение к серверу MCP не удалось. Строковый content становится массивом с одним блоком textДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape..API: В Messages API content результата серверного инструмента, который является одним объектом, например code_execution_result, становится массивом с этим объектом. |
anthropic.compaction
- Источник: API, для запросов Messages API.
- Вид:
INTERNAL. - Родитель: Спан
anthropic.messages.createдля запроса. - Дочерние элементы: Нет.
Спан имеет атрибуты использования токенов сжатия. В anthropic.messages.create использование сжатия находится в атрибутах anthropic.usage.compaction.*, а не в итоговых значениях gen_ai.usage.*.
| Атрибут | Тип | Описание |
|---|---|---|
gen_ai.request.model | string | Модель, запрошенная для сжатия, то есть modelДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. запроса. |
gen_ai.response.model | string | Модель, которая выполнила сжатие. Она отличается от gen_ai.request.model, когда запрос использует псевдоним модели или когда запрос обслужила резервная модель. |
error.type | string | Тип ошибки запроса, если запрос завершился сбоем во время сжатия. |
anthropic.session.outcome_evaluation
- Источник: API, для сеансов Managed Agents.
- Вид:
INTERNAL. - Родитель: Спан
anthropic.session.turnхода, который начал итерацию, даже если этот ход завершается раньше итерации. - Дочерние элементы: Нет.
Статус не задан, когда результат равен interrupted, и равен OK для любого другого результата.
Спан имеет два из атрибутов использования токенов: 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 | Содержимое Объяснение результата от оценщика в виде обычного текста. |
anthropic.messages.tool_runner
- Источник: SDK.
- Вид:
INTERNAL. - Родитель: Спан, который является текущим в приложении при запуске цикла, или отсутствует, если текущего спана нет.
- Дочерние элементы: Спан
anthropic.messages.createдля каждого запроса в цикле и спан инструмента каждого использования инструмента, которое выполняет исполнитель.
Спан завершается вместе с циклом. Если приложение останавливает исполнитель, статус не задаётся. Если код инструмента вызывает ошибку, его спан инструмента получает статус ERROR, и цикл продолжается. Спан не имеет атрибутов использования, поэтому считывайте использование из его дочерних спанов anthropic.messages.create.
| Атрибут | Тип | Описание |
|---|---|---|
gen_ai.operation.name | string | invoke_agent |
gen_ai.request.model | string | Модель первого запроса в цикле. |
gen_ai.conversation.id | string | ID разговора, переданный с помощью параметра conversation_id. Отсутствует, если он не передан. |
error.type | string | Тип ошибки запроса, который завершил цикл, если цикл завершился сбоем. client_error, когда сбой произошёл в самом runner. |
gen_ai.output.type | string | json, когда запросы задают формат вывода JSON. В противном случае отсутствует. |
anthropic.messages.batches.<method>
- Источник: SDK, для каждого метода Message Batches.
- Вид:
CLIENT. - Родитель: Спан, который является текущим в приложении при вызове метода, или отсутствует, если текущего спана нет.
- Дочерние элементы: Нет.
Эти спаны также имеют атрибуты каждого спана SDK для запроса.
| Атрибут | Тип | Описание |
|---|---|---|
anthropic.message.batch.id | string | ID пакета, с которым работает метод, или, для create, ID нового пакета. Отсутствует в list и при неудачном create. |
anthropic.message.batch.request_count | int | Только в create. Количество элементов в массиве requestsДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape.. |
anthropic.sessions.<method>
- Источник: SDK и API.
- Вид:
CLIENTот SDK,SERVERот API. - Родитель спана SDK: Спан, который является текущим в приложении при вызове метода, или отсутствует, если текущего спана нет.
- Родитель спана API: Спан в заголовке
traceparentзапроса, которым является спан SDK, когда запрос поступает от SDK, или отсутствует без этого заголовка. - Дочерние элементы спана SDK: Спан API для этого запроса.
- Дочерние элементы спана API: Нет.
API создаёт спан anthropic.sessions.<method> для каждого аутентифицированного запроса к конечной точке Sessions API. Запросы, которые платформа отправляет от имени пользователя, например сообщение, отправленное в Claude Console, или сеанс, запускаемый запланированным развёртыванием, также имеют такой спан, каждый в новой трассировке.
| Спан | Конечная точка |
|---|---|
anthropic.sessions.create | POST /v1/sessionsДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. |
anthropic.sessions.list | GET /v1/sessionsДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. |
anthropic.sessions.retrieve | GET /v1/sessions/{session_id}Доступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. |
anthropic.sessions.update | POST /v1/sessions/{session_id}Доступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. |
anthropic.sessions.delete | DELETE /v1/sessions/{session_id}Доступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. |
anthropic.sessions.archive | POST /v1/sessions/{session_id}/archiveДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. |
anthropic.sessions.events.send | POST /v1/sessions/{session_id}/eventsДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. |
anthropic.sessions.events.list | GET /v1/sessions/{session_id}/eventsДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. |
anthropic.sessions.events.stream | GET /v1/sessions/{session_id}/events/streamДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. |
anthropic.sessions.resources.add | POST /v1/sessions/{session_id}/resourcesДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. |
anthropic.sessions.resources.list | GET /v1/sessions/{session_id}/resourcesДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. |
anthropic.sessions.resources.retrieve | GET /v1/sessions/{session_id}/resources/{resource_id}Доступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. |
anthropic.sessions.resources.update | POST /v1/sessions/{session_id}/resources/{resource_id}Доступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. |
anthropic.sessions.resources.delete | DELETE /v1/sessions/{session_id}/resources/{resource_id}Доступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. |
anthropic.sessions.threads.list | GET /v1/sessions/{session_id}/threadsДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. |
anthropic.sessions.threads.retrieve | GET /v1/sessions/{session_id}/threads/{thread_id}Доступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. |
anthropic.sessions.threads.archive | POST /v1/sessions/{session_id}/threads/{thread_id}/archiveДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. |
anthropic.sessions.threads.events.list | GET /v1/sessions/{session_id}/threads/{thread_id}/eventsДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. |
anthropic.sessions.threads.events.stream | GET /v1/sessions/{session_id}/threads/{thread_id}/streamДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. |
Спан имеет атрибуты сеанса. Спан SDK также имеет атрибуты каждого спана SDK для запроса.
| Атрибут | Тип | Описание |
|---|---|---|
error.type | string | Тип ошибки неудачного запроса, например rate_limit_error.SDK: Также другие значения из спанов SDK для запросов. API: api_error, когда API закрыл соединение без ответа с ошибкой или когда поток завершился из-за сбоя в API. |
anthropic.environment.work
- Источник: CLI и SDK на Python, TypeScript и Go.
- Вид:
INTERNAL. - Родитель: Спан, который является текущим в приложении, когда воркер среды или опрашивающий процесс очереди работ получает рабочий элемент, или отсутствует, если текущего спана нет. В
ant beta:worker pollэтот спан является корневым. - Дочерние элементы: Спаны для запросов, которые воркер среды отправляет при обработке рабочего элемента, и спан инструмента каждого инструмента, который он запускает для рабочего элемента.
Воркер среды и опрашивающий процесс очереди работ — это вспомогательные средства SDK, которые забирают рабочие элементы в самостоятельно размещённой песочнице. Они создают один спан anthropic.environment.work для каждого рабочего элемента — с момента, когда опрос возвращает рабочий элемент, до завершения его обработки.
| Атрибут | Тип | Описание |
|---|---|---|
anthropic.environment.id | string | ID окружения. |
anthropic.environment.work.id | string | ID рабочего элемента. |
anthropic.session.id | string | ID сеанса, к которому относится рабочий элемент. |
error.type | string | error.type спана для неудачного запроса, если обработку завершил запрос. client_error для любого другого сбоя. |
anthropic.<resources>.<method>
- Источник: SDK.
- Вид:
CLIENT. - Родитель: Спан, который является текущим в приложении при вызове метода, или отсутствует, если текущего спана нет.
- Дочерние элементы: Нет.
Каждый метод SDK, который отправляет запрос и не имеет отдельного раздела на этой странице, создаёт спан anthropic.<resources>.<method>, например anthropic.models.list или anthropic.files.upload. Запрос каждой последующей страницы списка имеет собственный спан.
Спан охватывает весь свой запрос, включая повторные попытки, и имеет каждый атрибут одноимённого спана API, если у SDK есть это значение. SDK задаёт http.request.method и http.route при запуске спана, поэтому сэмплер может их использовать.
Каждый спан SDK для запроса, включая anthropic.messages.create, anthropic.messages.count_tokens и anthropic.messages.batches.<method>, имеет следующие атрибуты:
| Атрибут | Тип | Описание |
|---|---|---|
gen_ai.conversation.id | string | ID разговора, переданный с помощью параметра conversation_id. Если он не передан — ID потока сеанса, к которому относится спан, как описано в разделе Атрибуты сеанса, и отсутствует в спанах без потока. |
anthropic.<resource>.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 | Тип ошибки неудачного вызова, например 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. |
Эта страница была полезной?