Claude Platform Docs

Справочник по спанам OpenTelemetry

Спаны OpenTelemetry и атрибуты спанов, которые генерируют Claude API и Anthropic SDK.

Чтобы получать спаны, см. Настройка OpenTelemetry с Anthropic SDK и Настройка OpenTelemetry с Claude API.

Имена и виды спанов

СвойствоСпаны SDKСпаны API
service.nameservice.name приложенияclaude-platform
Область инструментированияcom.anthropic.sdk.<language> или com.anthropic.sdk.cli, плюс .<platform> в клиенте облачной платформы, с версией пакетаcom.anthropic.claude-platform
Вид спанаCLIENT на спане для запроса, иначе INTERNALSERVER на спане для запроса, иначе 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.namestringПлатформа, которая обслуживает запрос: aws.bedrock в Amazon Bedrock (включая Mantle), gcp.vertex_ai в Google Cloud’s Agent Platform и anthropic во всех остальных случаях. Присутствует в каждом спане.
anthropic.organization.idstringID организации.
anthropic.workspace.idstringID рабочего пространства, в котором выполняется работа.
user.idstringID вашего конечного пользователя, если вы задали его в заголовке W3C baggage (например, baggage: user.id=4f2a). Он присутствует в спане API запроса и в каждом спане API под ним, например в ходах сессии, которые начинает запрос.
Используйте непрозрачный ID, например ключ пользователя в вашей базе данных.
Не указывайте в этом значении адрес электронной почты. Чтобы защитить конфиденциальность пользователей, API отбрасывает любой user.id, который его содержит.

Атрибуты спанов запросов

Каждый спан запроса также имеет следующие атрибуты, если в описании не указано иное:

АтрибутТипОписание
anthropic.request.idstringЗначение заголовка ответа request-id.
http.request.methodstringHTTP-метод запроса, например POST.
http.routestringПуть эндпоинта с заполнителями для его параметров пути, например /v1/sessions/{session_id}.
http.response.status_codeintКод состояния HTTP итогового ответа. Для потока — код состояния, отправленный вместе с заголовками. Отсутствует, если ответа не было.
server.addressstringХост, на который был отправлен запрос, например api.anthropic.com.
server.portintПорт URL запроса или порт по умолчанию для его схемы, если в URL его нет.
url.schemestringСхема URL, например https.
url.pathstringПуть URL, например /v1/messages.
url.querystringСтрока запроса URL, содержащая только те параметры запроса, которые определены в эндпоинте. Отсутствует, если таких параметров нет.
url.fullstringURL запроса.

Спаны API для запросов, отправленных через облачную платформу, например Claude Platform on AWS, не содержат server.address, server.port и url.full.

Атрибуты сессии

В сессии Managed Agents спаны имеют следующие атрибуты. Спаны сессии могут находиться в нескольких трассировках, поэтому, чтобы собрать представление сессии, например стенограмму, сгруппируйте её спаны по этим ID.

АтрибутТипОписание
anthropic.session.idstringID сессии. Отсутствует в спанах методов, которые не работают с одной сессией, например anthropic.sessions.list.
gen_ai.conversation.idstringID потока сессии, к которому относится спан. В 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
texttext
tool_use, server_tool_usetool_call, с anthropic_toolset_name для блока tool_use, у которого есть toolset_name, например computer
mcp_tool_usetool_call с anthropic_mcp_server_name
tool_result, mcp_tool_result, блок результата серверного инструмента, например web_search_tool_resulttool_call_response
thinkingreasoning без подписи блока thinking. Отсутствует в спанах Managed Agents, поскольку событие agent.thinking не содержит самого содержимого размышлений.
Любой другой блок, например imagetype блока с префиксом anthropic_, например anthropic_image. Часть не содержит других полей.

Каждое событие использования инструмента или результата инструмента Managed Agents также становится одной частью сообщения соглашений GenAI:

Событие Managed AgentsЧасть сообщения соглашений GenAI
agent.tool_use, agent.custom_tool_usetool_call
agent.mcp_tool_usetool_call с anthropic_mcp_server_name
user.tool_result, user.custom_tool_result, agent.tool_result, agent.mcp_tool_resulttool_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_tokensintВходные токены, включая чтение из кэша и запись в кэш.
gen_ai.usage.output_tokensintВыходные токены.
gen_ai.usage.cache_write.input_tokensintТокены, записанные в кэш подсказок. Отсутствует в спанах anthropic.session.outcome_evaluation.
anthropic.usage.cache_creation.ephemeral_5m_input_tokensintТокены, записанные в 5-минутный кэш. Только в спанах для запросов Messages API. В спане SDK для ответа с потоковой передачей — только токены, записанные до первого выходного токена.
anthropic.usage.cache_creation.ephemeral_1h_input_tokensintТокены, записанные в 1-часовой кэш. Только в спанах запросов Messages API. В спане SDK для ответа с потоковой передачей — только токены, записанные до первого выходного токена.
gen_ai.usage.cache_read.input_tokensintТокены, прочитанные из кэша подсказок. Отсутствует в спанах 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.namestringchat
gen_ai.request.modelstringmodelДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. запроса.
gen_ai.response.idstringidДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. ответа.
gen_ai.response.modelstringМодель, которая обслужила запрос. Она отличается от запрошенной модели, когда запрос использует псевдоним модели или когда запрос обслужила резервная модель.
anthropic.message.stop_reasonstringstop_reasonДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. ответа, например end_turn.
anthropic.response.service_tierstringУровень обслуживания, на котором был обслужен запрос: usage.service_tierДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. ответа. См. как запросам назначаются уровни.
error.typestringТип ошибки неудавшегося запроса, например rate_limit_error.
SDK: Также другие значения из раздела спаны SDK для запросов.
API: api_error, когда API завершает запрос без ответа с ошибкой.
gen_ai.response.time_to_first_chunkdoubleТолько в спанах для ответа с потоковой передачей. Количество секунд до первого события content_block_delta потока, если оно есть.
gen_ai.usage.reasoning.output_tokensintТокены размышлений, которые входят в число выходных токенов. Отсутствует, если токены размышлений не подсчитываются отдельно от остальных выходных токенов, например для модели, ответы которой не содержат подробностей о выходных токенах.
anthropic.usage.compaction.input_tokensintВходные токены сжатий запроса, включая чтение из кэша и запись в кэш. Не входят в gen_ai.usage.input_tokens. Отсутствует, если в запросе нет сжатия.
anthropic.usage.compaction.output_tokensintВыходные токены сжатий запроса. Не входят в gen_ai.usage.output_tokens. Отсутствует, если в запросе нет сжатия.
gen_ai.request.max_tokensintmax_tokensДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. запроса.
gen_ai.request.streambooleantrue, когда запрос задаёт stream: trueДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape.. В противном случае отсутствует.
gen_ai.request.reasoning.levelstringeffortДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. в output_configДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. запроса. Отсутствует, если запрос его не задаёт.
gen_ai.output.typestringjson, когда запрос задаёт формат вывода JSON. В противном случае отсутствует.
anthropic.request.service_tierstringservice_tierДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. запроса. Отсутствует, если запрос его не задаёт.
anthropic.thinking.typestringthinking.typeДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. запроса. Отсутствует, если запрос его не задаёт.
anthropic.thinking.budget_tokensintbudget_tokensДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. в объекте thinkingДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. запроса. Отсутствует, если запрос его не задаёт.
anthropic.betastring[]Имена бета-функций в заголовке anthropic-betaДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. запроса.
gen_ai.system_instructionsstringСодержимое Строка JSON, соответствующая схеме OpenTelemetry SystemInstructions. Системная подсказка systemДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. запроса.
gen_ai.input.messagesstringСодержимое Строка JSON, соответствующая схеме OpenTelemetry InputMessages. messagesДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. запроса.
gen_ai.output.messagesstringСодержимое Строка JSON, соответствующая схеме OpenTelemetry OutputMessages. contentДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. ответа в виде одного сообщения assistant.
SDK: Для потока — только когда приложение читает поток так, как описано в разделе Трассировка потока.
gen_ai.request.stop_sequencesstring[]Содержимое 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.modelstringМодель запроса.
anthropic.message.count_tokens.input_tokensintКоличество токенов в ответе. Это количество не является использованием. Не включайте его при суммировании использования токенов.

anthropic.sessions.create

То же, что и anthropic.sessions.<method>, за исключением следующих дочерних спанов и атрибутов:

  • Дочерние спаны спана SDK: Спан API для этого запроса.
  • Дочерние спаны спана API: Спан anthropic.session.turn первого хода, когда запрос содержит непустой initial_eventsДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape..
АтрибутТипОписание
gen_ai.agent.idstringID агента, на основе которого была создана сессия.
gen_ai.agent.namestringИмя этого агента.
SDK: Отсутствует, если запрос завершился с ошибкой.
gen_ai.request.modelstringМодель этого агента, которая выполняет основной поток.
SDK: Отсутствует, если запрос завершился с ошибкой.
anthropic.session.environment.idstringID окружения сессии.

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 хода, в котором был дан ответ, — для хода, который начинается потому, что агент в другом потоке ответил, например агент, вызванный основным агентом.
    • Нет родителя — для любого другого хода, например для хода, который начинается потому, что завершился запуск рабочего процесса.
  • Дочерние спаны:

Ход начинается, когда его поток переходит в состояние running, и заканчивается, когда поток выходит из него.

АтрибутТипОписание
gen_ai.operation.namestringinvoke_agent
gen_ai.agent.idstringID агента, который выполняет поток хода. Отсутствует в потоке советника.
gen_ai.agent.namestringИмя этого агента. anthropic.advisor в потоке советника.
gen_ai.request.modelstringМодель этого агента. В потоке советника — модель советника.
anthropic.session.turn.stop_reasonstringПочему ход завершился: stop_reason.typeДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. события session.thread_status_idleДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape., например requires_action. Отсутствует, если поток не перешёл в состояние простоя.
error.typestringerror.typeДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. события session.errorДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape., которое завершило ход, если ход завершился с ошибкой.
gen_ai.agent.descriptionstringОписание этого агента. Отсутствует в потоке советника или если у агента нет описания.
gen_ai.system_instructionsstringСодержимое Строка JSON, соответствующая схеме OpenTelemetry SystemInstructions. Системная подсказка, действующая для хода. Есть только в первом ходе потока. Отсутствует в потоке советника.
gen_ai.input.messagesstringСодержимое Строка JSON, соответствующая схеме OpenTelemetry InputMessages. Входные события хода: сообщения пользователя и результаты инструментов, события system.messageДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. и сообщения из других потоков. Отсутствует в потоке советника.
gen_ai.output.messagesstringСодержимое Строка JSON, соответствующая схеме OpenTelemetry OutputMessages. Выходные события хода: сообщения, использования инструментов и результаты инструментов агента.

anthropic.model_request

  • Источник: API, для запросов Messages API и сессий Managed Agents.
  • Вид: INTERNAL.
  • Родитель:
  • Дочерние спаны: Нет.

В Messages API каждый спан — это один запрос к модели в рамках запроса API.

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

АтрибутТипОписание
gen_ai.operation.namestringТолько в спанах сессий Managed Agents, где он равен chat. В Messages API операцией chat является спан anthropic.messages.create для запроса.
gen_ai.request.modelstringМодель запроса.
gen_ai.response.modelstringТолько в спанах запросов Messages API. Модель, которая выполнила запрос к модели.
error.typestringMessages 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 этим инструментом является инструмент выполнения кода.
  • Дочерние спаны спана SDK: Спаны, которые запускает код инструмента.
  • Дочерние спаны спана API: Спан инструмента для каждого использования инструмента из кода, который выполняет этот инструмент. Например, код, который выполняет инструмент выполнения кода, может использовать web_search.

Префикс имени спана зависит от типа инструмента:

API не генерирует спан инструмента в следующих случаях:

  • Модель запрашивает использование инструмента, который запускает приложение, например пользовательского инструмента. Если инструмент запускает средство запуска инструментов в SDK, его спан генерирует это средство запуска инструментов.
  • Managed Agents: Агент использует инструмент, который выполняется в самостоятельно размещённой песочнице. Его спан генерирует рабочий процесс в SDK, который выполняет инструмент. См. как трассировать самостоятельно размещённую песочницу.
  • Managed Agents: Агент использует мультиагентный инструмент или инструмент советника.
  • Managed Agents: Агент запрашивает использование инструмента, но сервер отклоняет использование в соответствии с политикой разрешений auto, или приложение отклоняет его в событии user.tool_confirmationДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape..
АтрибутТипОписание
gen_ai.operation.namestringexecute_tool
gen_ai.tool.namestringИмя инструмента, например bash. В спанах API имя инструмента MCP не содержит имени сервера. В Managed Agents, если подключение к серверу MCP не удалось, это имя, которое сгенерировала модель, и оно присутствует только в спанах в режиме содержимого.
gen_ai.tool.call.idstringMessages 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.namestringТолько в спанах API для инструментов MCP. Имя сервера MCP инструмента. В Messages API — server_nameДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. блока mcp_tool_useДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape..
gen_ai.conversation.idstringID потока сессии, как описано в разделе Атрибуты сессии. В средстве запуска инструментов Messages — ID беседы, переданный с помощью параметра conversation_id; отсутствует, если он не передан. Отсутствует в спанах API для запроса Messages API.
anthropic.session.idstringID сессии. Отсутствует для использования инструмента вне сессии Managed Agents, например в Messages API или в средстве запуска инструментов Messages.
anthropic.session.thread.idstringТолько в спанах SDK средства запуска инструментов сессии. ID потока сессии. Отсутствует для использования инструмента в основном потоке.
anthropic.tool.evaluated_permissionstringТолько в спанах, которые API генерирует в сессиях Managed Agents. Результат оценки политики разрешений для использования инструмента: allow или ask.
error.typestringТип ошибки, если использование инструмента завершилось с ошибкой: 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.descriptionstringТолько в спанах SDK. Описание в определении инструмента. Отсутствует, если описание пустое.
gen_ai.tool.typestringТолько в спанах SDK. function
gen_ai.tool.call.argumentsstringСодержимое Строка JSON, соответствующая схеме OpenTelemetry ToolCallArguments. inputДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. использования инструмента.
anthropic.tool_result.contentstringСодержимое Строка 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.modelstringМодель, запрошенная для сжатия, то есть modelДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. запроса.
gen_ai.response.modelstringМодель, которая выполнила сжатие. Она отличается от gen_ai.request.model, когда запрос использует псевдоним модели или когда запрос обслужила резервная модель.
error.typestringТип ошибки запроса, если запрос завершился сбоем во время сжатия.

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.idstringID результата, который оценивает итерация.
anthropic.session.outcome_evaluation.resultstringРезультат итерации: satisfied, needs_revision, max_iterations_reached, failed или interrupted.
anthropic.session.outcome_evaluation.iterationintНомер итерации.
anthropic.session.outcome_evaluation.explanationstringСодержимое Объяснение результата от оценщика в виде обычного текста.

anthropic.messages.tool_runner

  • Источник: SDK.
  • Вид: INTERNAL.
  • Родитель: Спан, который является текущим в приложении при запуске цикла, или отсутствует, если текущего спана нет.
  • Дочерние элементы: Спан anthropic.messages.create для каждого запроса в цикле и спан инструмента каждого использования инструмента, которое выполняет исполнитель.

Спан завершается вместе с циклом. Если приложение останавливает исполнитель, статус не задаётся. Если код инструмента вызывает ошибку, его спан инструмента получает статус ERROR, и цикл продолжается. Спан не имеет атрибутов использования, поэтому считывайте использование из его дочерних спанов anthropic.messages.create.

АтрибутТипОписание
gen_ai.operation.namestringinvoke_agent
gen_ai.request.modelstringМодель первого запроса в цикле.
gen_ai.conversation.idstringID разговора, переданный с помощью параметра conversation_id. Отсутствует, если он не передан.
error.typestringТип ошибки запроса, который завершил цикл, если цикл завершился сбоем. client_error, когда сбой произошёл в самом runner.
gen_ai.output.typestringjson, когда запросы задают формат вывода JSON. В противном случае отсутствует.

anthropic.messages.batches.<method>

  • Источник: SDK, для каждого метода Message Batches.
  • Вид: CLIENT.
  • Родитель: Спан, который является текущим в приложении при вызове метода, или отсутствует, если текущего спана нет.
  • Дочерние элементы: Нет.

Эти спаны также имеют атрибуты каждого спана SDK для запроса.

АтрибутТипОписание
anthropic.message.batch.idstringID пакета, с которым работает метод, или, для create, ID нового пакета. Отсутствует в list и при неудачном create.
anthropic.message.batch.request_countintТолько в 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, или сеанс, запускаемый запланированным развёртыванием, также имеют такой спан, каждый в новой трассировке.

Спан имеет атрибуты сеанса. Спан SDK также имеет атрибуты каждого спана SDK для запроса.

АтрибутТипОписание
error.typestringТип ошибки неудачного запроса, например 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.idstringID окружения.
anthropic.environment.work.idstringID рабочего элемента.
anthropic.session.idstringID сеанса, к которому относится рабочий элемент.
error.typestringerror.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.idstringID разговора, переданный с помощью параметра conversation_id. Если он не передан — ID потока сеанса, к которому относится спан, как описано в разделе Атрибуты сеанса, и отсутствует в спанах без потока.
anthropic.<resource>.idstringОдин атрибут для каждого ID в пути запроса и один для ID объекта, который создаёт метод. Имя берётся из пути в единственном числе, например anthropic.session.id или anthropic.session.thread.id.
gen_ai.agent.idstringID агента, в методах агентов.
gen_ai.memory.store.idstringID хранилища памяти, в методах хранилищ памяти.
gen_ai.memory.record.idstringID памяти, в методах памяти.
http.request.resend_countintКоличество раз, когда SDK повторно отправлял запрос по любой причине, например при повторной попытке. Отсутствует, если SDK не отправлял его повторно.
error.typestringТип ошибки неудачного вызова, например rate_limit_error. HTTP-код состояния, например 502, когда ответ с ошибкой не содержит типа ошибки. connection_error, client_timeout_error или client_error, когда вызов завершился сбоем в SDK. api_error, когда сервер досрочно завершил поток.
server.addressstringХост базового URL клиента, по умолчанию api.anthropic.com. В клиенте облачной платформы — хост этой платформы.
url.querystringСтрока запроса URL, содержащая только параметры запроса, определённые конечной точкой. Отсутствует, если их нет. В режиме только метаданных отсутствует, когда запрос содержит конфиденциальный параметр, например email.
url.fullstringURL, составленный из url.scheme, server.address, порта (если он есть в базовом URL), url.path и url.query. В режиме только метаданных отсутствует всякий раз, когда этот режим опускает url.query.

Эта страница была полезной?