---
title: OpenTelemetry-Span-Referenz
url: https://platform.claude.com/docs/de/api/opentelemetry/spans
description: Die OpenTelemetry-Spans und Span-Attribute, die die Claude API und das Claude SDK ausgeben.
featureMetadata:
topic:
title: OpenTelemetry
url: https://platform.claude.com/docs/en/manage-claude/opentelemetry
status: beta
---
Der OpenTelemetry-Export befindet sich in der Beta. Er wird im Rahmen deiner Vereinbarung mit Anthropic bereitgestellt, einschließlich des Abschnitts „Beta Services" der [Service Specific Terms](https://www.anthropic.com/legal/service-specific-terms). Span-Namen und Attribute können sich während der Beta ändern.
Informationen zum Einrichten des Exports findest du unter [OpenTelemetry mit dem Claude SDK verwenden](https://platform.claude.com/docs/de/manage-claude/opentelemetry/sdk) und [OpenTelemetry mit der Claude API verwenden](https://platform.claude.com/docs/de/manage-claude/opentelemetry/api).
## Span-Namen und -Arten
| Eigenschaft | SDK-Spans | API-Spans |
| ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------- |
| `service.name` | Der `service.name` der Anwendung | `claude-platform` |
| Instrumentierungsbereich | `com.anthropic.sdk.` oder `com.anthropic.sdk.cli`, plus `.` beim Client einer Cloud-Plattform, mit der Version des Pakets | `com.anthropic.claude-platform` |
| Span-Art | `CLIENT` auf dem Span für eine Anfrage, sonst `INTERNAL` | `SERVER` auf dem Span für eine Anfrage, sonst `INTERNAL` |
* **„Spans" (Zeitabschnitte) für Anfragen** tragen den Namen der API-Methode der Anfrage: `anthropic.`, gefolgt vom Pfad der Methode in der API-Referenz, mit Punkten statt Schrägstrichen und ohne `beta`. Zum Beispiel sendet `client.beta.sessions.events.send()` (csharp, go: `client.Beta.Sessions.Events.Send()`; java: `client.beta().sessions().events().send()`; php: `$client->beta->sessions->events->send()`; ruby: `client.beta.sessions.events.send_()`) eine Anfrage zum [Senden von Session-Events](https://platform.claude.com/docs/de/api/beta/sessions/events/send), und ihre Spans tragen den Namen [`anthropic.sessions.events.send`](https://platform.claude.com/docs/de/api/opentelemetry/spans#anthropic-sessions-events-send).
* **Tool-Spans** haben einen festen Namen, ein Leerzeichen und den Tool-Namen, zum Beispiel [`anthropic.tool_use bash`](https://platform.claude.com/docs/de/api/opentelemetry/spans#anthropic-tool-use-anthropic-mcp-tool-use-and-anthropic-custom-tool-use).
## Span-Status
* **`OK`:** Der Schritt wurde abgeschlossen.
* **`ERROR`:** Der Schritt ist fehlgeschlagen.
* **Nicht gesetzt:** Die Anwendung hat den Schritt abgebrochen, zum Beispiel als sie ein [`user.interrupt`](https://platform.claude.com/docs/de/api/beta/sessions/events#beta_managed_agents_user_interrupt_event)-Event gesendet hat.
Der Span eines Streams endet, wenn der Stream endet. Wenn die Anwendung den Stream vorzeitig schließt, hat der SDK-Span den Status nicht gesetzt, sodass der SDK-Span eines Streams, der nie abgeschlossen wird, etwa [`anthropic.sessions.events.stream`](https://platform.claude.com/docs/de/api/opentelemetry/spans#anthropic-sessions-method), den Status nicht gesetzt oder `ERROR` hat.
## Attribute
Attribute verwenden die [OpenTelemetry-Semantikkonventionen für generative KI](https://github.com/open-telemetry/semantic-conventions-genai) (`gen_ai.*`), wo eine existiert. Anthropic-Attribute beginnen mit `anthropic.`. Die Spans folgen den Konventionen im Stand von Commit [`e57c543b`](https://github.com/open-telemetry/semantic-conventions-genai/tree/e57c543b4889619eb2a05702471937db5119165d) vom 24. September 2026. Die Konventionen befinden sich noch in Entwicklung.
### Gemeinsame Attribute
Jeder Span für eine Anfrage hat die folgenden Attribute, sofern in der Beschreibung nicht anders angegeben. Andere Spans können nur die ersten drei haben:
| Attribut | Typ | Beschreibung |
| --------------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `gen_ai.provider.name` | `string` | `anthropic`. Auf jedem Span.
**SDK:** `aws.bedrock` bei den Amazon Bedrock-Clients (einschließlich Mantle) und `gcp.vertex_ai` beim Client für Google Cloud's Agent Platform. |
| `anthropic.organization.id` | `string` | Die ID der Organisation. |
| `anthropic.workspace.id` | `string` | Die ID des Workspace, in dem die Arbeit läuft. |
| `anthropic.request.id` | `string` | Der Wert des Antwort-Headers `request-id`. |
| `http.request.method` | `string` | Die HTTP-Methode der Anfrage, zum Beispiel `POST`. |
| `http.route` | `string` | Der Pfad des Endpunkts mit Platzhaltern für seine Pfadparameter, zum Beispiel `/v1/sessions/{session_id}`. |
| `http.response.status_code` | `int` | Der HTTP-Statuscode der endgültigen Antwort. Bei einem Stream der mit den Headern gesendete Statuscode. Fehlt, wenn es keine Antwort gab. |
| `server.address` | `string` | Der Host, an den die Anfrage gesendet wurde, zum Beispiel `api.anthropic.com`. |
| `server.port` | `int` | Der Port der Anfrage-URL oder der Standardport ihres Schemas, wenn die URL keinen hat. |
| `url.scheme` | `string` | Das Schema der URL, zum Beispiel `https`. |
| `url.path` | `string` | Der Pfad der URL, zum Beispiel `/v1/messages`. |
| `url.query` | `string` | Der Query-String der URL, nur mit den Query-Parametern, die der Endpunkt definiert. Fehlt, wenn es keine gibt. |
| `url.full` | `string` | Die URL der Anfrage. |
Auf Claude Platform on AWS enthalten API-Spans weder `server.address`, `server.port` noch `url.full`.
### Session-Attribute
In einer Managed Agents-Session haben Spans die folgenden Attribute. Die Spans einer Session können in mehr als einem Trace liegen. Um also eine Ansicht der Session zusammenzustellen, etwa ein Transkript, [gruppiere ihre Spans nach diesen IDs](https://platform.claude.com/docs/de/manage-claude/opentelemetry#a-managed-agents-session).
| Attribut | Typ | Beschreibung |
| ------------------------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `anthropic.session.id` | `string` | Die Session-ID. Fehlt bei den Spans von Methoden, die nicht auf eine Session wirken, wie etwa [`anthropic.sessions.list`](https://platform.claude.com/docs/de/api/opentelemetry/spans#anthropic-sessions-method). |
| `gen_ai.conversation.id` | `string` | Die ID des Session-Threads, zu dem der Span gehört. Im SDK ersetzt die [`conversation_id` (typescript, java, php: `conversationId`; csharp: `ConversationId`; go: `option.WithOpenTelemetryConversationID()`)-Option](https://platform.claude.com/docs/de/manage-claude/opentelemetry/sdk#configure-the-sdk) sie durch deine eigene Konversations-ID. Fehlt bei SDK-Spans ohne Thread, sofern du die Option nicht setzt, sowie bei den Spans der API für Anfragen an die Sessions API, die nicht an einen einzelnen Thread gerichtet sind. |
### Inhaltsattribute
Mit Content gekennzeichnete Attribute gibt es nur bei Spans im Inhaltsmodus, vom SDK und von der API gleichermaßen. Sieh dir an, [wie sich die Inhaltsmodi im Leitfaden unterscheiden](https://platform.claude.com/docs/de/manage-claude/opentelemetry#choose-a-content-mode). Wenn dieser Inhalt zu groß ist, [kürzen](https://platform.claude.com/docs/de/manage-claude/opentelemetry#content-limits) das SDK und die API ihn und setzen `anthropic.content.truncated` auf `true`. Wenn die Schutzmaßnahmen von Anthropic einer Antwort Inhalt vorenthalten, enthalten auch die Spans der API diesen Inhalt nicht.
Die Nachrichtenattribute sind JSON-Strings im Nachrichtenformat der OpenTelemetry-GenAI-Konventionen. Jeder Anthropic-Inhaltsblock wird zu einem Nachrichtenteil der GenAI-Konventionen, in der Messages API und in Managed Agents-Nachrichten-Events wie `agent.message`:
| Anthropic-Inhaltsblock | Nachrichtenteil der GenAI-Konventionen |
| --------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| `text` | `text` |
| `tool_use`, `server_tool_use` | `tool_call`, mit `anthropic_toolset_name` für einen `tool_use`-Block mit einem `toolset_name` wie `computer` |
| `mcp_tool_use` | `tool_call` mit `anthropic_mcp_server_name` |
| `tool_result`, `mcp_tool_result`, der Ergebnisblock eines Server-Tools wie `web_search_tool_result` | `tool_call_response` |
| `thinking` | `reasoning`, ohne die Signatur des `thinking`-Blocks. Nicht in Managed Agents-Spans, da das `agent.thinking`-Event den Denkinhalt nicht enthält. |
| Jeder andere Block, etwa `image` | Der `type` des Blocks mit dem Präfix `anthropic_`, etwa `anthropic_image`. Der Teil hat keine weiteren Felder. |
Jedes Managed Agents-Event für eine Tool-Nutzung oder ein Tool-Ergebnis wird ebenfalls zu einem Nachrichtenteil der GenAI-Konventionen:
| Managed Agents-Event | Nachrichtenteil der GenAI-Konventionen |
| ------------------------------------------------------------------------------------------- | ------------------------------------------- |
| `agent.tool_use`, `agent.custom_tool_use` | `tool_call` |
| `agent.mcp_tool_use` | `tool_call` mit `anthropic_mcp_server_name` |
| `user.tool_result`, `user.custom_tool_result`, `agent.tool_result`, `agent.mcp_tool_result` | `tool_call_response` |
### Token-Nutzung
Die folgenden Spans haben Attribute zur Token-Nutzung: [`anthropic.messages.create`](https://platform.claude.com/docs/de/api/opentelemetry/spans#anthropic-messages-create), [`anthropic.model_request`](https://platform.claude.com/docs/de/api/opentelemetry/spans#anthropic-model-request), [`anthropic.compaction`](https://platform.claude.com/docs/de/api/opentelemetry/spans#anthropic-compaction) und [`anthropic.session.outcome_evaluation`](https://platform.claude.com/docs/de/api/opentelemetry/spans#anthropic-session-outcome-evaluation). Die Werte gelten für den Schritt des Spans, zum Beispiel die Anfrage, die Modellanfrage oder die Kompaktierung. Um jedes Token nur einmal zu zählen, sieh dir an, [wie du Tokens im Leitfaden zählst](https://platform.claude.com/docs/de/manage-claude/opentelemetry#count-tokens).
| Attribut | Typ | Beschreibung |
| ---------------------------------------------------------- | ----- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `gen_ai.usage.input_tokens` | `int` | Die Eingabe-Tokens, einschließlich Cache-Lese- und -Schreibvorgängen. |
| `gen_ai.usage.output_tokens` | `int` | Die Ausgabe-Tokens. |
| `gen_ai.usage.cache_write.input_tokens` | `int` | Die in den Prompt-Cache geschriebenen Tokens. Fehlt bei [`anthropic.session.outcome_evaluation`](https://platform.claude.com/docs/de/api/opentelemetry/spans#anthropic-session-outcome-evaluation)-Spans. |
| `anthropic.usage.cache_creation.ephemeral_5m_input_tokens` | `int` | Die in den 5-Minuten-Cache geschriebenen Tokens. Nur bei den Spans für Messages API-Anfragen. Beim SDK-Span einer Streaming-Antwort nur die Tokens, die vor dem ersten Ausgabe-Token geschrieben wurden. |
| `anthropic.usage.cache_creation.ephemeral_1h_input_tokens` | `int` | Die in den 1-Stunden-Cache geschriebenen Tokens. Nur bei den Spans für Messages API-Anfragen. Beim SDK-Span einer Streaming-Antwort nur die Tokens, die vor dem ersten Ausgabe-Token geschrieben wurden. |
| `gen_ai.usage.cache_read.input_tokens` | `int` | Die aus dem Prompt-Cache gelesenen Tokens. Fehlt bei [`anthropic.session.outcome_evaluation`](https://platform.claude.com/docs/de/api/opentelemetry/spans#anthropic-session-outcome-evaluation)-Spans. |
## Spans
Ein Span kann vom SDK in der Anwendung oder von der API stammen, daher listet jeder Span in dieser Referenz seine Quellen auf. Beschreibungen, die mit **Messages API:** oder **Managed Agents:** beginnen, gelten für die Spans dieses Produkts. Attributbeschreibungen, die mit einer Quelle beginnen, etwa **SDK:** oder **API:**, gelten für die Spans dieser Quelle.
### `anthropic.messages.create`
* **Quelle:** Das SDK und die API.
* **Art:** `CLIENT` vom SDK, `SERVER` von der API.
* **Parent des SDK-Spans:** Der Span, der in der Anwendung aktuell ist, wenn sie die Methode aufruft. Wenn kein Span aktuell ist, gibt es keinen Parent.
* **Parent des API-Spans:** Der Span im `traceparent`-Header der Anfrage, also der SDK-Span, wenn die Anfrage vom SDK kommt. Ohne den Header hat der API-Span keinen Parent. Sieh dir an, [wie du den `traceparent`-Header sendest](https://platform.claude.com/docs/de/manage-claude/opentelemetry/api#connect-api-spans-to-your-own-traces).
* **Children des SDK-Spans:** Der API-Span für diese Anfrage.
* **Children des API-Spans:** Ein [`anthropic.model_request`](https://platform.claude.com/docs/de/api/opentelemetry/spans#anthropic-model-request)-Span für jede Modellanfrage, ein [Tool-Span](https://platform.claude.com/docs/de/api/opentelemetry/spans#anthropic-tool-use-anthropic-mcp-tool-use-and-anthropic-custom-tool-use) für jede Nutzung eines Server-Tools oder eines MCP-Connector-Tools, das die API in der Anfrage ausführt, und ein [`anthropic.compaction`](https://platform.claude.com/docs/de/api/opentelemetry/spans#anthropic-compaction)-Span für jede Kompaktierung.
Das SDK gibt diesen Span für jede Messages-Anfrage aus, ob gestreamt oder nicht.
Die API gibt diesen Span für jede [`POST /v1/messages`](https://platform.claude.com/docs/de/api/messages/create)-Anfrage aus, die sie authentifiziert. Sie gibt den Span nicht für eine Anfrage an den [OpenAI-kompatiblen Endpunkt](https://platform.claude.com/docs/de/cli-sdks-libraries/libraries/openai-sdk), `POST /v1/chat/completions`, aus.
Die API gibt einen Span pro Anfrage aus, auch wenn ein [Fallback-Modell](https://platform.claude.com/docs/de/build-with-claude/refusals-and-fallback) sie bedient.
Der Span hat die [Attribute zur Token-Nutzung](https://platform.claude.com/docs/de/api/opentelemetry/spans#token-usage). Der SDK-Span hat außerdem die Attribute jedes [SDK-Spans für eine Anfrage](https://platform.claude.com/docs/de/api/opentelemetry/spans#anthropic-resources-method).
| Attribut | Typ | Beschreibung |
| ------------------------------------------ | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `gen_ai.operation.name` | `string` | `chat` |
| `gen_ai.request.model` | `string` | Das [`model`](https://platform.claude.com/docs/de/api/messages/create#create.model) der Anfrage. |
| `gen_ai.response.id` | `string` | Die [`id`](https://platform.claude.com/docs/de/api/messages/create#message) der Antwort. |
| `gen_ai.response.model` | `string` | Das Modell, das die Anfrage bedient hat. Es unterscheidet sich vom angeforderten Modell, wenn die Anfrage einen Modell-Alias verwendet oder wenn ein [Fallback-Modell](https://platform.claude.com/docs/de/build-with-claude/refusals-and-fallback) die Anfrage bedient hat. |
| `anthropic.message.stop_reason` | `string` | Der [`stop_reason`](https://platform.claude.com/docs/de/api/messages#stop_reason) der Antwort, zum Beispiel `end_turn`. |
| `anthropic.response.service_tier` | `string` | Die Service-Stufe, die die Anfrage bedient hat: der [`usage.service_tier`](https://platform.claude.com/docs/de/api/messages#usage) der Antwort. Sieh dir an, [wie Anfragen Stufen zugewiesen werden](https://platform.claude.com/docs/de/api/service-tiers#how-requests-get-assigned-tiers). |
| `error.type` | `string` | Der [Fehlertyp](https://platform.claude.com/docs/de/api/errors#http-errors) einer fehlgeschlagenen Anfrage, zum Beispiel `rate_limit_error`.
**SDK:** Außerdem die anderen Werte in [SDK-Spans für Anfragen](https://platform.claude.com/docs/de/api/opentelemetry/spans#anthropic-resources-method).
**API:** `api_error`, wenn die API die Anfrage ohne Fehlerantwort beendet. |
| `gen_ai.response.time_to_first_chunk` | `double` | Nur beim SDK-Span einer Streaming-Antwort. Die Sekunden vom ersten Senden der Anfrage durch das SDK bis zum ersten `content_block_delta`-Event des Streams, falls es eines hat. |
| `gen_ai.usage.reasoning.output_tokens` | `int` | Die Nachdenken-Tokens der Antwort. Sie sind Teil der Ausgabe-Tokens. Fehlt, wenn die Nutzung der Antwort keine Details zu den Ausgabe-Tokens enthält. |
| `anthropic.usage.compaction.input_tokens` | `int` | Eingabe-Tokens der [Kompaktierungen](https://platform.claude.com/docs/de/build-with-claude/compaction) der Anfrage, einschließlich Cache-Lese- und -Schreibvorgängen. Nicht Teil von `gen_ai.usage.input_tokens`. Fehlt, wenn die Antwort keine Kompaktierung hat. |
| `anthropic.usage.compaction.output_tokens` | `int` | Ausgabe-Tokens der Kompaktierungen der Anfrage. Nicht Teil von `gen_ai.usage.output_tokens`. Fehlt, wenn die Antwort keine Kompaktierung hat. |
| `gen_ai.request.max_tokens` | `int` | Der [`max_tokens`](https://platform.claude.com/docs/de/api/messages/create#create.max_tokens)-Wert der Anfrage. |
| `gen_ai.request.temperature` | `double` | Die [`temperature`](https://platform.claude.com/docs/de/api/messages/create#create.temperature) der Anfrage. Fehlt, wenn die Anfrage sie nicht setzt. |
| `gen_ai.request.top_p` | `double` | Der [`top_p`](https://platform.claude.com/docs/de/api/messages/create#create.top_p)-Wert der Anfrage. Fehlt, wenn die Anfrage ihn nicht setzt. |
| `gen_ai.request.top_k` | `int` | Der [`top_k`](https://platform.claude.com/docs/de/api/messages/create#create.top_k)-Wert der Anfrage. Fehlt, wenn die Anfrage ihn nicht setzt. |
| `gen_ai.request.stream` | `boolean` | `true`, wenn die Anfrage [`stream: true`](https://platform.claude.com/docs/de/api/messages/create#create.stream) setzt. Fehlt andernfalls. |
| `gen_ai.request.reasoning.level` | `string` | Der [`effort`](https://platform.claude.com/docs/de/api/messages/create#create.output_config.effort) in der [`output_config`](https://platform.claude.com/docs/de/api/messages/create#create.output_config) der Anfrage. Fehlt, wenn die Anfrage ihn nicht setzt. |
| `gen_ai.output.type` | `string` | `json`, wenn die Anfrage das Ausgabeformat auf JSON setzt. Fehlt andernfalls. |
| `anthropic.request.service_tier` | `string` | Der [`service_tier`](https://platform.claude.com/docs/de/api/messages/create#create.service_tier) der Anfrage. Fehlt, wenn die Anfrage ihn nicht setzt. |
| `anthropic.thinking.type` | `string` | Der [`thinking.type`](https://platform.claude.com/docs/de/api/messages/create#create.thinking) der Anfrage. Fehlt, wenn die Anfrage ihn nicht setzt. |
| `anthropic.thinking.budget_tokens` | `int` | Die [`budget_tokens`](https://platform.claude.com/docs/de/api/messages#thinking_config_enabled.budget_tokens) im [`thinking`](https://platform.claude.com/docs/de/api/messages/create#create.thinking)-Objekt der Anfrage. Fehlt, wenn die Anfrage sie nicht setzt. |
| `anthropic.beta` | `string[]` | Nur beim SDK-Span. Die Beta-Namen im [`anthropic-beta`](https://platform.claude.com/docs/de/api/beta/messages/create#create.betas)-Header der Anfrage. |
| `gen_ai.system_instructions` | `string` | Content Ein JSON-String, der dem OpenTelemetry-Schema [`SystemInstructions`](https://github.com/open-telemetry/semantic-conventions-genai/blob/e57c543b4889619eb2a05702471937db5119165d/model/gen-ai/gen-ai-system-instructions.json) folgt. Der [`system`](https://platform.claude.com/docs/de/api/messages/create#create.system)-Prompt der Anfrage. |
| `gen_ai.input.messages` | `string` | Content Ein JSON-String, der dem OpenTelemetry-Schema [`InputMessages`](https://github.com/open-telemetry/semantic-conventions-genai/blob/e57c543b4889619eb2a05702471937db5119165d/model/gen-ai/gen-ai-input-messages.json) folgt. Die [`messages`](https://platform.claude.com/docs/de/api/messages/create#create.messages) der Anfrage. |
| `gen_ai.output.messages` | `string` | Content Ein JSON-String, der dem OpenTelemetry-Schema [`OutputMessages`](https://github.com/open-telemetry/semantic-conventions-genai/blob/e57c543b4889619eb2a05702471937db5119165d/model/gen-ai/gen-ai-output-messages.json) folgt. Der [`content`](https://platform.claude.com/docs/de/api/messages/create#message) der Antwort, als eine `assistant`-Nachricht.
**SDK:** Bei einem Stream nur, wenn die Anwendung den Stream so liest, wie [Tracen eines Streams](https://platform.claude.com/docs/de/manage-claude/opentelemetry/sdk#trace-a-stream) es beschreibt. |
| `gen_ai.request.stop_sequences` | `string[]` | Content Die [`stop_sequences`](https://platform.claude.com/docs/de/api/messages/create#create.stop_sequences) der Anfrage. |
Die Spans einer Anfrage enthalten nicht die Nutzungszähler für Server-Tools der Antwort, etwa `web_search_requests`. Stattdessen gibt die API für jede Nutzung eines Server-Tools einen [Tool-Span](https://platform.claude.com/docs/de/api/opentelemetry/spans#anthropic-tool-use-anthropic-mcp-tool-use-and-anthropic-custom-tool-use) aus.
### `anthropic.messages.count_tokens`
* **Quelle:** Das SDK. Die API gibt keinen Span für [`POST /v1/messages/count_tokens`](https://platform.claude.com/docs/de/api/messages/count_tokens) aus.
* **Art:** `CLIENT`.
* **Parent:** Der Span, der in der Anwendung aktuell ist, wenn sie die Methode aufruft, oder keiner, wenn kein Span aktuell ist.
* **Children:** Keine.
| Attribut | Typ | Beschreibung |
| --------------------------------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------- |
| `gen_ai.request.model` | `string` | Das Modell der Anfrage. |
| `anthropic.message.count_tokens.input_tokens` | `int` | Die Token-Anzahl in der Antwort. Diese Anzahl ist keine Nutzung. Beziehe sie nicht ein, wenn du die Token-Nutzung summierst. |
### `anthropic.sessions.create`
Wie [`anthropic.sessions.`](https://platform.claude.com/docs/de/api/opentelemetry/spans#anthropic-sessions-method), mit Ausnahme der folgenden Children und Attribute:
* **Children des SDK-Spans:** Der API-Span für diese Anfrage.
* **Children des API-Spans:** Der [`anthropic.session.turn`](https://platform.claude.com/docs/de/api/opentelemetry/spans#anthropic-session-turn)-Span des ersten Turns, wenn die Anfrage nicht leere [`initial_events`](https://platform.claude.com/docs/de/api/beta/sessions/create#create.initial_events) hat.
| Attribut | Typ | Beschreibung |
| ---------------------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------- |
| `gen_ai.agent.id` | `string` | Die ID des Agenten, aus dem die Session erstellt wurde. |
| `gen_ai.agent.name` | `string` | Der Name dieses Agenten.
**SDK:** Fehlt, wenn die Anfrage fehlgeschlagen ist. |
| `gen_ai.request.model` | `string` | Das Modell dieses Agenten, das den primären Thread ausführt.
**SDK:** Fehlt, wenn die Anfrage fehlgeschlagen ist. |
| `anthropic.session.environment.id` | `string` | Die ID der Umgebung der Session. |
### `anthropic.sessions.events.send`
Wie [`anthropic.sessions.`](https://platform.claude.com/docs/de/api/opentelemetry/spans#anthropic-sessions-method), mit Ausnahme der Children des API-Spans.
* **Children des SDK-Spans:** Der API-Span für diese Anfrage.
* **Children des API-Spans:** Der [`anthropic.session.turn`](https://platform.claude.com/docs/de/api/opentelemetry/spans#anthropic-session-turn)-Span jedes Turns, der aufgrund der Events der Anfrage startet.
### `anthropic.sessions.update`
Wie [`anthropic.sessions.`](https://platform.claude.com/docs/de/api/opentelemetry/spans#anthropic-sessions-method), mit Ausnahme der Children des API-Spans.
* **Children des SDK-Spans:** Der API-Span für diese Anfrage.
* **Children des API-Spans:** Der [`anthropic.session.turn`](https://platform.claude.com/docs/de/api/opentelemetry/spans#anthropic-session-turn)-Span jedes Turns, der fortgesetzt wird, weil die Anfrage das [Session-Budget](https://platform.claude.com/docs/de/managed-agents/budgets#resume-a-session-at-its-budget) erhöht oder entfernt.
### `anthropic.session.turn`
* **Quelle:** Die API, für Managed Agents-Sessions.
* **Art:** `INTERNAL`.
* **Parent:** Hängt davon ab, warum der Turn gestartet wurde:
* Der [`anthropic.sessions.create`](https://platform.claude.com/docs/de/api/opentelemetry/spans#anthropic-sessions-create)-Span, für den ersten Turn einer Session, die mit nicht leeren [`initial_events`](https://platform.claude.com/docs/de/api/beta/sessions/create#create.initial_events) erstellt wurde.
* Der [`anthropic.sessions.events.send`](https://platform.claude.com/docs/de/api/opentelemetry/spans#anthropic-sessions-events-send)-Span für die Anfrage, in der das Event gesendet wurde, für einen Turn, der aufgrund eines Events gestartet wurde, zum Beispiel eines [`user.message`](https://platform.claude.com/docs/de/api/beta/sessions/events#beta_managed_agents_user_message_event)-Events.
* Der [`anthropic.sessions.update`](https://platform.claude.com/docs/de/api/opentelemetry/spans#anthropic-sessions-update)-Span, für einen Turn, der fortgesetzt wird, weil das Session-Budget durch die Anfrage erhöht oder entfernt wurde.
* Der `anthropic.session.turn`-Span des Turns [des Agenten, den die Session ausführt](https://platform.claude.com/docs/de/managed-agents/multiagent-orchestration), während dessen dieser Agent diesen Turn gestartet hat, für einen Turn auf einem anderen Thread.
* Keiner, für einen Turn, der startet, weil ein Agent auf einem anderen Thread geantwortet oder seinen Turn beendet hat, etwa ein Agent, den der primäre Agent aufgerufen hat.
* **Children:**
* Ein [`anthropic.model_request`](https://platform.claude.com/docs/de/api/opentelemetry/spans#anthropic-model-request)-Span für jede Modellanfrage im Turn.
* Ein Tool-Span jedes Mal, wenn die API im Turn ein Tool ausführt, außer in den [im Abschnitt zu Tool-Spans aufgeführten Fällen](https://platform.claude.com/docs/de/api/opentelemetry/spans#anthropic-tool-use-anthropic-mcp-tool-use-and-anthropic-custom-tool-use).
* Ein `anthropic.session.turn`-Span für jeden Turn, den der Agent, den die Session ausführt, während dieses Turns auf einem anderen Thread gestartet hat.
* Ein [`anthropic.session.outcome_evaluation`](https://platform.claude.com/docs/de/api/opentelemetry/spans#anthropic-session-outcome-evaluation)-Span für jede Iteration einer Ergebnisbewertung, die dieser Turn startet.
Ein Turn beginnt, wenn sein Thread in den Zustand `running` wechselt, und endet, wenn der Thread ihn verlässt.
| Attribut | Typ | Beschreibung |
| ------------------------------------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `gen_ai.operation.name` | `string` | `invoke_agent` |
| `gen_ai.agent.id` | `string` | Die ID des Agenten, der den Thread des Turns ausführt. Fehlt bei einem [Advisor](https://platform.claude.com/docs/de/managed-agents/multiagent-orchestration#advisor-threads)-Thread. |
| `gen_ai.agent.name` | `string` | Der Name dieses Agenten. `anthropic.advisor` bei einem Advisor-Thread. |
| `gen_ai.request.model` | `string` | Das Modell dieses Agenten. Bei einem Advisor-Thread das Modell des Advisors. |
| `anthropic.session.turn.stop_reason` | `string` | Warum der Turn endete: der [`stop_reason.type`](https://platform.claude.com/docs/de/api/beta/sessions/events#beta_managed_agents_session_thread_status_idle_event) des [`session.thread_status_idle`](https://platform.claude.com/docs/de/api/beta/sessions/events#beta_managed_agents_session_thread_status_idle_event)-Events, zum Beispiel `requires_action`. Fehlt, wenn der Thread nicht in den Leerlauf gewechselt ist. |
| `error.type` | `string` | Der [`error.type`](https://platform.claude.com/docs/de/api/beta/sessions/events#beta_managed_agents_session_error_event) des [`session.error`](https://platform.claude.com/docs/de/api/beta/sessions/events#beta_managed_agents_session_error_event)-Events, das den Turn beendet hat, falls der Turn fehlgeschlagen ist. |
| `gen_ai.agent.description` | `string` | Die Beschreibung dieses Agenten. Fehlt bei einem Advisor-Thread oder wenn der Agent keine hat. |
| `gen_ai.system_instructions` | `string` | Content Ein JSON-String, der dem OpenTelemetry-Schema [`SystemInstructions`](https://github.com/open-telemetry/semantic-conventions-genai/blob/e57c543b4889619eb2a05702471937db5119165d/model/gen-ai/gen-ai-system-instructions.json) folgt. Der für den Turn geltende System-Prompt. Nur beim ersten Turn eines Threads. Fehlt bei einem Advisor-Thread. |
| `gen_ai.input.messages` | `string` | Content Ein JSON-String, der dem OpenTelemetry-Schema [`InputMessages`](https://github.com/open-telemetry/semantic-conventions-genai/blob/e57c543b4889619eb2a05702471937db5119165d/model/gen-ai/gen-ai-input-messages.json) folgt. Die Eingabe-Events des Turns: Benutzernachrichten und Tool-Ergebnisse, [`system.message`](https://platform.claude.com/docs/de/api/beta/sessions/events#beta_managed_agents_system_message_event_params)-Events und Nachrichten von anderen Threads. Fehlt bei einem Advisor-Thread. |
| `gen_ai.output.messages` | `string` | Content Ein JSON-String, der dem OpenTelemetry-Schema [`OutputMessages`](https://github.com/open-telemetry/semantic-conventions-genai/blob/e57c543b4889619eb2a05702471937db5119165d/model/gen-ai/gen-ai-output-messages.json) folgt. Die Ausgabe-Events des Turns: die Nachrichten, Tool-Nutzungen und Tool-Ergebnisse des Agenten. |
### `anthropic.model_request`
* **Quelle:** Die API, für Messages API-Anfragen und Managed Agents-Sessions.
* **Art:** `INTERNAL`.
* **Parent:**
* **Messages API:** Der [`anthropic.messages.create`](https://platform.claude.com/docs/de/api/opentelemetry/spans#anthropic-messages-create)-Span für die Anfrage.
* **Managed Agents:** Der [`anthropic.session.turn`](https://platform.claude.com/docs/de/api/opentelemetry/spans#anthropic-session-turn)-Span des Turns, der die Anfrage stellt.
* **Children:** Keine.
In der Messages API ist jeder Span eine Modellanfrage innerhalb der API-Anfrage.
Der Span hat die [Attribute zur Token-Nutzung](https://platform.claude.com/docs/de/api/opentelemetry/spans#token-usage).
| Attribut | Typ | Beschreibung |
| ----------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `gen_ai.operation.name` | `string` | Nur bei den Spans von Managed Agents-Sessions, wo es `chat` ist. In der Messages API ist der [`anthropic.messages.create`](https://platform.claude.com/docs/de/api/opentelemetry/spans#anthropic-messages-create)-Span für die Anfrage die `chat`-Operation. |
| `gen_ai.request.model` | `string` | Das Modell der Anfrage. |
| `gen_ai.response.model` | `string` | Nur bei den Spans für Messages API-Anfragen. Das Modell, das die Modellanfrage ausgeführt hat. |
| `error.type` | `string` | **Messages API:** Der `error.type` des [`anthropic.messages.create`](https://platform.claude.com/docs/de/api/opentelemetry/spans#anthropic-messages-create)-Spans, falls die Anfrage während dieser Modellanfrage fehlgeschlagen ist.
**Managed Agents:** Falls die Modellanfrage fehlgeschlagen ist, ihr [Fehlertyp](https://platform.claude.com/docs/de/api/errors#http-errors), zum Beispiel `rate_limit_error`. `api_error`, falls die Modellanfrage ohne Antwort fehlgeschlagen ist. |
### `anthropic.tool_use`, `anthropic.mcp_tool_use` und `anthropic.custom_tool_use`
* **Quelle:** Das SDK und die API.
* **Name:** `anthropic.tool_use `, `anthropic.mcp_tool_use ` oder `anthropic.custom_tool_use `, wobei `` der Name des Tools ist.
* **Art:** `INTERNAL`.
* **Parent des SDK-Spans:** Der Span, der in der Anwendung aktuell ist, wenn das Tool startet, was im Messages-Tool-Runner der [`anthropic.messages.tool_runner`](https://platform.claude.com/docs/de/api/opentelemetry/spans#anthropic-messages-tool-runner)-Span ist. Wenn kein Span aktuell ist, gibt es keinen Parent.
* **Parent des API-Spans:**
* **Messages API:** Der [`anthropic.messages.create`](https://platform.claude.com/docs/de/api/opentelemetry/spans#anthropic-messages-create)-Span für die Anfrage, in der die API das Tool ausführt.
* **Managed Agents:** Der [`anthropic.session.turn`](https://platform.claude.com/docs/de/api/opentelemetry/spans#anthropic-session-turn)-Span des Turns, in dem das Tool läuft. Bei einer Tool-Nutzung, die auf ein [`user.tool_confirmation`](https://platform.claude.com/docs/de/api/beta/sessions/events#beta_managed_agents_user_tool_confirmation_event)-Event wartet, ist das der Turn, der aufgrund der Bestätigung startet.
* Bei einer Tool-Nutzung aus Code, den ein anderes Tool ausführt, der Tool-Span dieses Tools. In der Messages API ist dieses Tool das [Code-Ausführungs-Tool](https://platform.claude.com/docs/de/agents-and-tools/tool-use/code-execution-tool).
* **Children des SDK-Spans:** Die Spans, die der Code des Tools startet.
* **Children des API-Spans:** Ein Tool-Span für jede Tool-Nutzung aus dem Code, den dieses Tool ausführt. Zum Beispiel könnte Code, den das Code-Ausführungs-Tool ausführt, `web_search` verwenden.
Das Präfix des Span-Namens hängt vom Typ des Tools ab:
* `anthropic.tool_use ` ist der Span jeder Nutzung eines [Server-Tools](https://platform.claude.com/docs/de/agents-and-tools/tool-use/server-tools) in der Messages API oder eines Tools aus dem Agent-Toolset von Managed Agents. Die API führt die Tools des Agent-Toolsets aus, außer in einer [selbst gehosteten Sandbox](https://platform.claude.com/docs/de/manage-claude/opentelemetry/sdk#trace-a-self-hosted-sandbox), wo der Umgebungs-Worker sie ausführt.
* `anthropic.mcp_tool_use ` ist der Span jeder Nutzung eines MCP-Tools, im SDK, in der Messages API und in Managed Agents. Im SDK ist es ein Tool aus einem MCP-Helper, das der [Messages-Tool-Runner](https://platform.claude.com/docs/de/agents-and-tools/tool-use/tool-runner) oder der [Session-Tool-Runner](https://platform.claude.com/docs/de/managed-agents/self-hosted-sandboxes-reference#session-tool-runner) ausführt. In der Messages API stammt das Tool vom [MCP-Connector](https://platform.claude.com/docs/de/agents-and-tools/mcp-connector). Wenn in Managed Agents die [Verbindung zum MCP-Server fehlschlägt](https://platform.claude.com/docs/de/managed-agents/mcp-connector#handle-connection-and-authentication-failures), enthält der Span-Name den Tool-Namen nicht.
* `anthropic.custom_tool_use ` ist der Span jeder Nutzung eines Tools, das die Anwendung definiert und ein Tool-Runner ausführt. Nur das SDK gibt diesen Span aus.
Die API gibt in den folgenden Fällen keinen Tool-Span aus:
* Das Modell fordert die Nutzung eines Tools an, das die Anwendung ausführt, etwa eines [benutzerdefinierten Tools](https://platform.claude.com/docs/de/managed-agents/tools). Wenn ein Tool-Runner im SDK das Tool ausführt, gibt der Tool-Runner dessen Span aus.
* **Managed Agents:** Der Agent verwendet ein Tool, das in einer selbst gehosteten Sandbox läuft. Der Worker im SDK, der das Tool ausführt, gibt dessen Span aus. Sieh dir an, [wie du eine selbst gehostete Sandbox tracst](https://platform.claude.com/docs/de/manage-claude/opentelemetry/sdk#trace-a-self-hosted-sandbox).
* **Managed Agents:** Der Agent verwendet ein [Multiagent](https://platform.claude.com/docs/de/managed-agents/multiagent-orchestration)-Tool oder das [Advisor-Tool](https://platform.claude.com/docs/de/managed-agents/multiagent-orchestration#give-the-session-an-advisor).
* **Managed Agents:** Der Agent fordert die Nutzung eines Tools an, aber der Server lehnt die Nutzung unter der [`auto`-Berechtigungsrichtlinie](https://platform.claude.com/docs/de/managed-agents/permission-policies#let-the-server-evaluate-each-call-with-auto) ab, oder die Anwendung lehnt sie in einem [`user.tool_confirmation`](https://platform.claude.com/docs/de/api/beta/sessions/events#beta_managed_agents_user_tool_confirmation_event)-Event ab.
| Attribut | Typ | Beschreibung |
| ------------------------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `gen_ai.operation.name` | `string` | `execute_tool` |
| `gen_ai.tool.name` | `string` | Der Name des Tools, zum Beispiel `bash`. Bei API-Spans enthält der Name eines MCP-Tools nicht den Servernamen. Wenn in Managed Agents die Verbindung zum MCP-Server fehlgeschlagen ist, ist es der Name, den das Modell generiert hat, und er ist nur bei Spans im Inhaltsmodus vorhanden. |
| `gen_ai.tool.call.id` | `string` | **Messages API:** Die `id` des Blocks, in dem das Modell die Nutzung des Tools angefordert hat: ein [`tool_use`](https://platform.claude.com/docs/de/api/messages#tool_use_block)-, [`server_tool_use`](https://platform.claude.com/docs/de/api/messages#server_tool_use_block)- oder [`mcp_tool_use`](https://platform.claude.com/docs/de/api/beta/messages#beta_mcp_tool_use_block)-Block.
**Managed Agents:** Die ID des Events, in dem der Agent die Nutzung des Tools angefordert hat: ein [`agent.tool_use`](https://platform.claude.com/docs/de/api/beta/sessions/events#beta_managed_agents_agent_tool_use_event)-, [`agent.mcp_tool_use`](https://platform.claude.com/docs/de/api/beta/sessions/events#beta_managed_agents_agent_mcp_tool_use_event)- oder [`agent.custom_tool_use`](https://platform.claude.com/docs/de/api/beta/sessions/events#beta_managed_agents_agent_custom_tool_use_event)-Event. |
| `anthropic.mcp.server.name` | `string` | Nur bei den API-Spans von MCP-Tools. Der Name des MCP-Servers des Tools. In der Messages API der [`server_name`](https://platform.claude.com/docs/de/api/beta/messages#beta_mcp_tool_use_block.server_name) des [`mcp_tool_use`](https://platform.claude.com/docs/de/api/beta/messages#beta_mcp_tool_use_block)-Blocks. |
| `gen_ai.conversation.id` | `string` | Die Session-Thread-ID, wie [Session-Attribute](https://platform.claude.com/docs/de/api/opentelemetry/spans#session-attributes) es beschreibt. Im Messages-Tool-Runner die Konversations-ID, die mit der [`conversation_id` (typescript, java, php: `conversationId`; csharp: `ConversationId`; go: `option.WithOpenTelemetryConversationID()`)-Option](https://platform.claude.com/docs/de/manage-claude/opentelemetry/sdk#configure-the-sdk) übergeben wurde, und fehlt ohne eine solche. Fehlt bei den API-Spans für eine Messages API-Anfrage. |
| `anthropic.session.id` | `string` | Die ID der Session. Fehlt bei einer Tool-Nutzung außerhalb einer Managed Agents-Session, etwa in der Messages API oder im Messages-Tool-Runner. |
| `anthropic.session.thread.id` | `string` | Nur bei SDK-Spans des Session-Tool-Runners. Die ID des Session-Threads. Fehlt bei einer Tool-Nutzung auf dem primären Thread. |
| `anthropic.tool.evaluated_permission` | `string` | Nur bei den Spans, die die API in Managed Agents-Sessions ausgibt. Das Ergebnis der Auswertung der [Berechtigungsrichtlinie](https://platform.claude.com/docs/de/managed-agents/permission-policies) für die Tool-Nutzung: `allow` oder `ask`. |
| `error.type` | `string` | Der Fehlertyp, falls die Tool-Nutzung fehlgeschlagen ist: `tool_error`, wenn der Code des Tools einen Fehler auslöst oder wenn das Tool ein Fehlerergebnis zurückgibt.
**API:** In der Messages API hat das Fehlerergebnis eines Server-Tools stattdessen seinen [`error_code`](https://platform.claude.com/docs/de/api/messages#web_search_tool_result_error.error_code), zum Beispiel `max_uses_exceeded`. Wenn in Managed Agents die Verbindung zum MCP-Server fehlgeschlagen ist, `mcp_authentication_failed_error`, wenn die Authentifizierung fehlgeschlagen ist, andernfalls `mcp_connection_failed_error`. Falls die Anfrage während der Tool-Nutzung fehlgeschlagen ist, der [Fehlertyp](https://platform.claude.com/docs/de/api/errors#http-errors) der Anfrage. |
| `gen_ai.tool.description` | `string` | Nur bei SDK-Spans. Die Beschreibung in der Tool-Definition. Fehlt, wenn die Beschreibung leer ist. |
| `gen_ai.tool.type` | `string` | Nur bei SDK-Spans. `function` |
| `gen_ai.tool.call.arguments` | `string` | Content Ein JSON-String, der dem OpenTelemetry-Schema [`ToolCallArguments`](https://github.com/open-telemetry/semantic-conventions-genai/blob/e57c543b4889619eb2a05702471937db5119165d/model/gen-ai/gen-ai-tool-call-arguments.json) folgt. Der [`input`](https://platform.claude.com/docs/de/api/messages#tool_use_block) der Tool-Nutzung. |
| `anthropic.tool_result.content` | `string` | Content Ein JSON-String mit einem Array von Inhaltsblöcken oder mit einem Objekt. Der `content` des Tool-Ergebnisses, das an das Modell zurückgeht. Auch für ein Fehlerergebnis, außer in Managed Agents, wenn die Verbindung zum MCP-Server fehlgeschlagen ist.
**API:** In der Messages API wird ein String-`content` zu einem Array mit einem [`text`](https://platform.claude.com/docs/de/api/messages#text_block)-Block. |
### `anthropic.compaction`
* **Quelle:** Die API, für Messages-API-Anfragen.
* **Art:** `INTERNAL`.
* **Übergeordnet:** Der [`anthropic.messages.create`](https://platform.claude.com/docs/de/api/opentelemetry/spans#anthropic-messages-create)-Span für die Anfrage.
* **Untergeordnet:** Keine.
Der Span hat die [Attribute zur Token-Nutzung](https://platform.claude.com/docs/de/api/opentelemetry/spans#token-usage) der Compaction. Auf [`anthropic.messages.create`](https://platform.claude.com/docs/de/api/opentelemetry/spans#anthropic-messages-create) steht die Nutzung einer Compaction in den `anthropic.usage.compaction.*`-Attributen statt in den `gen_ai.usage.*`-Summen.
| Attribut | Typ | Beschreibung |
| ------------ | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| `error.type` | `string` | Der [Fehlertyp](https://platform.claude.com/docs/de/api/errors#http-errors) der Anfrage, falls die Anfrage während der Compaction fehlgeschlagen ist. |
### `anthropic.session.outcome_evaluation`
* **Quelle:** Die API, für Managed-Agents-Sessions.
* **Art:** `INTERNAL`.
* **Übergeordnet:** Der [`anthropic.session.turn`](https://platform.claude.com/docs/de/api/opentelemetry/spans#anthropic-session-turn)-Span des Turns, der die Iteration gestartet hat, auch wenn dieser Turn vor der Iteration endet.
* **Untergeordnet:** Keine.
Der Status ist nicht gesetzt, wenn das Ergebnis `interrupted` ist, und `OK` bei jedem anderen Ergebnis.
Der Span hat zwei der [Attribute zur Token-Nutzung](https://platform.claude.com/docs/de/api/opentelemetry/spans#token-usage): `gen_ai.usage.input_tokens` und `gen_ai.usage.output_tokens`.
| Attribut | Typ | Beschreibung |
| -------------------------------------------------- | -------- | ----------------------------------------------------------------------------------------------------------------- |
| `anthropic.session.outcome.id` | `string` | Die ID des Outcomes, das die Iteration bewertet. |
| `anthropic.session.outcome_evaluation.result` | `string` | Das Ergebnis der Iteration: `satisfied`, `needs_revision`, `max_iterations_reached`, `failed` oder `interrupted`. |
| `anthropic.session.outcome_evaluation.iteration` | `int` | Die Nummer der Iteration. |
| `anthropic.session.outcome_evaluation.explanation` | `string` | Content Die Erklärung des Ergebnisses durch den Grader, als reiner Text. |
### `anthropic.messages.tool_runner`
* **Quelle:** Das SDK.
* **Art:** `INTERNAL`.
* **Übergeordnet:** Der Span, der in der Anwendung aktuell ist, wenn die Schleife startet, oder keiner, wenn kein Span aktuell ist.
* **Untergeordnet:** Der [`anthropic.messages.create`](https://platform.claude.com/docs/de/api/opentelemetry/spans#anthropic-messages-create)-Span für jede Anfrage in der Schleife und der [Tool-Span](https://platform.claude.com/docs/de/api/opentelemetry/spans#anthropic-tool-use-anthropic-mcp-tool-use-and-anthropic-custom-tool-use) jeder Tool-Nutzung, die der Runner ausführt.
Der Span endet mit der Schleife. Wenn die Anwendung den Runner stoppt, ist der Status nicht gesetzt. Wenn der Code eines Tools einen Fehler auslöst, hat dessen Tool-Span den Status `ERROR` und die Schleife läuft weiter. Der Span hat keine Nutzungsattribute, lies die Nutzung also aus seinen untergeordneten [`anthropic.messages.create`](https://platform.claude.com/docs/de/api/opentelemetry/spans#anthropic-messages-create)-Spans.
| Attribut | Typ | Beschreibung |
| ------------------------ | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `gen_ai.operation.name` | `string` | `invoke_agent` |
| `gen_ai.request.model` | `string` | Das Modell der ersten Anfrage in der Schleife. |
| `gen_ai.conversation.id` | `string` | Die Konversations-ID, die mit der Option [`conversation_id` (typescript, java, php: `conversationId`; csharp: `ConversationId`; go: `option.WithOpenTelemetryConversationID()`)](https://platform.claude.com/docs/de/manage-claude/opentelemetry/sdk#configure-the-sdk) übergeben wurde. Fehlt ohne eine solche. |
| `error.type` | `string` | Der [Fehlertyp](https://platform.claude.com/docs/de/api/errors#http-errors) der Anfrage, die die Schleife beendet hat, falls die Schleife fehlgeschlagen ist. `client_error`, wenn der Runner selbst fehlgeschlagen ist. |
| `gen_ai.output.type` | `string` | `json`, wenn die Anfragen das Ausgabeformat auf JSON setzen. Fehlt andernfalls. |
### `anthropic.messages.batches.`
* **Quelle:** Das SDK, für jede Message-Batches-Methode.
* **Art:** `CLIENT`.
* **Übergeordnet:** Der Span, der in der Anwendung aktuell ist, wenn sie die Methode aufruft, oder keiner, wenn kein Span aktuell ist.
* **Untergeordnet:** Keine.
Die Spans haben außerdem die Attribute jedes [SDK-Spans für eine Anfrage](https://platform.claude.com/docs/de/api/opentelemetry/spans#anthropic-resources-method).
| Attribut | Typ | Beschreibung |
| --------------------------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| `anthropic.message.batch.id` | `string` | Die ID des Batches, auf den die Methode wirkt, oder bei `create` die ID des neuen Batches. Fehlt bei `list` und bei einem fehlgeschlagenen `create`. |
| `anthropic.message.batch.request_count` | `int` | Nur bei `create`. Die Anzahl der Elemente im [`requests`](https://platform.claude.com/docs/de/api/messages/batches/create#create.requests)-Array. |
### `anthropic.sessions.`
* **Quelle:** Das SDK und die API.
* **Art:** `CLIENT` vom SDK, `SERVER` von der API.
* **Übergeordnet zum SDK-Span:** Der Span, der in der Anwendung aktuell ist, wenn sie die Methode aufruft, oder keiner, wenn kein Span aktuell ist.
* **Übergeordnet zum API-Span:** Der Span im [`traceparent`-Header](https://platform.claude.com/docs/de/manage-claude/opentelemetry/api#connect-api-spans-to-your-own-traces) der Anfrage, also der SDK-Span, wenn die Anfrage vom SDK kommt, oder keiner ohne den Header.
* **Untergeordnet zum SDK-Span:** Der API-Span für diese Anfrage.
* **Untergeordnet zum API-Span:** Keine.
Die API erzeugt einen `anthropic.sessions.`-Span für jede authentifizierte Anfrage an einen Endpunkt der [Sessions API](https://platform.claude.com/docs/de/managed-agents/sessions). Anfragen, die die Plattform im Namen eines Benutzers sendet, etwa eine in der Claude Console gesendete Nachricht oder eine Session, die ein [geplantes Deployment](https://platform.claude.com/docs/de/managed-agents/scheduled-deployments) startet, haben ebenfalls einen, jeweils in einem neuen Trace.
| Span | Endpunkt |
| ------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------- |
| `anthropic.sessions.create` | [`POST /v1/sessions`](https://platform.claude.com/docs/de/api/beta/sessions/create) |
| `anthropic.sessions.list` | [`GET /v1/sessions`](https://platform.claude.com/docs/de/api/beta/sessions/list) |
| `anthropic.sessions.retrieve` | [`GET /v1/sessions/{session_id}`](https://platform.claude.com/docs/de/api/beta/sessions/retrieve) |
| `anthropic.sessions.update` | [`POST /v1/sessions/{session_id}`](https://platform.claude.com/docs/de/api/beta/sessions/update) |
| `anthropic.sessions.delete` | [`DELETE /v1/sessions/{session_id}`](https://platform.claude.com/docs/de/api/beta/sessions/delete) |
| `anthropic.sessions.archive` | [`POST /v1/sessions/{session_id}/archive`](https://platform.claude.com/docs/de/api/beta/sessions/archive) |
| `anthropic.sessions.events.send` | [`POST /v1/sessions/{session_id}/events`](https://platform.claude.com/docs/de/api/beta/sessions/events/send) |
| `anthropic.sessions.events.list` | [`GET /v1/sessions/{session_id}/events`](https://platform.claude.com/docs/de/api/beta/sessions/events/list) |
| `anthropic.sessions.events.stream` | [`GET /v1/sessions/{session_id}/events/stream`](https://platform.claude.com/docs/de/api/beta/sessions/events/stream) |
| `anthropic.sessions.resources.add` | [`POST /v1/sessions/{session_id}/resources`](https://platform.claude.com/docs/de/api/beta/sessions/resources/add) |
| `anthropic.sessions.resources.list` | [`GET /v1/sessions/{session_id}/resources`](https://platform.claude.com/docs/de/api/beta/sessions/resources/list) |
| `anthropic.sessions.resources.retrieve` | [`GET /v1/sessions/{session_id}/resources/{resource_id}`](https://platform.claude.com/docs/de/api/beta/sessions/resources/retrieve) |
| `anthropic.sessions.resources.update` | [`POST /v1/sessions/{session_id}/resources/{resource_id}`](https://platform.claude.com/docs/de/api/beta/sessions/resources/update) |
| `anthropic.sessions.resources.delete` | [`DELETE /v1/sessions/{session_id}/resources/{resource_id}`](https://platform.claude.com/docs/de/api/beta/sessions/resources/delete) |
| `anthropic.sessions.threads.list` | [`GET /v1/sessions/{session_id}/threads`](https://platform.claude.com/docs/de/api/beta/sessions/threads/list) |
| `anthropic.sessions.threads.retrieve` | [`GET /v1/sessions/{session_id}/threads/{thread_id}`](https://platform.claude.com/docs/de/api/beta/sessions/threads/retrieve) |
| `anthropic.sessions.threads.archive` | [`POST /v1/sessions/{session_id}/threads/{thread_id}/archive`](https://platform.claude.com/docs/de/api/beta/sessions/threads/archive) |
| `anthropic.sessions.threads.events.list` | [`GET /v1/sessions/{session_id}/threads/{thread_id}/events`](https://platform.claude.com/docs/de/api/beta/sessions/threads/events/list) |
| `anthropic.sessions.threads.events.stream` | [`GET /v1/sessions/{session_id}/threads/{thread_id}/stream`](https://platform.claude.com/docs/de/api/beta/sessions/threads/events/stream) |
Der Span hat die [Session-Attribute](https://platform.claude.com/docs/de/api/opentelemetry/spans#session-attributes). Der SDK-Span hat außerdem die Attribute jedes [SDK-Spans für eine Anfrage](https://platform.claude.com/docs/de/api/opentelemetry/spans#anthropic-resources-method).
| Attribut | Typ | Beschreibung |
| ------------ | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `error.type` | `string` | Der [Fehlertyp](https://platform.claude.com/docs/de/api/errors#http-errors) einer fehlgeschlagenen Anfrage, zum Beispiel `rate_limit_error`.
**SDK:** Außerdem die anderen Werte in [SDK-Spans für Anfragen](https://platform.claude.com/docs/de/api/opentelemetry/spans#anthropic-resources-method).
**API:** `api_error`, wenn die API die Verbindung ohne Fehlerantwort geschlossen hat oder wenn ein Stream aufgrund eines Fehlers in der API beendet wurde. |
### `anthropic.environment.work`
* **Quelle:** Die CLI und das SDK in Python, TypeScript und Go.
* **Art:** `INTERNAL`.
* **Übergeordnet:** Der Span, der in der Anwendung aktuell ist, wenn der Environment-Worker oder der Work-Poller das Work-Item erhält, oder keiner, wenn kein Span aktuell ist. In `ant beta:worker poll` ist der Span ein Root-Span.
* **Untergeordnet:** Die Spans für die Anfragen, die der Environment-Worker sendet, während er das Work-Item bearbeitet, und der [Tool-Span](https://platform.claude.com/docs/de/api/opentelemetry/spans#anthropic-tool-use-anthropic-mcp-tool-use-and-anthropic-custom-tool-use) jedes Tools, das er für das Work-Item ausführt.
Der Environment-Worker und der Work-Poller sind die [SDK-Helfer](https://platform.claude.com/docs/de/managed-agents/self-hosted-sandboxes#sdk-helpers), die Work-Items in einer selbst gehosteten Sandbox beanspruchen. Sie erzeugen einen `anthropic.environment.work`-Span für jedes Work-Item, von dem Zeitpunkt, an dem ein Poll das Work-Item zurückgibt, bis zum Ende seiner Verarbeitung.
| Attribut | Typ | Beschreibung |
| ------------------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| `anthropic.environment.id` | `string` | Die ID der Umgebung. |
| `anthropic.environment.work.id` | `string` | Die ID des Work-Items. |
| `anthropic.session.id` | `string` | Die ID der Session, zu der das Work-Item gehört. |
| `error.type` | `string` | Der `error.type` des Spans für die fehlgeschlagene Anfrage, falls eine Anfrage die Verarbeitung beendet hat. `client_error` bei jedem anderen Fehler. |
### `anthropic..`
* **Quelle:** Das SDK.
* **Art:** `CLIENT`.
* **Übergeordnet:** Der Span, der in der Anwendung aktuell ist, wenn sie die Methode aufruft, oder keiner, wenn kein Span aktuell ist.
* **Untergeordnet:** Keine.
Jede SDK-Methode, die eine Anfrage sendet und keinen eigenen Abschnitt auf dieser Seite hat, erzeugt einen `anthropic..`-Span, zum Beispiel `anthropic.models.list` oder `anthropic.files.upload`. Die Anfrage für jede weitere Seite einer Liste hat ihren eigenen Span.
Ein Span umfasst seine gesamte Anfrage, einschließlich Wiederholungen, und hat jedes Attribut des gleichnamigen API-Spans, sofern das SDK den Wert hat. Das SDK setzt `http.request.method` und `http.route` beim Starten des Spans, sodass ein Sampler sie verwenden kann.
Jeder SDK-Span für eine Anfrage, einschließlich [`anthropic.messages.create`](https://platform.claude.com/docs/de/api/opentelemetry/spans#anthropic-messages-create), [`anthropic.messages.count_tokens`](https://platform.claude.com/docs/de/api/opentelemetry/spans#anthropic-messages-count-tokens) und [`anthropic.messages.batches.`](https://platform.claude.com/docs/de/api/opentelemetry/spans#anthropic-messages-batches-method), hat die folgenden Attribute:
| Attribut | Typ | Beschreibung |
| --------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `gen_ai.conversation.id` | `string` | Die Konversations-ID, die mit der Option [`conversation_id` (typescript, java, php: `conversationId`; csharp: `ConversationId`; go: `option.WithOpenTelemetryConversationID()`)](https://platform.claude.com/docs/de/manage-claude/opentelemetry/sdk#configure-the-sdk) übergeben wurde. Ohne eine solche die Session-Thread-ID bei den Managed-Agents-Anfragen, die unter [Session-Attribute](https://platform.claude.com/docs/de/api/opentelemetry/spans#session-attributes) aufgeführt sind, und fehlt bei anderen Anfragen. |
| `anthropic..id` | `string` | Ein Attribut für jede ID im Pfad der Anfrage und eines für die ID eines Objekts, das die Methode erstellt. Der Name stammt aus dem Pfad, im Singular, zum Beispiel `anthropic.session.id` oder `anthropic.session.thread.id`. |
| `gen_ai.agent.id` | `string` | Die ID des Agenten, bei den Agent-Methoden. |
| `gen_ai.memory.store.id` | `string` | Die ID des Memory Stores, bei den Memory-Store-Methoden. |
| `gen_ai.memory.record.id` | `string` | Die ID der Memory, bei den Memory-Methoden. |
| `http.request.resend_count` | `int` | Die Anzahl der Male, die das SDK die Anfrage aus irgendeinem Grund erneut gesendet hat, etwa bei einer Wiederholung. Fehlt, wenn das SDK sie nicht erneut gesendet hat. |
| `error.type` | `string` | Der [Fehlertyp](https://platform.claude.com/docs/de/api/errors#http-errors) eines fehlgeschlagenen Aufrufs, zum Beispiel `rate_limit_error`. Der HTTP-Statuscode, zum Beispiel `502`, wenn die Fehlerantwort keinen Fehlertyp hat. `connection_error`, `client_timeout_error` oder `client_error`, wenn der Aufruf im SDK fehlgeschlagen ist. `api_error`, wenn der Server einen Stream vorzeitig beendet hat. |
| `server.address` | `string` | Der Host der Basis-URL des Clients, standardmäßig `api.anthropic.com`. Beim Client einer Cloud-Plattform der Host dieser Plattform. |
| `url.query` | `string` | Der Query-String der URL, nur mit den Query-Parametern, die der Endpunkt definiert. Fehlt, wenn es keine gibt. Im Nur-Metadaten-Modus fehlt er, wenn die Query einen sensiblen Parameter enthält, etwa `email`. |
| `url.full` | `string` | Die URL, zusammengesetzt aus `url.scheme`, `server.address`, dem Port, wenn die Basis-URL einen hat, `url.path` und `url.query`. Im Nur-Metadaten-Modus fehlt sie immer dann, wenn dieser Modus `url.query` weglässt. |