Справочник APIOpenTelemetry
Справочник по спанам OpenTelemetry
Спаны OpenTelemetry и атрибуты спанов, которые генерируют Claude API и Claude SDK.
Чтобы настроить экспорт, см. Использование OpenTelemetry с Claude 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()отправляет запрос на отправку событий сессии, и его спаны имеют имяanthropic.sessions.events.send. - Спаны инструментов имеют фиксированное имя, пробел и имя инструмента, например
anthropic.tool_use bash.
Статус спана
OK: Шаг завершился.ERROR: Шаг завершился с ошибкой.- Не задан: Приложение отменило шаг, например когда оно отправило событие
user.interrupt.
Спан потока завершается, когда завершается поток. Если приложение закрывает поток досрочно, спан SDK имеет незаданный статус, поэтому спан SDK потока, который никогда не завершается, например anthropic.sessions.events.stream, имеет незаданный статус или ERROR.
Атрибуты
Атрибуты используют семантические соглашения OpenTelemetry для генеративного ИИ (gen_ai.*), если соответствующее соглашение существует. Атрибуты Anthropic начинаются с anthropic.. Спаны следуют соглашениям на момент коммита e57c543b от 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 запроса. |
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, кроме запросов к одному потоку. |
Атрибуты содержимого
Атрибуты, помеченные Content, присутствуют только в спанах в режиме содержимого, как от 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. Значения относятся к шагу каждого спана, например к запросу, запросу к модели или сжатию. Чтобы учесть каждый токен один раз, см. как подсчитывать токены в руководстве.
| Атрибут | Тип | Описание |
|---|---|---|
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, который он аутентифицирует. Он не генерирует спан для запроса к OpenAI-совместимой конечной точке POST /v1/chat/completions.
API генерирует один спан для запроса, даже когда его обслуживает резервная модель.
Спан имеет атрибуты использования токенов. Спан SDK также имеет атрибуты каждого спана SDK для запроса.
| Атрибут | Тип | Описание |
|---|---|---|
gen_ai.operation.name | string | chat |
gen_ai.request.model | string | model запроса. |
gen_ai.response.id | string | id ответа. |
gen_ai.response.model | string | Модель, которая обслужила запрос. Она отличается от запрошенной модели, когда запрос использует псевдоним модели или когда запрос обслужила резервная модель. |
anthropic.message.stop_reason | string | stop_reason ответа, например end_turn. |
anthropic.response.service_tier | string | Уровень обслуживания, на котором был обслужен запрос: usage.service_tier ответа. См. как запросам назначаются уровни. |
error.type | string | Тип ошибки неудавшегося запроса, например rate_limit_error.SDK: Также другие значения из раздела спаны SDK для запросов. 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 | Входные токены сжатий запроса, включая чтение из кэша и запись в кэш. Не входят в gen_ai.usage.input_tokens. Отсутствует, если в ответе нет сжатия. |
anthropic.usage.compaction.output_tokens | int | Выходные токены сжатий запроса. Не входят в gen_ai.usage.output_tokens. Отсутствует, если в ответе нет сжатия. |
gen_ai.request.max_tokens | int | max_tokens запроса. |
gen_ai.request.temperature | double | temperature запроса. Отсутствует, если запрос его не задаёт. |
gen_ai.request.top_p | double | top_p запроса. Отсутствует, если запрос его не задаёт. |
gen_ai.request.top_k | int | top_k запроса. Отсутствует, если запрос его не задаёт. |
gen_ai.request.stream | boolean | true, когда запрос задаёт stream: true. В противном случае отсутствует. |
gen_ai.request.reasoning.level | string | effort в output_config запроса. Отсутствует, если запрос его не задаёт. |
gen_ai.output.type | string | json, когда запрос задаёт формат вывода JSON. В противном случае отсутствует. |
anthropic.request.service_tier | string | service_tier запроса. Отсутствует, если запрос его не задаёт. |
anthropic.thinking.type | string | thinking.type запроса. Отсутствует, если запрос его не задаёт. |
anthropic.thinking.budget_tokens | int | budget_tokens в объекте thinking запроса. Отсутствует, если запрос его не задаёт. |
anthropic.beta | string[] | Только в спане SDK. Имена бета-функций в заголовке anthropic-beta запроса. |
gen_ai.system_instructions | string | Content Строка JSON, соответствующая схеме OpenTelemetry SystemInstructions. Системная подсказка system запроса. |
gen_ai.input.messages | string | Content Строка JSON, соответствующая схеме OpenTelemetry InputMessages. messages запроса. |
gen_ai.output.messages | string | Content Строка JSON, соответствующая схеме OpenTelemetry OutputMessages. content ответа в виде одного сообщения assistant.SDK: Для потока — только когда приложение читает поток так, как описано в разделе Трассировка потока. |
gen_ai.request.stop_sequences | string[] | Content stop_sequences запроса. |
Спаны запроса не содержат счётчиков использования серверных инструментов из ответа, таких как web_search_requests. Вместо этого API генерирует спан инструмента для каждого использования серверного инструмента.
anthropic.messages.count_tokens
- Источник: SDK. API не генерирует спан для
POST /v1/messages/count_tokens. - Вид:
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.
| Атрибут | Тип | Описание |
|---|---|---|
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. - Спан
anthropic.sessions.events.sendдля запроса, в котором было отправлено событие, — для хода, который начался из-за события, например событияuser.message. - Спан
anthropic.sessions.update— для хода, который возобновляется, потому что бюджет сессии был повышен или снят через запрос. - Спан
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 события session.thread_status_idle, например requires_action. Отсутствует, если поток не перешёл в состояние простоя. |
error.type | string | error.type события session.error, которое завершило ход, если ход завершился с ошибкой. |
gen_ai.agent.description | string | Описание этого агента. Отсутствует в потоке советника или если у агента нет описания. |
gen_ai.system_instructions | string | Content Строка JSON, соответствующая схеме OpenTelemetry SystemInstructions. Системная подсказка, действующая для хода. Есть только в первом ходе потока. Отсутствует в потоке советника. |
gen_ai.input.messages | string | Content Строка JSON, соответствующая схеме OpenTelemetry InputMessages. Входные события хода: сообщения пользователя и результаты инструментов, события system.message и сообщения из других потоков. Отсутствует в потоке советника. |
gen_ai.output.messages | string | Content Строка 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, это ход, который начинается из-за подтверждения. - Для использования инструмента из кода, который выполняет другой инструмент, — спан инструмента этого инструмента. В 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.
| Атрибут | Тип | Описание |
|---|---|---|
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, server_tool_use или mcp_tool_use.Managed Agents: ID события, в котором агент запросил использование инструмента: события agent.tool_use, agent.mcp_tool_use или agent.custom_tool_use. |
anthropic.mcp.server.name | string | Только в спанах API для инструментов MCP. Имя сервера MCP инструмента. В Messages API — server_name блока mcp_tool_use. |
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, например 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 | Content Строка JSON, соответствующая схеме OpenTelemetry ToolCallArguments. input использования инструмента. |
anthropic.tool_result.content | string | Content Строка JSON с массивом блоков содержимого или с одним объектом. content результата инструмента, который возвращается модели. Также для результата с ошибкой, за исключением Managed Agents, когда подключение к серверу MCP не удалось.API: В Messages API строковый content становится массивом с одним блоком text. |
anthropic.compaction
- Источник: API, для запросов Messages API.
- Вид:
INTERNAL. - Родитель: Span
anthropic.messages.createдля запроса. - Дочерние элементы: Нет.
Span имеет атрибуты использования токенов сжатия. В anthropic.messages.create использование сжатия находится в атрибутах anthropic.usage.compaction.*, а не в итоговых значениях gen_ai.usage.*.
| Атрибут | Тип | Описание |
|---|---|---|
error.type | string | Тип ошибки запроса, если запрос завершился сбоем во время сжатия. |
anthropic.session.outcome_evaluation
- Источник: API, для сеансов Managed Agents.
- Вид:
INTERNAL. - Родитель: Span
anthropic.session.turnхода, который начал итерацию, даже если этот ход завершается раньше итерации. - Дочерние элементы: Нет.
Статус не задан, когда результат равен interrupted, и равен OK для любого другого результата.
Span имеет два из атрибутов использования токенов: 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для каждого запроса в цикле и span инструмента каждого использования инструмента, которое выполняет runner.
Span завершается вместе с циклом. Если приложение останавливает runner, статус не задаётся. Если код инструмента вызывает ошибку, его span инструмента получает статус ERROR, и цикл продолжается. Span не имеет атрибутов использования, поэтому считывайте использование из его дочерних span 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. - Родитель: Span, который является текущим в приложении при вызове метода, или отсутствует, если текущего span нет.
- Дочерние элементы: Нет.
Эти span также имеют атрибуты каждого span SDK для запроса.
| Атрибут | Тип | Описание |
|---|---|---|
anthropic.message.batch.id | string | ID пакета, с которым работает метод, или, для create, ID нового пакета. Отсутствует в list и при неудачном create. |
anthropic.message.batch.request_count | int | Только в create. Количество элементов в массиве requests. |
anthropic.sessions.<method>
- Источник: SDK и API.
- Вид:
CLIENTот SDK,SERVERот API. - Родитель span SDK: Span, который является текущим в приложении при вызове метода, или отсутствует, если текущего span нет.
- Родитель span API: Span в заголовке
traceparentзапроса, которым является span SDK, когда запрос поступает от SDK, или отсутствует без этого заголовка. - Дочерние элементы span SDK: Span API для этого запроса.
- Дочерние элементы span API: Нет.
API создаёт span anthropic.sessions.<method> для каждого аутентифицированного запроса к конечной точке Sessions API. Запросы, которые платформа отправляет от имени пользователя, например сообщение, отправленное в Claude Console, или сеанс, запускаемый запланированным развёртыванием, также имеют такой span, каждый в новой трассировке.
Span имеет атрибуты сеанса. Span SDK также имеет атрибуты каждого span SDK для запроса.
| Атрибут | Тип | Описание |
|---|---|---|
error.type | string | Тип ошибки неудачного запроса, например rate_limit_error.SDK: Также другие значения из span SDK для запросов. 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 инструмента каждого инструмента, который он запускает для рабочего элемента.
Environment worker и work poller — это вспомогательные средства SDK, которые забирают рабочие элементы в самостоятельно размещённой песочнице. Они создают один 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.<resources>.<method>
- Источник: SDK.
- Вид:
CLIENT. - Родитель: Span, который является текущим в приложении при вызове метода, или отсутствует, если текущего span нет.
- Дочерние элементы: Нет.
Каждый метод SDK, который отправляет запрос и не имеет отдельного раздела на этой странице, создаёт span anthropic.<resources>.<method>, например anthropic.models.list или anthropic.files.upload. Запрос каждой последующей страницы списка имеет собственный span.
Span охватывает весь свой запрос, включая повторные попытки, и имеет каждый атрибут одноимённого span API, если у SDK есть это значение. SDK задаёт http.request.method и http.route при запуске span, поэтому сэмплер может их использовать.
Каждый span SDK для запроса, включая anthropic.messages.create, anthropic.messages.count_tokens и anthropic.messages.batches.<method>, имеет следующие атрибуты:
| Атрибут | Тип | Описание |
|---|---|---|
gen_ai.conversation.id | string | ID разговора, переданный с помощью параметра conversation_id. Если он не передан — ID потока сеанса в запросах Managed Agents, перечисленных в разделе Атрибуты сеанса, и отсутствует в других запросах. |
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. |
Was this page helpful?