Модели и платформы ИИ
Anthropic добавила экспорт трасс OpenTelemetry на платформу Claude
Добавьте Unite.AI в избранные источники в Google
14 октября 2026 года Anthropic объявила, что разработчики теперь могут отправлять трассы из управляемых агентов Claude, Messages API и Claude SDK в любой инструмент наблюдаемости, поддерживающий этот стандарт. Функция доступна в открытой бета-версии.
В своём объявлении компания сообщила, что добавление пункта назначения в Claude Console позволяет передавать в инструмент наблюдаемости пользователя каждую итерацию агента, каждый вызов модели и каждое использование инструмента в виде стандартной трассы OpenTelemetry с данными о задержке, количестве токенов и идентификаторах. Для Managed Agents и Messages API необходимо указать пункт назначения в Console, тогда как Claude SDK экспортируют трассы автоматически. Разработчики, уже отправляющие трассы Claude Code или Cowork в инструмент наблюдаемости, смогут видеть там же и агентов, созданных на платформе Claude.
По словам Anthropic, трассы Claude соответствуют семантическим соглашениям OpenTelemetry для GenAI, поэтому данные Claude и других поставщиков можно использовать в одних и тех же инструментах и на одних и тех же панелях мониторинга. Трассы также совместимы с любым инструментом OpenTelemetry, поддерживающим стандартную конечную точку OTLP.
Два способа настройки и единая модель трассировки
В документации платформы Claude трасса определяется как полная запись одного запроса, проходящего через систему, а спан — как отдельный шаг трассы, например запрос к модели или использование инструмента. Описаны два способа настройки. Трассировку SDK настраивают в коде: устанавливают SDK и регистрируют поставщика трассировщика; специальных разрешений для этого не требуется. Трассировку API настраивают, добавляя пункт назначения в Claude Console; для этого нужны права администратора.
Набор собираемых данных зависит от выбранного способа. Трассировка API фиксирует каждый запуск модели в рамках запроса, итерации Managed Agents и серверные инструменты, выполняемые API. Трассировка SDK дополнительно фиксирует клиентские инструменты, запускаемые средством выполнения инструментов, инструменты в самостоятельно размещённой песочнице и другие запросы API, например загрузку файлов. При настройке обоих способов спаны SDK и API для одного запроса объединяются в одну трассу; однако для запросов к платформе Claude на AWS спаны API отображаются в отдельных трассах.
В Managed Agents для каждой сессии создаётся спан каждого запроса к Sessions API и спан каждой итерации агента; каждая итерация включает спаны каждого запроса к модели, каждого инструмента, запускаемого API, и каждой оценки результата. Пользователям Claude Code, Agent SDK и Cowork документация рекомендует обратиться к отдельным материалам о мониторинге и наблюдаемости для этих продуктов.
Режимы содержимого, ограничения и обработка данных
Для каждого пункта назначения и каждого клиента SDK можно задать режим содержимого, определяющий, будут ли спаны включать запросы к моделям и их ответы. Режим «Только метаданные», включённый по умолчанию, записывает идентификаторы, временные данные, статус, количество токенов и выбранный пользователем текст, например названия и описания агентов и инструментов, а также названия MCP-серверов. Режим «Полное содержимое» дополнительно включает запросы к моделям и их ответы.
В режиме «Полное содержимое» каждый спан по умолчанию может содержать до 0,75 МБ данных. Согласно документации, этого достаточно для контекстного окна объёмом 200 тыс. токенов с текстом на английском языке, и это меньше установленного многими платформами наблюдаемости и прокси-серверами ограничения на запрос в 1 МБ; для контекстного окна на 1 млн токенов требуется около 4 МБ. Если объём содержимого превышает лимит, SDK или API сокращает его и устанавливает атрибут anthropic.content.truncated в значение true. В спанах запроса сначала удаляются системный запрос и самые ранние сообщения, а изображения и документы указываются только по типу.
Для организаций, на которые распространяются ограничения HIPAA, FERPA или требования к обработке данных K–12 при работе с Anthropic, из пунктов назначения экспортируются только метаданные независимо от выбранного режима содержимого; при этом спаны SDK не затрагиваются. В режиме нулевого хранения данных можно использовать режим «Полное содержимое», поскольку API хранит экспортируемые данные только в памяти и лишь до их передачи в пункт назначения. Claude Managed Agents не поддерживает нулевое хранение данных, а условия хранения для него не меняются при использовании OpenTelemetry.
Для подсчёта токенов документация рекомендует учитывать каждый токен только один раз: суммировать спаны лишь из одного источника для каждого запроса, а если запрос включает спаны и SDK, и API — использовать спаны API. Также отмечается, что при повторной попытке доставки спаны могут поступить более одного раза.
Названные интеграции и первые отзывы клиентов
В объявлении поддерживаемые платформы наблюдаемости распределены по сценариям использования. Для отладки агентов вместе с остальными компонентами программного стека названы Grafana Cloud, Honeycomb, Sentry и Splunk. Трассы агентов отображаются рядом с журналами и метриками, помогая разработчикам определить, из-за какого сервиса возник медленный или неудачный шаг. Для улучшения агентов на основе производственных данных названы Arize AI, Braintrust, Datadog, Langfuse, LangSmith от LangChain, New Relic и PostHog. Среди описанных сценариев — использование реальных трасс для создания оценочных тестов и выявления проблем с качеством. Для отслеживания использования в организации названа Databricks Unity Gateway: с её помощью команды, отвечающие за платформу и безопасность, могут видеть расход токенов по командам и выявлять необычную активность.
В объявлении несколько первых клиентов рассказали о своём опыте внедрения. Сооснователь и технический директор Foxglove Роман Штыльман сообщил, что компания создаёт агентов, помогающих командам в сфере робототехники отлаживать роботов. По его словам, встроенный экспорт OpenTelemetry с платформы Claude позволяет анализировать взаимодействия агентов в PostHog наряду с данными об использовании продукта, чтобы оценивать работу агентов в реальных условиях и определять приоритеты улучшений для команд, занимающихся робототехникой.
Старший инженер-программист Ramp Дэвид Трейна рассказал, что компания создала Reflect — агентную систему, которая оценивает трейсы Langfuse, выявляет повторяющиеся сбои и предлагает способы их устранения. «На некоторых агентах нам уже удалось сократить расход токенов на 10–20% и ускорить сеансы на 30%», — сказал Трейна. Он добавил, что штатный экспорт OpenTelemetry из Claude API позволяет напрямую передавать данные телеметрии в этот цикл улучшений без каких-либо дополнительных действий.
Технический директор Sterling Labs Хён Ли рассказал, что штатный экспорт передает каждый трейс в Langfuse без необходимости настраивать специальную инструментацию для агентов компании, анализирующих рынки в реальном времени. Руководитель инфраструктурного направления FloQast Анкуш Шарма сообщил, что агенты компании, разрабатывающей бухгалтерское ПО, работают на Claude Platform, а данные телеметрии собираются в Grafana Cloud. Благодаря этому вызов каждой модели включен в тот же трейс, что и процесс сверки или проводки, в рамках которого он выполнялся, поэтому компания может по единой временной шкале ответить аудиторам на вопросы о действиях агента.
