Anthropic додає експорт трас OpenTelemetry на платформі Claude

14 жовтня 2026 року Anthropic оголосила, що розробники вже можуть надсилати траси з Claude Managed Agents, Messages API та Claude SDK до будь-якого інструмента спостережуваності, який підтримує стандарт; функція доступна в публічній бета-версії.

У оголошенні Anthropic компанія повідомила, що додавання пункту призначення в 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 Platform на 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. У спанах запитів спочатку вилучаються системний запит і найдавніші повідомлення, а зображення та документи відображаються лише із зазначенням їхнього типу.

Для організацій, на які поширюються обмеження Anthropic щодо обробки даних HIPAA, FERPA або K–12, із пунктів призначення експортуються лише метадані незалежно від налаштованого режиму вмісту, однак це не впливає на спани SDK. За умов нульового зберігання даних режим «Повний вміст» залишається доступним, оскільки API зберігає експортований вміст лише в пам’яті, доки не передасть його до пункту призначення. На Claude Managed Agents не поширюється режим нульового зберігання даних, а умови зберігання даних для цього продукту не змінюються під час використання OpenTelemetry.

Щоб підрахувати токени, документація радить рахувати кожен токен лише один раз: для цього потрібно підсумовувати спани лише з одного джерела для кожного запиту, а якщо запит має спани і SDK, і API — використовувати спани API. Також у документації зазначено, що спани можуть надходити повторно, якщо доставку виконують ще раз.

Названі інтеграції та відгуки перших клієнтів

В оголошенні підтримувані платформи спостережуваності згруповано за сценаріями використання. Для налагодження агентів разом з іншими компонентами програмного стека названо Grafana Cloud, Honeycomb, Sentry і Splunk: траси агентів відображаються поряд із журналами та метриками, тож розробники можуть бачити, який сервіс спричинив затримку або збій на певному етапі. Для вдосконалення агентів за допомогою виробничих даних названо Arize AI, Braintrust, Datadog, Langfuse, LangSmith by 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. Завдяки цьому кожен виклик моделі потрапляє в той самий трейс, що й процес звіряння або створення бухгалтерського запису, у межах якого його виконано. Тож компанія може відповідати на запитання аудиторів про дії агента, спираючись на єдину часову шкалу.