---
title: OpenTelemetry для Claude API
url: https://platform.claude.com/docs/ru/manage-claude/opentelemetry
description: Трассируйте запросы к Messages API, использования инструментов и сеансы Managed Agents с помощью спанов OpenTelemetry из Claude SDK и Claude API.
featureMetadata:
  topic:
    title: OpenTelemetry
    url: https://platform.claude.com/docs/en/manage-claude/opentelemetry
  status: beta
---

<Note>
  Экспорт OpenTelemetry находится в бета-версии. Он предоставляется в соответствии с вашим соглашением с Anthropic, включая раздел Beta Services в [Условиях для отдельных сервисов](https://www.anthropic.com/legal/service-specific-terms).
</Note>

Claude API и SDK могут трассировать ваши запросы к Messages API, использование инструментов и сеансы Managed Agents с помощью [OpenTelemetry](https://opentelemetry.io/). Вы можете просматривать эти трассировки в уже имеющейся у вас платформе наблюдаемости. Используйте их для отладки неудачных или медленных запросов, отслеживания расхода токенов и задержки, а также для создания оценок на основе реального трафика. Вы также можете видеть каждый запрос внутри собственных трассировок вашего приложения, связанный с пользователем или функцией, которые его отправили.

OpenTelemetry — это независимый от поставщиков стандарт, который поддерживают большинство платформ наблюдаемости. *Trace* (трассировка) — это полная запись одного запроса, проходящего через вашу систему. *Span* (спан) — это один шаг в трассировке, например запрос к модели или использование инструмента. API и SDK используют атрибуты из [семантических соглашений GenAI](https://github.com/open-telemetry/semantic-conventions-genai), поэтому платформы, поддерживающие эти соглашения, могут распознавать спаны без дополнительной настройки.

## Начало работы

Можно настроить трассировку SDK, трассировку API или обе. Настройте обе, чтобы видеть спаны SDK и API одного запроса в одной трассировке, как в [примерах трассировок](https://platform.claude.com/docs/ru/manage-claude/opentelemetry#example-traces-and-how-to-read-them). Для запросов к Claude Platform on AWS спаны API вместо этого находятся в собственных трассировках.

<CardGroup cols={3}>
  <Card title="Настройка трассировки SDK" icon="code-brackets" href="https://platform.claude.com/docs/ru/manage-claude/opentelemetry/sdk" layout="horizontal">
    Установите SDK и зарегистрируйте провайдер трассировщика.
  </Card>

  <Card title="Настройка трассировки API" icon="cloud" href="https://platform.claude.com/docs/ru/manage-claude/opentelemetry/api" layout="horizontal">
    Добавьте назначение в Claude Console.
  </Card>

  <Card title="Справочник по спанам" icon="book" href="https://platform.claude.com/docs/ru/api/opentelemetry/spans" layout="horizontal">
    Найдите спаны и их атрибуты.
  </Card>
</CardGroup>

| Что вы получаете                                                                                                                                      | Трассировка SDK                                                            | Трассировка API                                                                                    | Обе вместе                                                                                         |
| ----------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
| Запросов к [Messages API](https://platform.claude.com/docs/ru/api/messages/create)                                                                    | ✅                                                                          | ✅                                                                                                  | ✅                                                                                                  |
| Запросов к [Sessions API](https://platform.claude.com/docs/ru/managed-agents/sessions)                                                                | ✅                                                                          | ✅                                                                                                  | ✅                                                                                                  |
| [Использование токенов](https://platform.claude.com/docs/ru/manage-claude/opentelemetry#count-tokens)                                                 | ✅                                                                          | ✅                                                                                                  | ✅                                                                                                  |
| Каждый запуск модели в рамках запроса                                                                                                                 | —                                                                          | ✅                                                                                                  | ✅                                                                                                  |
| Ходы [Managed Agents](https://platform.claude.com/docs/ru/managed-agents/overview)                                                                    | —                                                                          | ✅                                                                                                  | ✅                                                                                                  |
| [Серверные инструменты](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/server-tools), запускаемые API                                  | —                                                                          | ✅                                                                                                  | ✅                                                                                                  |
| Клиентские инструменты, запускаемые [tool runner](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/tool-runner)                          | ✅                                                                          | —                                                                                                  | ✅                                                                                                  |
| Инструменты в [самостоятельно размещённой песочнице](https://platform.claude.com/docs/ru/manage-claude/opentelemetry/sdk#trace-a-self-hosted-sandbox) | ✅                                                                          | —                                                                                                  | ✅                                                                                                  |
| Другие запросы к API, например загрузка файлов                                                                                                        | ✅                                                                          | —                                                                                                  | ✅                                                                                                  |
| Настройка                                                                                                                                             | [Код](https://platform.claude.com/docs/ru/manage-claude/opentelemetry/sdk) | [Console](https://platform.claude.com/docs/ru/manage-claude/opentelemetry/api)                     | Обе                                                                                                |
| Необходимое разрешение                                                                                                                                | Не требуется                                                               | [Администратор](https://platform.claude.com/docs/ru/manage-claude/opentelemetry/api#what-you-need) | [Администратор](https://platform.claude.com/docs/ru/manage-claude/opentelemetry/api#what-you-need) |
| Охват                                                                                                                                                 | Клиенты, использующие SDK                                                  | Любой клиент                                                                                       | Любой клиент                                                                                       |
| Поддержка облачных платформ                                                                                                                           | Любая                                                                      | Claude Platform<br />Claude Platform on AWS                                                        | Claude Platform<br />Claude Platform on AWS                                                        |

Для Claude Code, Agent SDK или Cowork см. [мониторинг Claude Code](https://code.claude.com/docs/en/monitoring-usage), [наблюдаемость Agent SDK](https://code.claude.com/docs/en/agent-sdk/observability) или [мониторинг активности Cowork](https://support.claude.com/en/articles/14477985-monitor-claude-cowork-activity-with-opentelemetry).

## Отправка трассировок на партнерскую платформу

Отправляйте трассировки в любую платформу наблюдаемости, которая принимает OTLP, включая следующих партнеров:

<CardGroup cols={3}>
  <Card title="Arize AI" image="https://platform.claude.com/docs/images/partner-logos/arize.svg" imageDark="https://platform.claude.com/docs/images/partner-logos/arize-dark.svg" imageOffsetLeft={2} href="https://arize.com/docs/ax/integrations/platforms/claude-managed-agents/claude-managed-agents-tracing">
    Единая платформа наблюдаемости и оценки для ИИ.
  </Card>

  <Card title="Braintrust" image="https://platform.claude.com/docs/images/partner-logos/braintrust.svg" imageDark="https://platform.claude.com/docs/images/partner-logos/braintrust-dark.svg" imageHeight={25} imageOffsetLeft={1} href="https://www.braintrust.dev/docs/integrations/ai-providers/anthropic#export-opentelemetry-traces-from-the-claude-api">
    Платформа активной наблюдаемости для агентов.
  </Card>

  <Card title="Databricks" image="https://platform.claude.com/docs/images/partner-logos/databricks.svg" imageDark="https://platform.claude.com/docs/images/partner-logos/databricks-dark.svg" imageHeight={26} imageOffsetLeft={1} href="https://docs.databricks.com/aws/en/ai-gateway/unified-trace-table">
    Единая плоскость управления ИИ для наблюдаемости и оценки.
  </Card>

  <Card title="Datadog" image="https://platform.claude.com/docs/images/partner-logos/datadog.svg" imageDark="https://platform.claude.com/docs/images/partner-logos/datadog-dark.svg" imageHeight={28} imageOffsetLeft={2} href="https://docs.datadoghq.com/llm_observability/instrument/otel_instrumentation/?tab=python#using-claude-managed-agents">
    Наблюдаемость и безопасность на основе ИИ.
  </Card>

  <Card title="Grafana Cloud" image="https://platform.claude.com/docs/images/partner-logos/grafana.svg" imageDark="https://platform.claude.com/docs/images/partner-logos/grafana-dark.svg" imageHeight={34} imageOffsetLeft={2} href="https://grafana.com/docs/grafana-cloud/observe-and-act/agent-observability/guides/send-claude-platform-traces/">
    Полностью управляемая открытая платформа наблюдаемости.
  </Card>

  <Card title="Honeycomb" image="https://platform.claude.com/docs/images/partner-logos/honeycomb.svg" imageDark="https://platform.claude.com/docs/images/partner-logos/honeycomb-dark.svg" imageHeight={36} imageOffsetLeft={4} href="https://docs.honeycomb.io/send-data/use-cases/claude-platform">
    Платформа наблюдаемости для программного обеспечения нового типа.
  </Card>

  <Card title="Langfuse" image="https://platform.claude.com/docs/images/partner-logos/langfuse.svg" imageDark="https://platform.claude.com/docs/images/partner-logos/langfuse-dark.svg" imageHeight={26} imageOffsetLeft={1} href="https://langfuse.com/integrations/model-providers/claude-platform">
    Платформа с открытым исходным кодом для наблюдаемости и оценки агентов.
  </Card>

  <Card title="LangSmith" image="https://platform.claude.com/docs/images/partner-logos/langchain.svg" imageDark="https://platform.claude.com/docs/images/partner-logos/langchain-dark.svg" imageHeight={29} href="https://docs.langchain.com/langsmith/trace-anthropic">
    Платформа LangSmith для разработки агентов.
  </Card>

  <Card title="New Relic" image="https://platform.claude.com/docs/images/partner-logos/new-relic.svg" imageHeight={27} imageOffsetLeft={1} href="https://docs.newrelic.com/docs/ai-monitoring/opentelemetry-ai-monitoring/#anthropic">
    Интеллектуальная платформа наблюдаемости.
  </Card>

  <Card title="PostHog" image="https://platform.claude.com/docs/images/partner-logos/posthog.svg" imageDark="https://platform.claude.com/docs/images/partner-logos/posthog-dark.svg" imageHeight={29} href="https://posthog.com/docs/ai-observability/installation/anthropic?tab=Claude+Platform&utm_source=anthropic&utm_campaign=anthropic-otel">
    Универсальная платформа для создания успешных продуктов.
  </Card>

  <Card title="Sentry" image="https://platform.claude.com/docs/images/partner-logos/sentry.svg" imageDark="https://platform.claude.com/docs/images/partner-logos/sentry-dark.svg" imageHeight={25} href="https://sentry.io/cookbook/trace-claude-platform-with-opentelemetry/">
    Отлаживайте сломанный код и некорректно работающих агентов.
  </Card>

  <Card title="Splunk" image="https://platform.claude.com/docs/images/partner-logos/splunk.svg" imageDark="https://platform.claude.com/docs/images/partner-logos/splunk-dark.svg" imageHeight={27} imageOffsetLeft={1} href="https://agent-observability-docs.splunk.com/sdk-api/third-party-integrations/claude">
    Наблюдайте за агентами, оценивайте и защищайте их.
  </Card>
</CardGroup>

## Режимы содержимого

У каждого назначения и каждого клиента SDK есть «content mode» (режим содержимого), который определяет, включают ли спаны подсказки и ответы модели. Задайте его, когда [добавляете назначение](https://platform.claude.com/docs/ru/manage-claude/opentelemetry/api#add-a-destination) или [настраиваете SDK](https://platform.claude.com/docs/ru/manage-claude/opentelemetry/sdk#configure-the-sdk).

* **Metadata only** (`metadata_only` в SDK): значение по умолчанию. Спаны включают идентификаторы, время, статус, количество токенов и выбранный вами текст, например имена и описания ваших агентов и инструментов, а также имена ваших серверов MCP.
* **Full content** (`content` в SDK): максимальная видимость. Спаны включают подсказки и ответы модели, а также всё, что входит в Metadata only.

С Full content вы также можете увидеть, почему выполнение завершилось сбоем или было медленным, читать полные диалоги и создавать оценки на основе реальных трассировок. В [справочнике по спанам OpenTelemetry](https://platform.claude.com/docs/ru/api/opentelemetry/spans) атрибуты, содержащие подсказки и ответы, помечены <Badge>Content</Badge>.

<Info>
  Ваша платформа наблюдаемости хранит это содержимое в соответствии со своими настройками доступа и хранения, поэтому убедитесь, что они соответствуют требованиям вашей организации.
</Info>

Если у вашей организации есть согласованное с Anthropic ограничение на обработку данных HIPAA, FERPA или K-12, назначения экспортируют только метаданные независимо от их режима содержимого. На спаны SDK это не влияет.

При [нулевом хранении данных](https://platform.claude.com/docs/ru/manage-claude/api-and-data-retention) вы по-прежнему можете использовать Full content. Для запросов к Messages API экспортируемое содержимое API хранит только в памяти, пока не доставит его по назначению. [Claude Managed Agents](https://platform.claude.com/docs/ru/managed-agents/overview) не поддерживает нулевое хранение данных, и его политика хранения данных не меняется при использовании OpenTelemetry.

### Ограничения содержимого

В режиме Full content каждый спан по умолчанию содержит до 0,75 MB содержимого. Этого достаточно для контекстного окна в 200k токенов, заполненного текстом на английском языке, и при этом спан остаётся в пределах ограничения в 1 MB на размер запроса, распространённого во многих платформах наблюдаемости и прокси. Если в качестве **Provider** выбрана партнёрская платформа, Console устанавливает ограничение, которое принимает эта платформа.

Когда содержимое превышает ограничение, SDK или API сокращает его и устанавливает `anthropic.content.truncated` в значение `true`. В спанах запросов сначала удаляются системная подсказка и самые ранние сообщения, а в спанах инструментов блоки удаляются с конца результата. Изображения и документы представлены только своим типом.

Измените ограничение в следующих случаях:

* **Ваша платформа наблюдаемости принимает полезные нагрузки большего размера:** увеличьте или снимите ограничение, чтобы длинные подсказки и ответы сохранялись целиком. Для полностью заполненного контекстного окна в 1M токенов требуется около 4 MB.
* **Ваша платформа наблюдаемости или прокси перед ней отклоняет большие запросы:** уменьшите ограничение.

В SDK задайте `traces.max_content_bytes` (typescript, java, php: `traces.maxContentBytes`; csharp: `Traces.MaxContentBytes`; go: `option.WithOpenTelemetryTracesMaxContentBytes()`). В Console при [добавлении назначения](https://platform.claude.com/docs/ru/manage-claude/opentelemetry/api#add-a-destination) установите для **Content mode** значение **Full content**, а затем задайте **Maximum content size in MB** в разделе **Advanced settings**.

## Примеры трассировок и как их читать

### Запрос к Messages API

Под спаном API запроса, который [создаёт сообщение](https://platform.claude.com/docs/ru/api/messages/create), API добавляет спан для каждого запроса к модели и спан инструмента для каждого использования серверного инструмента или инструмента MCP-коннектора, которое выполняет API.

В этом примере ваше приложение вызывает [tool runner](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/tool-runner) — вспомогательное средство SDK, которое запускает ваши инструменты и отправляет их результаты обратно Claude. Каждый запрос, который отправляет tool runner, имеет клиентский спан от SDK и серверный спан от API. Спаны появляются в следующем порядке:

1. Ваше приложение начинает спан `answer_question` и вызывает внутри него tool runner для Messages (показан как спан [`anthropic.messages.tool_runner`](https://platform.claude.com/docs/ru/api/opentelemetry/spans#anthropic-messages-tool-runner)).
2. Tool runner отправляет первый запрос (показан как первый клиентский спан [`anthropic.messages.create`](https://platform.claude.com/docs/ru/api/opentelemetry/spans#anthropic-messages-create) и спаны под ним). В этом запросе API запускает инструмент веб-поиска между двумя запросами к модели.
3. Во втором запросе к модели модель просит использовать пользовательский инструмент `get_weather`, поэтому первый запрос завершается.
4. Tool runner запускает `get_weather` (показан как спан `anthropic.custom_tool_use get_weather`).
5. Tool runner отправляет второй запрос с результатом инструмента (показан как второй клиентский спан `anthropic.messages.create` и спаны под ним).
6. Во втором запросе модель даёт окончательный ответ.

![Пример trace (трассировки) tool runner для Messages: два запроса с клиентскими и серверными span (спанами), запросы к модели, web\_search и get\_weather](https://platform.claude.com/docs/images/opentelemetry-sdk-trace-shape.svg)

SDK в вашем приложении создаёт спан [`anthropic.messages.tool_runner`](https://platform.claude.com/docs/ru/api/opentelemetry/spans#anthropic-messages-tool-runner), спан [`anthropic.custom_tool_use`](https://platform.claude.com/docs/ru/api/opentelemetry/spans#anthropic-tool-use-anthropic-mcp-tool-use-and-anthropic-custom-tool-use) и клиентский спан каждого запроса. Чтобы получить эти спаны, [настройте трассировку SDK](https://platform.claude.com/docs/ru/manage-claude/opentelemetry/sdk).

Использование токенов каждого запроса указано в нескольких его спанах. Чтобы учитывать каждый токен один раз, см. [Подсчёт токенов](https://platform.claude.com/docs/ru/manage-claude/opentelemetry#count-tokens).

С [Full content](https://platform.claude.com/docs/ru/manage-claude/opentelemetry#choose-a-content-mode) серверный спан `anthropic.messages.create` содержит подсказку и ответ. Системная подсказка находится в `gen_ai.system_instructions`, сообщения запроса — в `gen_ai.input.messages`, а ответ — в `gen_ai.output.messages`.

Описание каждого спана и его атрибутов см. в [справочнике по спанам OpenTelemetry](https://platform.claude.com/docs/ru/api/opentelemetry/spans).

### Сеанс Managed Agents

Сеанс содержит "span" (спан) для каждого запроса к Sessions API и спан хода для каждого хода агента. Ход, который запускается запросом, является дочерним по отношению к спану этого запроса. Ход содержит спан для каждого запроса к модели и для каждого инструмента, который запускает API, за исключением [случаев, перечисленных в справочнике по спанам инструментов](https://platform.claude.com/docs/ru/api/opentelemetry/spans#anthropic-tool-use-anthropic-mcp-tool-use-and-anthropic-custom-tool-use). Он также содержит спан для каждой оценки результата.

В этом примере рассматривается один запрос чата, в котором ваше приложение отправляет сообщение в сеанс и запускает пользовательский инструмент. "Trace" (трассировка) содержит спаны как от вашего приложения, так и от API в следующем порядке:

1. Ваше приложение получает от пользователя запрос `POST /chat`.
2. Ваше приложение запускает средство запуска инструментов сеанса (session tool runner) из SDK, которое получает список событий сеанса и передаёт их в потоковом режиме (показано как спаны `anthropic.sessions.events.stream` и `anthropic.sessions.events.list`).
3. Ваше приложение отправляет сообщение пользователя в сеанс, вызывая `sessions.events.send`.
4. Начинается ход, который включает запросы к модели, использование инструмента `bash` и ход в другом потоке (показано как первый спан `anthropic.session.turn` и спаны под ним).
5. Модель запрашивает использование [пользовательского инструмента](https://platform.claude.com/docs/ru/managed-agents/tools) `list_issues`, поэтому ход завершается с причиной остановки `requires_action`.
6. Средство запуска инструментов сеанса запускает `list_issues` (показано как спан `anthropic.custom_tool_use list_issues`) и отправляет его результат, вызывая `sessions.events.send`.
7. Второй ход начинается с результата инструмента (показано как последний спан `anthropic.session.turn`).

![Пример trace (трассировки) сеанса Managed Agents: ваш span (спан) POST /chat, запросы потока событий и списка событий средства запуска инструментов сеанса, клиентский и серверный спаны запроса, отправляющего сообщение пользователя, ход с запросами к модели, использованием инструмента bash и ходом в другом потоке, запуск list\_issues средством запуска, клиентский и серверный спаны запроса, отправляющего результат инструмента, и второй ход.](https://platform.claude.com/docs/images/opentelemetry-trace-shape.svg)

SDK в вашем приложении создаёт спан [`anthropic.custom_tool_use`](https://platform.claude.com/docs/ru/api/opentelemetry/spans#anthropic-tool-use-anthropic-mcp-tool-use-and-anthropic-custom-tool-use) и клиентский спан каждого запроса. Чтобы получать эти спаны, [настройте трассировку SDK](https://platform.claude.com/docs/ru/manage-claude/opentelemetry/sdk).

Спаны сеанса могут находиться в нескольких трассировках, например когда вы отправляете последующий запрос из новой корневой трассировки. При включённом [мультиагентном режиме](https://platform.claude.com/docs/ru/managed-agents/multiagent-orchestration) сеанс также может иметь несколько потоков. Чтобы найти нужные спаны, группируйте их по идентификатору.

* **Один поток:** группируйте спаны по `gen_ai.conversation.id`, который содержит идентификатор потока сеанса. Отсортируйте их по времени начала, чтобы прочитать поток как стенограмму.
* **Весь сеанс со всеми его потоками:** группируйте спаны по `anthropic.session.id` во всех трассировках.

В режиме [Full content](https://platform.claude.com/docs/ru/manage-claude/opentelemetry#choose-a-content-mode) вы можете прочитать содержимое сеанса по его спанам.

* Чтобы прочитать содержимое хода, используйте его [спан хода](https://platform.claude.com/docs/ru/api/opentelemetry/spans#anthropic-session-turn). Системная подсказка находится в `gen_ai.system_instructions` первого спана хода потока, входные данные — в `gen_ai.input.messages` (ваши сообщения и результаты инструментов, события `system.message` и сообщения из других потоков), а выходные данные — в `gen_ai.output.messages` (сообщения агента, использования инструментов и результаты инструментов).
* Чтобы увидеть аргументы и результат использования инструмента, прочитайте его [спан инструмента](https://platform.claude.com/docs/ru/api/opentelemetry/spans#anthropic-tool-use-anthropic-mcp-tool-use-and-anthropic-custom-tool-use). Аргументы находятся в `gen_ai.tool.call.arguments`, а результат — в `anthropic.tool_result.content`.

Описание каждого спана и его атрибутов см. в [справочнике по спанам OpenTelemetry](https://platform.claude.com/docs/ru/api/opentelemetry/spans).

## Подсчёт токенов

Чтобы учесть каждый токен один раз, суммируйте спаны только одного источника для каждого запроса. Если у запроса к Messages API есть и спан SDK, и спан API, суммируйте его спаны API. Оба называются `anthropic.messages.create`, поэтому различайте их по типу: спан SDK имеет тип `CLIENT`, а его дочерний спан, спан API, — тип `SERVER`.

Для каждого источника суммируйте только следующие спаны, поскольку некоторые атрибуты использования повторяются на нескольких уровнях спанов API:

* **Спаны SDK:** суммируйте спаны [`anthropic.messages.create`](https://platform.claude.com/docs/ru/api/opentelemetry/spans#anthropic-messages-create). Если у запроса есть [сжатия](https://platform.claude.com/docs/ru/build-with-claude/compaction), также добавьте атрибуты спана `anthropic.usage.compaction.input_tokens` и `anthropic.usage.compaction.output_tokens`, поскольку атрибуты `gen_ai.usage.*` не включают токены сжатия. Если запрос обслужила [резервная модель](https://platform.claude.com/docs/ru/build-with-claude/refusals-and-fallback), его спан содержит использование только той модели, которая сформировала ответ.
* **Спаны API запроса к Messages API:** суммируйте либо спаны [`anthropic.messages.create`](https://platform.claude.com/docs/ru/api/opentelemetry/spans#anthropic-messages-create), либо их спаны [`anthropic.model_request`](https://platform.claude.com/docs/ru/api/opentelemetry/spans#anthropic-model-request), но не те и другие одновременно. Если у запроса есть сжатия, также добавьте его спаны [`anthropic.compaction`](https://platform.claude.com/docs/ru/api/opentelemetry/spans#anthropic-compaction). Не добавляйте при этом атрибуты `anthropic.usage.compaction.*` спана `anthropic.messages.create`, поскольку они содержат те же токены.
* **Спаны API сеанса Managed Agents:** суммируйте спаны `anthropic.model_request` и [`anthropic.session.outcome_evaluation`](https://platform.claude.com/docs/ru/api/opentelemetry/spans#anthropic-session-outcome-evaluation).

Спаны могут поступать более одного раза, например если доставка повторяется. Если ваша платформа наблюдаемости не удаляет дубликаты, учитывайте каждый спан один раз по его идентификатору трассировки и идентификатору спана.

`gen_ai.usage.input_tokens` уже включает токены, прочитанные из кэша подсказок и записанные в него, поэтому не добавляйте к нему атрибуты кэша. Все атрибуты использования см. в разделе [Использование токенов](https://platform.claude.com/docs/ru/api/opentelemetry/spans#token-usage).

<Note>
  Экспортируемые спаны не обязательно являются полной записью использования API. Их доставка выполняется [без гарантий](https://platform.claude.com/docs/ru/manage-claude/opentelemetry/api#delivery-and-health), поэтому спан может быть потерян. Кроме того, вызывающая сторона может исключить спаны запроса, отключив флаг выборки в [заголовке `traceparent`](https://platform.claude.com/docs/ru/manage-claude/opentelemetry/api#connect-api-spans-to-your-own-traces) запроса. Чтобы отслеживать использование каждого ключа API, например чтобы обнаружить утёкший ключ, используйте [Usage API](https://platform.claude.com/docs/ru/manage-claude/usage-cost-api#usage-api), который также учитывает использование запросов без спанов.
</Note>