Перейти к содержанию

Инструменты разработчика

Claude API научился слать трейсы в вашу систему мониторинга

4 мин чтения

Текст написан ИИ-моделью по источникам, на которые ведут ссылки, и сверен с ними второй моделью. Как мы работаем

Видео: x.com

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, тогда экспорт возобновится примерно через минуту.

AI-индустрияxAI

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. Вы бы оставили агента на автообновлении или зафиксировали версию модели вручную?

Пока никто не написал. Будьте первым.

Присоединяйтесь к разговору

Войдите, чтобы оставить комментарий. Он появится после модерации.