diagnostics-otel-Plugin
mittels OTLP/HTTP (protobuf). Logs können für
Container- und Sandbox-Log-Pipelines auch als JSONL in stdout geschrieben werden. Jeder Collector oder jedes Backend, der bzw. das
OTLP/HTTP akzeptiert, funktioniert ohne Codeänderungen. Informationen zu lokalen Datei-Logs finden Sie unter
Protokollierung.
- Diagnoseereignisse sind strukturierte, prozessinterne Datensätze, die vom Gateway und den gebündelten Plugins für Modellläufe, Nachrichtenfluss, Sitzungen, Warteschlangen und exec ausgegeben werden.
diagnostics-otelabonniert diese Ereignisse und exportiert sie als OpenTelemetry-Metriken, -Traces und -Logs über OTLP/HTTP und kann Log-Datensätze als JSONL nach stdout spiegeln.- Provider-Aufrufe erhalten einen W3C-
traceparent-Header aus OpenClaws vertrauenswürdigem Span-Kontext des Modellaufrufs, wenn der Provider-Transport benutzerdefinierte Header akzeptiert. Von Plugins ausgegebener Trace-Kontext wird nicht weitergegeben. - Exporter werden nur eingebunden, wenn sowohl die Diagnoseoberfläche als auch das Plugin aktiviert sind, sodass die prozessinternen Kosten standardmäßig nahezu null bleiben.
Schnellstart
openclaw plugins enable diagnostics-otel.
protocol unterstützt ausschließlich http/protobuf. Da traces und metrics standardmäßig aktiviert sind, bricht jeder andere Wert (einschließlich grpc) das gesamte diagnostics-otel-Abonnement mit einer unsupported protocol-Warnung ab – dadurch wird auch der stdout-Log-Export beendet. Setzen Sie traces: false und metrics: false explizit, wenn Sie nur logsExporter: "stdout" mit einem anderen Protokollwert als OTLP verwenden möchten.Exportierte Signale
Schalten Sie
traces, metrics und logs unabhängig voneinander um. Traces und Metriken
sind standardmäßig aktiviert, wenn diagnostics.otel.enabled wahr ist; Logs sind standardmäßig deaktiviert
und werden nur exportiert, wenn diagnostics.otel.logs ausdrücklich auf true gesetzt ist. Der Log-Export
verwendet standardmäßig OTLP; setzen Sie diagnostics.otel.logsExporter auf stdout für JSONL auf
stdout oder auf both für beides.
Konfigurationsreferenz
Umgebungsvariablen
Datenschutz und Inhaltserfassung
Unverarbeitete Modell-/Tool-Inhalte werden standardmäßig nicht exportiert. Spans enthalten begrenzte Bezeichner (Kanal, Provider, Modell, Fehlerkategorie, ausschließlich gehashte Anfrage-IDs, Tool-Quelle, Tool-Eigentümer, Skill-Name/-Quelle) und enthalten niemals Prompt-Text, Antworttext, Tool-Eingaben, Tool-Ausgaben, Skill-Dateipfade oder Sitzungsschlüssel. Werte, die wie bereichsgebundene Agent-Sitzungsschlüssel aussehen (zum Beispiel beginnend mitagent:), werden in Attributen mit niedriger Kardinalität durch unknown ersetzt. OTLP-Log-
Datensätze behalten standardmäßig Schweregrad, Logger, Codestelle, vertrauenswürdigen Trace-Kontext und
bereinigte Attribute bei; der unverarbeitete Nachrichtentext des Logs wird nur exportiert,
wenn diagnostics.otel.captureContent den booleschen Wert true hat. Granulare
captureContent.*-Unterschlüssel aktivieren niemals Log-Inhalte. Talk-Metriken exportieren ausschließlich
begrenzte Ereignismetadaten (Modus, Transport, Provider, Ereignistyp) – keine
Transkripte, Audio-Nutzlasten, Sitzungs-IDs, Turn-IDs, Anruf-IDs, Raum-IDs oder
Übergabe-Token.
Ausgehende Modellanfragen können einen W3C-traceparent-Header enthalten, der ausschließlich
aus OpenClaw-eigenem Diagnose-Trace-Kontext für den aktiven Modellaufruf generiert wird.
Vorhandene, vom Aufrufer bereitgestellte traceparent-Header werden ersetzt, sodass Plugins oder
benutzerdefinierte Provider-Optionen keine dienstübergreifende Trace-Abstammung vortäuschen können.
Setzen Sie diagnostics.otel.captureContent.* nur dann auf true, wenn Ihr Collector
und Ihre Aufbewahrungsrichtlinie für Prompt-, Antwort-, Tool- oder
System-Prompt-Text genehmigt sind. Jeder Unterschlüssel ist unabhängig:
inputMessages– Inhalt der Benutzeraufforderung.outputMessages– Inhalt der Modellantwort.toolInputs– Nutzlasten der Tool-Argumente.toolOutputs– Nutzlasten der Tool-Ergebnisse.systemPrompt– zusammengestellter System-/Entwickler-Prompt.toolDefinitions– Namen, Beschreibungen und Schemas der Modell-Tools.
openclaw.content.*-Attribute ausschließlich für diese Klasse.
Der boolesche Wert
captureContent: true aktiviert inputMessages, outputMessages, toolInputs, toolOutputs, toolDefinitions und OTLP-Log-Inhalte gemeinsam, jedoch nicht systemPrompt – setzen Sie captureContent.systemPrompt: true ausdrücklich, wenn Sie auch den zusammengestellten System-Prompt benötigen.toolInputs/toolOutputs-Inhalte werden für die Tool-Ausführungen der integrierten Agent-
Runtime erfasst (openclaw.content.tool_input und
gen_ai.tool.call.arguments bei abgeschlossenen/fehlerhaften Spans;
openclaw.content.tool_output und gen_ai.tool.call.result bei abgeschlossenen
Spans). Die openclaw.content.*-Namen bleiben die stabilen OpenClaw-Attributnamen;
die gen_ai.tool.call.*-Kopien spiegeln sie für Semconv-native Viewer.
Externe Harness-Tool-Aufrufe (Codex, Claude CLI) geben
tool.execution.*-Spans ohne Inhaltsnutzlasten aus. Erfasste Inhalte werden über einen
vertrauenswürdigen, ausschließlich für Listener bestimmten Kanal übertragen und niemals auf dem öffentlichen Diagnoseereignis-
Bus bereitgestellt.
Sampling und Leerung
- Traces:
diagnostics.otel.sampleRatelegt nur für den Root-Span einenTraceIdRatioBasedSamplerfest (0.0verwirft alle,1.0behält alle bei). Wenn nicht festgelegt, wird der Standard des OpenTelemetry SDK verwendet (immer aktiviert). - Metriken:
diagnostics.otel.flushIntervalMs(auf ein Minimum von1000begrenzt); wenn nicht festgelegt, wird der Standard des SDK für den periodischen Export verwendet. - Protokolle: OTLP-Protokolle berücksichtigen
logging.level(Dateiprotokollstufe) und verwenden den Schwärzungspfad für diagnostische Protokolldatensätze, nicht die Konsolenformatierung. Installationen mit hohem Datenaufkommen sollten Sampling/Filterung im OTLP-Collector gegenüber lokalem Sampling bevorzugen. Legen Siediagnostics.otel.logsExporter: "stdout"fest, wenn Ihre Plattform stdout/stderr bereits an einen Protokollprozessor weiterleitet und Sie keinen Collector für OTLP-Protokolle haben. stdout-Datensätze bestehen aus einem JSON-Objekt pro Zeile mitts,signal,service.name, Schweregrad, Inhalt, geschwärzten Attributen und vertrauenswürdigen Trace- Feldern, sofern verfügbar. - Dateiprotokoll-Korrelation: JSONL-Dateiprotokolle enthalten
traceId,spanId,parentSpanIdundtraceFlagsauf der obersten Ebene, wenn der Protokollaufruf einen gültigen diagnostischen Trace-Kontext enthält. Dadurch können Protokollprozessoren lokale Protokollzeilen mit exportierten Spans verknüpfen. - Anfragekorrelation: Gateway-HTTP-Anfragen und WebSocket-Frames erstellen
einen internen Anfrage-Trace-Bereich. Protokolle und diagnostische Ereignisse innerhalb dieses
Bereichs übernehmen standardmäßig den Anfrage-Trace, während Spans für Agent-Ausführungen und Modellaufrufe
als untergeordnete Elemente erstellt werden, sodass die
traceparent-Header des Providers im selben Trace verbleiben. - Modellaufruf-Korrelation:
openclaw.model.call-Spans enthalten standardmäßig unbedenkliche Größenangaben zu Prompt-Komponenten und Token-Attribute pro Aufruf, wenn das Provider- Ergebnis Nutzungsdaten bereitstellt.openclaw.model.usagebleibt der Span für die Abrechnung auf Ausführungsebene für aggregierte Kosten-, Kontext- und Kanal-Dashboards und verbleibt im selben diagnostischen Trace, wenn die ausgebende Laufzeitumgebung über einen vertrauenswürdigen Trace-Kontext verfügt.
Beobachtungseinheiten für Modellaufrufe
Jederopenclaw.model.call-Span kennzeichnet über
openclaw.model_call.observation_unit, was sein Lebenszyklus misst:
request– eine beobachtbare Modell-/Provider-Anfrage. Native eingebettete Modell- aufrufe verwenden diese Einheit, und Exporter behandeln einen fehlenden Wert zur Kompatibilität mit älteren oder externen Emittern alsrequest.turn– ein undurchsichtiger Agent-CLI-Durchlauf, der verborgene Modellanfragen, Wiederholungsversuche, Tool-Arbeit oder Hintergrundarbeit enthalten kann. Aufrufe der Claude Code CLI und des Codex-App-Servers verwenden diese Einheit.
chat, generate_content oder text_completion), während Durchlauf-Spans
gen_ai.operation.name = invoke_agent verwenden. Beide fließen in
gen_ai.client.operation.duration ein, wobei der Operationsname die Latenz direkter
Anfragen von der Latenz vollständiger Durchläufe getrennt hält. Die OTEL-Modellaufruf-
Metriken von OpenClaw enthalten außerdem openclaw.model_call.observation_unit; die Prometheus-
Modellaufrufmetriken stellen das entsprechende Label observation_unit bereit.
Genauigkeit der Modellaufrufe der Claude Code CLI
Durchläufe der Claude Code CLI geben einen synthetischenopenclaw.model.call-
Span auf Durchlaufebene aus. Dies sind keine Anthropic-HTTP-Anfrage-Spans. Sie verwenden openclaw.api = claude-code, openclaw.model_call.observation_unit = turn und kennzeichnen
die Operation als gen_ai.operation.name = invoke_agent. Sie kennzeichnen
die CLI-Grenze von OpenClaw über
openclaw.transport:
stdio– einmaliger lokaler Claude-Code-Prozess.stdio-live– ein Durchlauf in einer verwalteten, persistenten Claude-stdio-Sitzung.paired-node-cli– einmalige Claude-Code-Ausführung, die an eine gekoppelte Node delegiert wird.
openclaw.harness.run (openclaw.harness.id = claude-cli)
enthält openclaw.run, das den Claude-openclaw.model.call-
Span enthält. Die Harness- und Ausführungs-Spans sind synthetische OpenClaw-Durchlaufgrenzen, keine
internen Phasen von Claude Code. Einmalige und verwaltete stdio-Durchläufe verwenden dieselbe
Hierarchie; ein tatsächlicher Wiederholungsversuch mit einer neuen Sitzung erstellt ein weiteres untergeordnetes Modellaufrufelement innerhalb
derselben OpenClaw-Ausführung.
Der Span beginnt, wenn OpenClaw den vorbereiteten CLI-Durchlauf annimmt, und endet erst,
nachdem dieser Durchlauf erfolgreich war oder fehlgeschlagen ist. Bei verwalteten Sitzungen
beendet ein vorläufiges Erfolgsergebnis den Span nicht, während Claude ergebnisspeichernde Hintergrundagenten oder
Workflows meldet; erst das endgültige Ergebnis nach dem Leeren beendet ihn. Abbruch, Zeitüberschreitung, Prozessfehler,
Ausgabe-/Analysefehler und andere Durchlauffehler beenden denselben Span mit einem Fehler.
Claude Code meldet die Nutzung pro Assistentennachricht und kann in seinem abschließenden Ergebnis auch die kumulierte
Nutzung melden. Die Antwortabrechnung von OpenClaw verwendet weiterhin die
letzte Assistentennachricht, sodass sich die bestehende Kostensemantik nicht ändert; der
Modellaufruf-Span auf Durchlaufebene verwendet die abschließende kumulierte Nutzung, sofern verfügbar,
einschließlich Cache-Lese- und Cache-Erstellungs-Token.
Für diese CLI-Spans beschreiben Byte- und Zeitfelder die beobachtbare OpenClaw-
CLI-Grenze:
openclaw.model_call.request_bytesist die UTF-8-Größe des Prompt-Werts, der über einmaliges stdin/argv oder die JSONL-Benutzerhülle der verwalteten stdio-Sitzung gesendet wird. Sie entspricht nicht der Größe der verborgenen Modellanfrage von Claude Code.openclaw.model_call.response_bytesist die UTF-8-Größe der während des Durchlaufs beobachteten stdout-Ausgabe der Claude CLI. Sie entspricht nicht der Größe der Anthropic-HTTP-Antwort.openclaw.model_call.time_to_first_byte_msist die Zeit bis zur ersten beobachtbaren stdout- oder stderr-Ausgabe der Claude CLI. Sie ist nicht die Netzwerk-TTFB.
captureContent-Felder aktiviert sind, exportiert der Span
den effektiven Prompt, den OpenClaw an Claude Code sendet, den von OpenClaw angefügten System-
Prompt sowie sichtbaren Assistententext, Schlussfolgerungen und die Identität von Tool-Aufrufen über
gen_ai.input.messages, gen_ai.output.messages und
gen_ai.system_instructions. Tool-Argumente, undurchsichtige Denksignaturen und
Tool-Ergebnisse werden aus der Claude-Assistentenhülle ausgelassen. OpenClaw erhebt keinen
Anspruch auf Zugriff auf den privaten System-Prompt von Claude Code, die verborgene fortgesetzte oder
komprimierte Anfragenutzlast, native interne Tool-Schemas, die rohe Anthropic-HTTP-
Anfrage, interne Wiederholungsversuche, die Upstream-Anfrage-ID oder die tatsächliche Netzwerk-TTFB. Da
Claude Code seine effektiven nativen Tool-Definitionen nicht korrekt offenlegt,
füllen diese Spans gen_ai.tool.definitions nicht aus.
Externe Claude-Harness-Tool-Spans bleiben auch dann auf Metadaten beschränkt, wenn die Erfassung von Tool-Inhalten
aktiviert ist. Wie bei jedem Modell-Span verwenden erfasste Claude-CLI-Inhalte
den ausschließlich vertrauenswürdigen Listenern vorbehaltenen Pfad sowie die bestehenden Schwärzungs- und Größen-
grenzen des Exporters; Inhalte bleiben standardmäßig deaktiviert.
Exportierte Metriken
Modellnutzung
openclaw.tokens(Zähler, Attribute:openclaw.token,openclaw.channel,openclaw.provider,openclaw.model,openclaw.agent)openclaw.cost.usd(Zähler, Attribute:openclaw.channel,openclaw.provider,openclaw.model)openclaw.run.duration_ms(Histogramm, Attribute:openclaw.channel,openclaw.provider,openclaw.model)openclaw.context.tokens(Histogramm, Attribute:openclaw.context,openclaw.channel,openclaw.provider,openclaw.model)gen_ai.client.token.usage(Histogramm, Metrik der semantischen GenAI-Konventionen, Attribute:gen_ai.token.type=input/output,gen_ai.provider.name,gen_ai.operation.name,gen_ai.request.model)gen_ai.client.operation.duration(Histogramm, Sekunden, Metrik der semantischen GenAI-Konventionen für Modellanfragen und synthetische Agent-Durchläufe; Attribute:gen_ai.provider.name,gen_ai.operation.name,gen_ai.request.model, optionalerror.type; Durchlaufbeobachtungen verwendengen_ai.operation.name = invoke_agent)openclaw.model_call.duration_ms(Histogramm, Attribute:openclaw.provider,openclaw.model,openclaw.api,openclaw.transport,openclaw.model_call.observation_unit, zusätzlichopenclaw.errorCategoryundopenclaw.failureKindbei klassifizierten Fehlern)openclaw.model_call.request_bytes(Histogramm, UTF-8-Byte-Größe der endgültigen Modellanfragenutzlast; bei der Claude Code CLI die oben beschriebene beobachtbare Prompt-Eingabe/-Hülle; kein Inhalt der rohen Nutzlast)openclaw.model_call.response_bytes(Histogramm, UTF-8-Byte-Größe gestreamter Antwortblock-Nutzlasten; hochfrequente Text-, Denk- und Tool-Aufruf-Deltas zählen nur inkrementelledelta-Bytes; bei der Claude Code CLI beobachtete stdout-Bytes; kein roher Antwortinhalt)openclaw.model_call.time_to_first_byte_ms(Histogramm, verstrichene Zeit vor dem ersten gestreamten Antwortereignis; bei der Claude Code CLI die erste beobachtbare CLI-Ausgabe anstelle der Netzwerk-TTFB)openclaw.model.failover(Zähler, Attribute:openclaw.provider,openclaw.model,openclaw.failover.to_provider,openclaw.failover.to_model,openclaw.failover.reason,openclaw.failover.suspended,openclaw.lane)openclaw.skill.used(Zähler, Attribute:openclaw.skill.name,openclaw.skill.source,openclaw.skill.activation, optionalopenclaw.agent, optionalopenclaw.toolName)
Nachrichtenfluss
openclaw.webhook.received(Zähler, Attribute:openclaw.channel,openclaw.webhook)openclaw.webhook.error(Zähler, Attribute:openclaw.channel,openclaw.webhook)openclaw.webhook.duration_ms(Histogramm, Attribute:openclaw.channel,openclaw.webhook)openclaw.message.queued(Zähler, Attribute:openclaw.channel,openclaw.source)openclaw.message.received(Zähler, Attribute:openclaw.channel,openclaw.source)openclaw.message.dispatch.started(Zähler, Attribute:openclaw.channel,openclaw.source)openclaw.message.dispatch.completed(Zähler, Attribute:openclaw.channel,openclaw.outcome,openclaw.reason,openclaw.source)openclaw.message.dispatch.duration_ms(Histogramm, Attribute:openclaw.channel,openclaw.outcome,openclaw.reason,openclaw.source)openclaw.message.processed(Zähler, Attribute:openclaw.channel,openclaw.outcome)openclaw.message.duration_ms(Histogramm, Attribute:openclaw.channel,openclaw.outcome)openclaw.message.delivery.started(Zähler, Attribute:openclaw.channel,openclaw.delivery.kind)openclaw.message.delivery.duration_ms(Histogramm, Attribute:openclaw.channel,openclaw.delivery.kind,openclaw.outcome,openclaw.errorCategory)
Talk
openclaw.talk.event(Zähler, Attribute:openclaw.talk.event_type,openclaw.talk.mode,openclaw.talk.transport,openclaw.talk.brain,openclaw.talk.provider)openclaw.talk.event.duration_ms(Histogramm, Attribute: wie beiopenclaw.talk.event; wird ausgegeben, wenn ein Talk-Ereignis eine Dauer meldet)openclaw.talk.audio.bytes(Histogramm, Attribute: wie beiopenclaw.talk.event; wird für Talk-Audioframe-Ereignisse ausgegeben, die eine Bytelänge melden)
Warteschlangen und Sitzungen
openclaw.queue.lane.enqueue(Zähler, Attribute:openclaw.lane)openclaw.queue.lane.dequeue(Zähler, Attribute:openclaw.lane)openclaw.queue.depth(Histogramm, Attribute:openclaw.laneoderopenclaw.channel=heartbeat)openclaw.queue.wait_ms(Histogramm, Attribute:openclaw.lane)openclaw.session.state(Zähler, Attribute:openclaw.state,openclaw.reason)openclaw.session.stuck(Zähler, Attribute:openclaw.state; wird bei wiederherstellbarer veralteter Sitzungsverwaltung ausgegeben)openclaw.session.stuck_age_ms(Histogramm, Attribute:openclaw.state; wird bei wiederherstellbarer veralteter Sitzungsverwaltung ausgegeben)openclaw.session.turn.created(Zähler, Attribute:openclaw.agent,openclaw.channel,openclaw.trigger)openclaw.session.recovery.requested(Zähler, Attribute:openclaw.state,openclaw.action,openclaw.active_work_kind,openclaw.reason)openclaw.session.recovery.completed(Zähler, Attribute:openclaw.state,openclaw.action,openclaw.status,openclaw.active_work_kind,openclaw.reason)openclaw.session.recovery.age_ms(Histogramm, Attribute: identisch mit dem zugehörigen Wiederherstellungszähler)openclaw.run.attempt(Zähler, Attribute:openclaw.attempt)
Telemetrie zur Sitzungserreichbarkeit
Eineprocessing-Sitzung nähert sich nicht dem integrierten Erreichbarkeitsschwellenwert, solange OpenClaw Fortschritte bei Antworten, Tools, Status, Blöcken oder der ACP-Laufzeit beobachtet. Tippaktivitäts-Signale zählen nicht als Fortschritt, sodass ein stummes Modell oder Harness weiterhin erkannt werden kann.
OpenClaw klassifiziert Sitzungen anhand der Arbeit, die noch beobachtet werden kann:
session.long_running: Aktive eingebettete Arbeit, Modellaufrufe oder Tool-Aufrufe machen weiterhin Fortschritte. Eigene stumme Modellaufrufe werden vor dem integrierten Abbruchschwellenwert ebenfalls als lang laufend gemeldet, sodass langsame oder nicht streamende Modell-Provider nicht wie blockierte Gateway-Sitzungen erscheinen, solange ihr Abbruch beobachtbar ist.session.stalled: Aktive Arbeit ist vorhanden, aber der aktive Lauf hat in letzter Zeit keinen Fortschritt gemeldet. Eigene Modellaufrufe wechseln beim oder nach dem integrierten Abbruchschwellenwert vonsession.long_runningzusession.stalled; veraltete Modell-/Tool-Aktivität ohne Besitzer wird nicht als harmlose lang laufende Arbeit behandelt. Blockierte eingebettete Läufe werden zunächst nur beobachtet und nach Erreichen des Abbruchschwellenwerts ohne Fortschritt abgebrochen und geleert, damit hinter der Lane eingereihte Durchläufe fortgesetzt werden können.session.stuck: Veraltete Sitzungsverwaltung ohne aktive Arbeit oder eine inaktive eingereihte Sitzung mit veralteter Modell-/Tool-Aktivität ohne Besitzer. Dadurch wird die betroffene Sitzungslane unmittelbar freigegeben, nachdem die Wiederherstellungsprüfungen bestanden wurden.
session.recovery.requested und
session.recovery.completed aus. Der diagnostische Sitzungsstatus wird nur nach einem
verändernden Wiederherstellungsergebnis (aborted oder released) und nur dann als inaktiv markiert, wenn
dieselbe Verarbeitungsgeneration noch aktuell ist.
Nur session.stuck gibt den Zähler openclaw.session.stuck, das
Histogramm openclaw.session.stuck_age_ms und den Span openclaw.session.stuck
aus. Wiederholte session.stuck-Diagnosen werden mit zunehmendem Abstand ausgeführt, solange die Sitzung
unverändert bleibt. Daher sollten Dashboards bei anhaltenden Anstiegen Alarm auslösen und nicht
bei jedem Heartbeat-Takt. Informationen zur Konfigurationsoption und zu den Standardwerten finden Sie in der
Konfigurationsreferenz.
Erreichbarkeitswarnungen geben außerdem Folgendes aus:
openclaw.liveness.warning(Zähler, Attribute:openclaw.liveness.reason)openclaw.liveness.event_loop_delay_p99_ms(Histogramm, Attribute:openclaw.liveness.reason)openclaw.liveness.event_loop_delay_max_ms(Histogramm, Attribute:openclaw.liveness.reason)openclaw.liveness.event_loop_utilization(Histogramm, Attribute:openclaw.liveness.reason)openclaw.liveness.cpu_core_ratio(Histogramm, Attribute:openclaw.liveness.reason)
Harness-Lebenszyklus
openclaw.harness.duration_ms(Histogramm, Attribute:openclaw.harness.id,openclaw.harness.plugin,openclaw.outcome, bei Fehlernopenclaw.harness.phase)
Tool-Ausführung und Schleifenerkennung
openclaw.tool.execution.duration_ms(Histogramm, Attribute:gen_ai.tool.name,openclaw.toolName,openclaw.tool.source,openclaw.tool.owner,openclaw.tool.params.kind, bei Fehlern zusätzlichopenclaw.errorCategory)openclaw.tool.execution.blocked(Zähler, Attribute:gen_ai.tool.name,openclaw.toolName,openclaw.tool.source,openclaw.tool.owner,openclaw.tool.params.kind,openclaw.deniedReason)openclaw.tool.loop(Zähler, Attribute:openclaw.toolName,openclaw.loop.level,openclaw.loop.action,openclaw.loop.detector,openclaw.loop.count, optionalopenclaw.loop.paired_tool; wird ausgegeben, wenn eine sich wiederholende Tool-Aufrufschleife erkannt wird)
Exec
openclaw.exec.duration_ms(Histogramm, Attribute:openclaw.exec.target,openclaw.exec.mode,openclaw.outcome,openclaw.failureKind)
Diagnoseinterna (Arbeitsspeicher, Nutzlasten, Exporter-Zustand)
openclaw.payload.large(Zähler, Attribute:openclaw.payload.surface,openclaw.payload.action,openclaw.channel,openclaw.plugin,openclaw.reason)openclaw.payload.large_bytes(Histogramm, Attribute: identisch mitopenclaw.payload.large)openclaw.memory.rss_bytes/openclaw.memory.heap_used_bytes/openclaw.memory.heap_total_bytes/openclaw.memory.external_bytes/openclaw.memory.array_buffers_bytes(Histogramme, keine Attribute; Stichproben des Prozessspeichers)openclaw.memory.pressure(Zähler, Attribute:openclaw.memory.level,openclaw.memory.reason)openclaw.diagnostic.async_queue.dropped(Zähler, Attribute:openclaw.diagnostic.async_queue.drop_class; Verwerfungen aufgrund von Rückstau in der internen Diagnosewarteschlange)openclaw.telemetry.exporter.events(Zähler, Attribute:openclaw.exporter,openclaw.signal,openclaw.status, optionalopenclaw.reason, optionalopenclaw.errorCategory; Selbsttelemetrie zum Lebenszyklus und zu Fehlern des Exporters)
Exportierte Spans
openclaw.model.usageopenclaw.channel,openclaw.provider,openclaw.modelopenclaw.tokens.*(Eingabe/Ausgabe/Cache-Lesen/Cache-Schreiben/Gesamt)gen_ai.systemstandardmäßig odergen_ai.provider.name, wenn die neuesten semantischen GenAI-Konventionen aktiviert sindgen_ai.request.model,gen_ai.operation.name,gen_ai.usage.*
openclaw.runopenclaw.outcome,openclaw.channel,openclaw.provider,openclaw.model,openclaw.errorCategory
openclaw.model.callgen_ai.systemstandardmäßig odergen_ai.provider.name, wenn die neuesten semantischen GenAI-Konventionen aktiviert sindgen_ai.request.model,gen_ai.operation.name,openclaw.provider,openclaw.model,openclaw.api,openclaw.transport,openclaw.model_call.observation_unit(requestoderturn)openclaw.errorCategory,error.typeund bei Fehlern optionalopenclaw.failureKindopenclaw.model_call.request_bytes,openclaw.model_call.response_bytes,openclaw.model_call.time_to_first_byte_msopenclaw.model_call.prompt.input_messages_count,openclaw.model_call.prompt.input_messages_chars,openclaw.model_call.prompt.system_prompt_chars,openclaw.model_call.prompt.tool_definitions_count,openclaw.model_call.prompt.tool_definitions_chars,openclaw.model_call.prompt.total_chars(nur unbedenkliche Komponentengrößen, kein Prompt-Text)openclaw.model_call.usage.*undgen_ai.usage.*, wenn das Ergebnis Nutzungsdaten für diese Anfrage oder den aggregierten Durchlauf enthält- Span-Ereignis
openclaw.provider.requestmit dem Attributopenclaw.upstreamRequestIdHash(begrenzt, hashbasiert), wenn das Ergebnis des vorgelagerten Providers eine Anfrage-ID bereitstellt; Roh-IDs werden niemals exportiert - Mit
OTEL_SEMCONV_STABILITY_OPT_IN=gen_ai_latest_experimentalverwenden Anfrage-Spans den neuesten GenAI-Inferenz-Span-Namen{gen_ai.operation.name} {gen_ai.request.model}. Durchlauf-Spans verwendeninvoke_agent, da OpenClaw an der undurchsichtigen CLI-Grenze keinen nativen Agentennamen beansprucht. Beide verwenden die Span-ArtCLIENTanstelle vonopenclaw.model.call.
openclaw.harness.runopenclaw.harness.id,openclaw.harness.plugin,openclaw.outcome,openclaw.provider,openclaw.model,openclaw.channel- Bei Abschluss:
openclaw.harness.result_classification,openclaw.harness.yield_detected,openclaw.harness.items.started,openclaw.harness.items.completed,openclaw.harness.items.active - Bei einem Fehler:
openclaw.harness.phase,openclaw.errorCategory, optionalopenclaw.harness.cleanup_failed
openclaw.tool.executiongen_ai.tool.name,gen_ai.operation.name(execute_tool),openclaw.toolName,openclaw.tool.source, optionalgen_ai.tool.call.id,openclaw.tool.owner,openclaw.tool.params.*- Bei Fehlern optional
openclaw.errorCategory/openclaw.errorCode, bei Ablehnung durch Richtlinie oder Sandboxopenclaw.deniedReasonundopenclaw.outcome=blocked
openclaw.execopenclaw.exec.target,openclaw.exec.mode,openclaw.outcome,openclaw.failureKind,openclaw.exec.command_length,openclaw.exec.exit_code,openclaw.exec.exit_signal,openclaw.exec.timed_out
openclaw.webhook.processedopenclaw.channel,openclaw.webhook
openclaw.webhook.erroropenclaw.channel,openclaw.webhook,openclaw.error
openclaw.message.processedopenclaw.channel,openclaw.outcome,openclaw.reason
openclaw.message.deliveryopenclaw.channel,openclaw.delivery.kind,openclaw.outcome,openclaw.errorCategory,openclaw.delivery.result_count
openclaw.session.stuckopenclaw.state,openclaw.ageMs,openclaw.queueDepth
openclaw.context.assembledopenclaw.prompt.size,openclaw.history.size,openclaw.context.tokens,openclaw.errorCategory(keine Inhalte von Prompt, Verlauf, Antwort oder Sitzungsschlüssel)
openclaw.tool.loopopenclaw.toolName,openclaw.loop.level,openclaw.loop.action,openclaw.loop.detector,openclaw.loop.count, optionalopenclaw.loop.paired_tool(keine Schleifennachrichten, Parameter oder Tool-Ausgaben)
openclaw.memory.pressureopenclaw.memory.level,openclaw.memory.reason,openclaw.memory.rss_bytes,openclaw.memory.heap_used_bytes,openclaw.memory.heap_total_bytes,openclaw.memory.external_bytes,openclaw.memory.array_buffers_bytes, optionalopenclaw.memory.threshold_bytes/openclaw.memory.rss_growth_bytes/openclaw.memory.window_ms
openclaw.content.*-Attribute für die spezifischen
Inhaltsklassen enthalten, die aktiviert wurden.
Katalog der Diagnoseereignisse
Die nachstehenden Ereignisse bilden die Grundlage für die oben aufgeführten Metriken und Spans oder stehen für direkte Plugin-Abonnements zur Verfügung.run.progress und run.execution_phase sind reine
Lebenszyklussignale für direkte Abonnements; das diagnostics-otel-Plugin exportiert sie nicht als
eigenständige OTLP-Signale. Ereignisarten und run.execution_phase.phase-Werte sind
additiv. TypeScript-Consumer sollten Standardzweige beibehalten, anstatt davon auszugehen,
dass eine der beiden Unions dauerhaft vollständig ist.
Modellnutzung
model.usage– Token, Kosten, Dauer, Kontext, Provider/Modell/Kanal, Sitzungs-IDs.usagedient der Provider-/Durchlaufabrechnung für Kosten und Telemetrie;context.usedist die aktuelle Prompt-/Kontext-Momentaufnahme und kann niedriger als der Provider-Wertusage.totalsein, wenn zwischengespeicherte Eingaben oder Tool-Schleifenaufrufe beteiligt sind.
webhook.received/webhook.processed/webhook.errormessage.queued/message.processedmessage.delivery.started/message.delivery.completed/message.delivery.error
queue.lane.enqueue/queue.lane.dequeuesession.state/session.long_running/session.stalled/session.stuckrun.attempt/run.progressrun.execution_phase(öffentliche, sitzungskorrelierte Startmeilensteine des eingebetteten Runners)diagnostic.heartbeat(aggregierte Zähler: Webhooks/Warteschlange/Sitzung)
harness.run.started/harness.run.completed/harness.run.error– Lebenszyklus pro Lauf für das Agenten-Harness. EnthältharnessId, optionalpluginId, Provider/Modell/Kanal und Lauf-ID. Bei Abschluss werdendurationMs,outcome, optionalresultClassification,yieldDetectedsowieitemLifecycle-Zähler hinzugefügt. Bei Fehlern werdenphase(prepare/start/send/resolve/cleanup),errorCategoryund optionalcleanupFailedhinzugefügt.
exec.process.completed– Terminalergebnis, Dauer, Ziel, Modus, Exit- Code und Fehlerart. Befehlstext und Arbeitsverzeichnisse sind nicht enthalten.exec.approval.followup_suppressed– Veraltete Genehmigungsnachverfolgung verworfen nach einer erneuten Sitzungsbindung. EnthältapprovalId,reason(session_rebound),phase(direct_deliveryodergateway_preflight) und den Zeitstempel des Dispatchers. Sitzungsschlüssel, Routen und Befehlstext sind nicht enthalten.
Ohne Exporter
Halten Sie Diagnoseereignisse für Plugins oder benutzerdefinierte Senken verfügbar, ohnediagnostics-otel auszuführen:
logging.level
anzuheben. Bei Flags wird die Groß-/Kleinschreibung nicht berücksichtigt und Platzhalter werden unterstützt (telegram.* oder
*):
logging.file) geschrieben und weiterhin
durch logging.redactSensitive bereinigt. Vollständige Anleitung:
Diagnose-Flags.
Deaktivieren
diagnostics-otel aus plugins.allow weg, oder führen Sie
openclaw plugins disable diagnostics-otel aus.
Verwandte Themen
- Protokollierung – Dateiprotokolle, Konsolenausgabe, CLI-Tailing und die Registerkarte „Protokolle“ der Control UI
- Interna der Gateway-Protokollierung – WS-Protokollstile, Subsystempräfixe und Konsolenerfassung
- Diagnose-Flags – gezielte Debug-Protokoll-Flags
- Diagnoseexport – Support-Bundle-Tool für Betreiber (getrennt vom OTEL-Export)
- Konfigurationsreferenz – vollständige Feldreferenz für
diagnostics.*