Claude API научился слать трейсы в вашу систему мониторинга
Anthropic 14 октября открыла публичную бету экспорта трейсов OpenTelemetry из Claude API: на каждый запрос к модели и каждый вызов инструмента API сам отправляет спан в вашу систему наблюдаемости. Спан - запись об одном шаге с его длительностью и статусом. Код менять не нужно, достаточно, чтобы админ организации добавил точку назначения в Claude Console. По умолчанию уходят только метаданные, а промпты и ответы попадут в трейсы лишь после переключения на режим Full content. Принимающая сторона должна слушать OTLP/HTTP по HTTPS на порту 443.
Экспорт работает для Messages API и сессий Claude Managed Agents, в Claude API и в Claude Platform on AWS, так написано в документации Anthropic. В анонсе ClaudeDevs к этому списку добавлены Claude SDKs: для них экспорт настраивается отдельно, на стороне клиента. Спаны следуют конвенциям OpenTelemetry gen_ai и по умолчанию содержат длительность, статус, число токенов, модель и имена инструментов.
Что нужно для подключения
Добавлять и менять точки назначения может только роль admin, роль developer их только видит. Endpoint должен принимать protobuf по OTLP/HTTP на HTTPS-адресе с портом 443 и с именем хоста, IP-адрес не подойдёт. У собственного OpenTelemetry Collector приёмник OTLP/HTTP по умолчанию слушает порт 4318, так что придётся либо перенастроить его на HTTPS и 443, либо поставить перед ним балансировщик или обратный прокси. По словам MLflow, сервер, запущенный только на вашей машине (localhost), экспорт с платформы не достанет, нужен удалённый, причём MLflow версии 3.17.1 или новее.
В поле OTLP endpoint URL указывают базовый адрес без /v1/traces, этот путь API добавляет сам. Ключи доступа кладут только в значения заголовков, и после сохранения Console их больше не покажет. Если сменить хост endpoint, заголовки придётся ввести заново. Для популярных платформ есть готовые варианты в списке Provider, для остальных выбирают Custom. Вместо Console можно использовать Admin API или CLI, но тогда Provider недоступен и адрес с заголовками вводятся вручную.
Каждая точка назначения покрывает рабочие пространства по выбору: все, выбранные или все, кроме выбранных. Спаны уходят во все включённые точки, которые покрывают пространство запроса. Проверить настройку можно кнопкой Test в меню More actions: в вашу систему должен прийти спан anthropic.test, а боевые спаны ищутся по фильтру service.name = claude-platform.
Метаданные или полный контент
В режиме Full content API дополнительно экспортирует промпты, ответы, а также входы и результаты инструментов. В Sentry советуют именно его: без промптов и ответов видно, что прогон агента упал, но не видно почему. Если у организации есть с Anthropic ограничения на обработку данных по HIPAA, FERPA или K-12, промптов и ответов в спанах не будет даже при Full content. И ещё одна деталь из документации: после доставки данные хранятся у выбранного вами сервиса, вне Anthropic, по его правилам хранения и доступа.
Как вложить спаны API в свои трейсы
По умолчанию спаны запроса или сессии образуют отдельный трейс. Чтобы они встали под спаны вашего приложения, API читает контекст из W3C-заголовка traceparent. Если в нём выключен флаг sampled, API не отправит ни спан запроса, ни вложенные в него. Claude Platform on AWS этот заголовок пока не поддерживает, и там спаны всегда начинают собственный трейс.
Тем, кто подключает MCP-сервер через MCP connector, трейс передаётся дальше: в каждом запросе и уведомлении к серверу лежит traceparent в params._meta. В вызове tools/call он указывает на спан anthropic.mcp_tool_use, так что сервер может повесить свои спаны прямо под вызов инструмента. В MLflow уточняют, что экспорт из SDK и его режим контента настраиваются отдельно от платформенного. Если отправлять оба потока в один эксперимент, клиентские и серверные спаны свяжутся.
Что может потеряться
Доставка идёт по принципу at least once, поэтому один спан может прийти дважды, а дубли отсекают по trace ID и span ID. Одновременно она best effort: потерянный спан API повторно не отправит. Повторы бывают после таймаута, сбоев соединения, TLS или DNS, а также ответов 408, 429 и 5xx, и их число ограничено. На TLS-рукопожатие и на заголовки ответа у endpoint есть по 5 секунд, на всю доставку 10.
Точек назначения на организацию всего 10, и отключённые тоже входят в этот лимит. Отключает их сам API: при редиректе 3xx, при имени хоста, которое ведёт на непубличный IP, и если все доставки падают 24 часа подряд. Сама точка назначения обратно не включится. Нужно устранить причину и нажать Enable в меню More actions при фильтре рабочих пространств All, тогда экспорт возобновится примерно через минуту.
Дальше
Grok Voice 3.0 обошла GPT-Live-1 и Gemini 3.8 Live
Голосовые агенты на grok-voice-latest переедут на Grok Voice 3.0 сами, без правок в коде и по прежней цене в 0,08 доллара за минуту. Переезд, по данным xAI, поднимает результат в индексе Artificial Analysis с 81,3 до 86,9. Вы бы оставили агента на автообновлении или зафиксировали версию модели вручную?
Читайте также
- Claude сам собирает команду агентов, но бюджета не знает
- Claude Code 2.1.301 не будет ждать далёкий сброс лимита
- Claude Managed Agents раздаёт один план на 1 000 агентов
- Весь Claude Managed Agents теперь можно держать у себя
- Авторы плагинов Claude увидят статус проверки и статистику
- Add to Slack ставит агентов из LangChain, n8n и Vercel
Комментарии
Пока никто не написал. Будьте первым.
Присоединяйтесь к разговору
Войдите, чтобы оставить комментарий. Он появится после модерации.

