14 października 2026 r. konto ClaudeDevs ogłosiło publiczną betę eksportu śladów OpenTelemetry z Claude Platform: obejmuje ona żądania Messages API, sesje Claude Managed Agents i ślady tworzone przez Claude SDKs. Ślad to zapis przebiegu operacji, który pozwala zobaczyć, jak żądanie przechodzi przez aplikację lub usługę. Anthropic opisuje zakres i status bety.
Co pokazują ślady SDK i API
Anthropic udostępnia dwie ścieżki: instrumentację w aplikacji przez SDK oraz śledzenie po stronie Claude Platform, konfigurowane w Claude Console. W pierwszym przypadku aplikacja wysyła własne spany, czyli jednostki śladu, za pomocą skonfigurowanego eksportera OpenTelemetry. Śledzenie API dodaje informacje o pracy wykonywanej po stronie Anthropic. Dokumentacja OpenTelemetry opisuje też możliwość połączenia obu ścieżek.
| Kryterium | Śledzenie przez SDK | Śledzenie API w Console |
| Konfiguracja | W aplikacji: trzeba zarejestrować providera śledzenia i skonfigurować eksporter. | W Claude Console: administrator organizacji dodaje miejsce docelowe eksportu. |
| Widoczna aktywność | Spany z aplikacji, w tym działania narzędzi uruchamianych przez jej tool runner. | Żądania Messages API i użycie tokenów, poszczególne wywołania modelu, sesje Claude Managed Agents i narzędzia uruchamiane przez API. |
| Uprawnienia | Nie wymaga specjalnych uprawnień w Console. | Dodawanie i zmiana miejsc docelowych wymagają roli administratora organizacji. |
Wybierz SDK, jeśli potrzebujesz śledzić działanie własnej aplikacji i narzędzi uruchamianych po stronie klienta. Sama ta ścieżka nie pokazuje poszczególnych wywołań modelu wewnątrz żądania ani narzędzi serwerowych Managed Agents. Śledzenie API zapewnia wgląd w te działania po stronie Claude Platform, ale samo nie obejmuje narzędzi uruchamianych przez tool runner aplikacji. Anthropic wyjaśnia różnicę zakresu.
Anthropic wymienia śledzenie SDK w becie dla Claude API, Claude Platform on AWS, Amazon Bedrock, Google Cloud i Microsoft Foundry. Śledzenie API konfigurowane w Console wymienia dla Claude API i Claude Platform on AWS. To odrębne listy obsługi.
Rejestracja providera i ślady strumieni
Przy konfiguracji SDK zarejestruj providera śledzenia przed pierwszym żądaniem, które ma trafić do śladu. W przeciwnym razie początkowe wywołanie nie zostanie objęte instrumentacją. Przewodnik Anthropic po SDK podaje też, że span strumieniowy kończy się dopiero po odczytaniu lub zamknięciu strumienia. W trybie pełnej zawartości dane odpowiedzi są dołączane, gdy strumień jest odczytywany przez messages.stream().
W becie Anthropic może zmieniać opcje SDK i schemat spanów w sposób niezgodny ze starszymi wersjami. Firma zaleca przypięcie wersji SDK, by kontrolować moment przyjęcia takich zmian.
Metadane czy pełna zawartość
Domyślnie ślady zawierają wyłącznie metadane. Tryb pełnej zawartości może dodać prompty i odpowiedzi; można go ustawić osobno dla każdego miejsca docelowego oraz klienta SDK. Dostarczone dane podlegają zasadom dostępu i przechowywania wybranego dostawcy obserwowalności. Anthropic opisuje tryby i ograniczenia eksportu.
Domyślny limit pełnej zawartości wynosi 0,75 MB na span. Większe dane są skracane, a span otrzymuje atrybut anthropic.content.truncated=true. W przypadku organizacji objętych z Anthropic ograniczeniami dotyczącymi danych HIPAA, FERPA lub K–12 miejsca docelowe skonfigurowane w Console eksportują wyłącznie metadane, niezależnie od wybranego trybu. To ograniczenie nie dotyczy spanów SDK.
Przy zerowej retencji pełna zawartość pozostaje dostępna dla śledzenia Messages API, a Anthropic przechowuje eksportowaną treść tylko w pamięci do czasu jej dostarczenia. Claude Managed Agents nie kwalifikuje się do zerowej retencji, a OpenTelemetry nie zmienia zasad retencji dla tej usługi.
Endpoint i limity konfiguracji w Console
Miejsce docelowe API musi przyjmować dane w formacie OTLP/HTTP protobuf przez HTTPS na porcie 443. Anthropic dopisuje /v1/traces do bazowego adresu endpointu, chyba że skonfigurowano osobny adres dla śladów. Na organizację można ustawić do 10 miejsc docelowych, każde może obejmować do 1000 wybranych obszarów roboczych i zawierać do 20 nagłówków żądania. Przewodnik API Anthropic podaje również limity czasu: uzgodnienie TLS i zwrócenie nagłówków odpowiedzi muszą nastąpić w ciągu 5 sekund, a cała dostawa ma limit 10 sekund.
Jeśli łączysz ślady aplikacji i API, kontekst W3C traceparent pozwala powiązać spany w jeden ślad. Żądanie z wyłączonym próbkowaniem nie otrzymuje spanów API. W przypadku API przez AWS spany API rozpoczynają osobne ślady, ponieważ AWS nie obsługuje jeszcze tego nagłówka.
Dlaczego ślady nie zastępują rejestru użycia
Anthropic opisuje dostarczanie jako najlepszy możliwy wysiłek i co najmniej jedną próbę: spany mogą zaginąć albo zostać zduplikowane. Duplikaty można rozpoznać po identyfikatorach śladu i spanu, ale utraconych spanów nie da się ponownie wysłać. Dlatego do kompletnego śledzenia użycia klucza API Anthropic wskazuje Usage API, a nie eksport śladów. Dokumentacja API wyjaśnia te zasady dostarczania.
Claude Code ma osobną dokumentację monitorowania; ogłoszona beta dotyczy śladów Claude Platform dla Messages API, Claude Managed Agents i SDK. Anthropic dokumentuje monitorowanie Claude Code oddzielnie.
