Anthropic dodaje eksport śladów OpenTelemetry do platformy Claude

Anthropic dodało eksport śladów OpenTelemetry do platformy Claude. 14 października 2026 roku firma ogłosiła, że deweloperzy mogą już wysyłać ślady z zarządzanych agentów Claude, interfejsu Messages API i pakietów SDK Claude do dowolnego narzędzia do monitorowania, które obsługuje ten standard. Funkcja jest dostępna w publicznej wersji beta.

W ogłoszeniu Anthropic firma poinformowała, że dodanie miejsca docelowego w konsoli Claude powoduje wysyłanie każdej tury agenta, wywołania modelu i użycia narzędzia do wybranego przez użytkownika narzędzia do monitorowania w postaci standardowego śladu OpenTelemetry zawierającego informacje o opóźnieniu, liczbie tokenów i identyfikatory. Zarządzani agenci i interfejs Messages API wymagają skonfigurowania takiego miejsca docelowego w konsoli, natomiast pakiety SDK Claude eksportują ślady automatycznie. Deweloperzy, którzy już wysyłają ślady z Claude Code lub Cowork do narzędzia do monitorowania, mogą wyświetlać w tym samym miejscu również agentów zbudowanych na platformie Claude.

Anthropic poinformowało, że ślady Claude są zgodne z konwencjami semantycznymi OpenTelemetry GenAI, dzięki czemu dane z Claude i innych dostawców można wykorzystywać w tych samych narzędziach i panelach. Ślady współpracują też z każdym narzędziem OpenTelemetry obsługującym standardowy punkt końcowy OTLP.

Dwie ścieżki konfiguracji i jeden model śledzenia

Dokumentacja platformy Claude definiuje ślad jako pełny zapis pojedynczego żądania przechodzącego przez system, a span jako jeden etap śladu, na przykład żądanie do modelu lub użycie narzędzia. Opisuje dwie ścieżki konfiguracji. Śledzenie za pomocą SDK konfiguruje się w kodzie, instalując SDK i rejestrując dostawcę śladów; nie wymaga ono żadnych specjalnych uprawnień. Śledzenie za pomocą API konfiguruje się przez dodanie miejsca docelowego w konsoli Claude i wymaga uprawnień administratora.

Zakres danych różni się w zależności od wybranej ścieżki. Śledzenie za pomocą API obejmuje każde uruchomienie modelu w ramach żądania, tury zarządzanych agentów oraz narzędzia serwerowe uruchamiane przez API. Śledzenie za pomocą SDK obejmuje dodatkowo narzędzia klienckie uruchamiane przez mechanizm wykonujący narzędzia, narzędzia działające w samodzielnie hostowanym środowisku izolowanym oraz inne żądania API, na przykład przesyłanie plików. Skonfigurowanie obu ścieżek umieszcza spany SDK i API danego żądania w jednym śladzie; w przypadku żądań kierowanych do platformy Claude w AWS spany API pojawiają się natomiast w osobnych śladach.

W przypadku zarządzanych agentów sesja generuje jeden span dla każdego żądania do Sessions API oraz span tury dla każdej tury agenta. Każda tura zawiera spany dla każdego żądania do modelu, każdego narzędzia uruchamianego przez API i każdej oceny wyniku. Dokumentacja odsyła użytkowników Claude Code, Agent SDK i Cowork do osobnej dokumentacji dotyczącej monitorowania i obserwowalności tych produktów.

Tryby zawartości, limity i zasady zgodności

Każde miejsce docelowe i każdy klient SDK mają tryb zawartości, który określa, czy spany obejmują monity i odpowiedzi modelu. Domyślny tryb „Tylko metadane” zapisuje identyfikatory, czas, status, liczbę tokenów oraz tekst wybrany przez użytkownika, na przykład nazwy i opisy agentów i narzędzi oraz nazwy serwerów MCP. Tryb „Pełna zawartość” obejmuje dodatkowo monity i odpowiedzi modelu.

W trybie „Pełna zawartość” każdy span domyślnie przechowuje do 0,75 MB danych. Jak podaje dokumentacja, mieści się w tym kontekst o długości 200 tys. tokenów w języku angielskim, a jego rozmiar pozostaje poniżej limitu żądania wynoszącego 1 MB, obowiązującego na wielu platformach do monitorowania i serwerach proxy. Pełny kontekst o długości 1 mln tokenów wymaga około 4 MB. Gdy zawartość przekracza limit, SDK lub API skraca ją i ustawia atrybut anthropic.content.truncated na true. W spanach żądań najpierw pomijane są monit systemowy i najwcześniejsze wiadomości, a obrazy i dokumenty są oznaczane wyłącznie według typu.

W przypadku organizacji objętych ograniczeniami dotyczącymi przetwarzania danych na mocy HIPAA, FERPA lub przepisów K–12 Anthropic eksportuje z miejsc docelowych wyłącznie metadane, niezależnie od skonfigurowanego trybu zawartości; spany SDK nie podlegają temu ograniczeniu. W trybie zerowego przechowywania danych można nadal korzystać z trybu „Pełna zawartość”, ponieważ API przechowuje eksportowaną zawartość wyłącznie w pamięci do momentu wysłania jej do miejsca docelowego. Zarządzani agenci Claude nie kwalifikują się do zerowego przechowywania danych, a warunki przechowywania ich danych pozostają bez zmian po włączeniu OpenTelemetry.

Aby prawidłowo zliczać tokeny, dokumentacja zaleca liczyć każdy token tylko raz, sumując spany pochodzące z jednego źródła na żądanie. Jeśli żądanie obejmuje zarówno spany SDK, jak i API, należy użyć spanów API. Dokumentacja zwraca też uwagę, że przy ponawianiu dostarczenia spany mogą dotrzeć więcej niż raz.

Wymienione integracje i wypowiedzi pierwszych klientów

W ogłoszeniu obsługiwane platformy do monitorowania podzielono według zastosowań. Do debugowania agentów na tle pozostałych elementów stosu oprogramowania wymieniono Grafana Cloud, Honeycomb, Sentry i Splunk. Ślady agentów są tam wyświetlane obok logów i metryk, dzięki czemu deweloperzy mogą sprawdzić, która usługa odpowiada za wolny lub nieudany etap. Do ulepszania agentów na podstawie danych produkcyjnych wymieniono Arize AI, Braintrust, Datadog, Langfuse, LangSmith od LangChain, New Relic i PostHog. Opisane zastosowania obejmują między innymi przekształcanie rzeczywistych śladów w testy ewaluacyjne oraz wykrywanie problemów z jakością. Do monitorowania wykorzystania w całej organizacji wymieniono Databricks Unity Gateway, gdzie zespoły ds. platformy i bezpieczeństwa mogą sprawdzać zużycie tokenów przez poszczególne zespoły i oznaczać nietypową aktywność.

Kilku pierwszych klientów opisało swoje wdrożenia w ogłoszeniu. Roman Shtylman, współzałożyciel i dyrektor techniczny Foxglove, powiedział, że firma tworzy agentów, którzy pomagają zespołom robotycznym debugować roboty. Dodał, że natywny eksport OpenTelemetry z platformy Claude pozwala firmie analizować interakcje agentów w PostHog wraz z danymi o korzystaniu z produktu, oceniać rzeczywistą skuteczność agentów i ustalać priorytety usprawnień dla zespołów robotycznych.

David Traina, starszy inżynier oprogramowania w Ramp, powiedział, że firma stworzyła Reflect — system agentowy, który ocenia ślady w Langfuse, wykrywa powtarzające się błędy i proponuje poprawki. „W przypadku niektórych agentów udało nam się już zmniejszyć zużycie tokenów o 10–20% i skrócić czas sesji o 30%” — powiedział Traina, dodając, że natywny eksport OpenTelemetry z Claude API może bezpośrednio zasilać ten proces usprawnień, bez żadnych dodatkowych kroków.

Hyon Lee, dyrektor techniczny Sterling Labs, powiedział, że natywny eksport przesyła każdy ślad do Langfuse bez konieczności tworzenia własnej instrumentacji dla agentów firmy analizujących rynki na bieżąco. Ankush Sharma, szef infrastruktury we FloQast, powiedział, że agenci firmy tworzącej oprogramowanie księgowe działają na platformie Claude, a ich telemetria trafia do Grafana Cloud. Dzięki temu każde wywołanie modelu znajduje się w tym samym śladzie co proces uzgadniania sald lub księgowania, w ramach którego zostało wykonane, co pozwala firmie odpowiadać na pytania audytorów o działania agenta na podstawie jednej osi czasu.