Ekspor OpenTelemetry

OpenClaw mengekspor diagnostik melalui plugin resmi diagnostics-otel menggunakan OTLP/HTTP (protobuf). Log juga dapat ditulis sebagai JSONL stdout untuk alur log kontainer dan sandbox. Setiap kolektor atau backend yang menerima OTLP/HTTP dapat digunakan tanpa perubahan kode. Untuk log berkas lokal, lihat Logging.

• Peristiwa diagnostik adalah catatan terstruktur dalam proses yang dipancarkan oleh Gateway dan plugin bawaan untuk eksekusi model, alur pesan, sesi, antrean, dan eksekusi.
• diagnostics-otel berlangganan peristiwa tersebut dan mengekspornya sebagai metrik, jejak, dan log OpenTelemetry melalui OTLP/HTTP, serta dapat mencerminkan catatan log ke JSONL stdout.
• Panggilan penyedia menerima header W3C traceparent dari konteks span panggilan model tepercaya milik OpenClaw ketika transport penyedia menerima header khusus. Konteks jejak yang dipancarkan plugin tidak diteruskan.
• Eksportir hanya dipasang ketika permukaan diagnostik dan plugin sama-sama diaktifkan, sehingga biaya dalam proses secara default tetap mendekati nol.

Mulai cepat

openclaw plugins install clawhub:@openclaw/diagnostics-otel

{  plugins: {    allow: ["diagnostics-otel"],    entries: {      "diagnostics-otel": { enabled: true },    },  },  diagnostics: {    enabled: true,    otel: {      enabled: true,      endpoint: "http://otel-collector:4318",      protocol: "http/protobuf",      serviceName: "openclaw-gateway",      traces: true,      metrics: true,      logs: true,      sampleRate: 0.2,      flushIntervalMs: 60000,    },  },}

Atau aktifkan plugin dari CLI: openclaw plugins enable diagnostics-otel.

Sinyal yang diekspor

Aktifkan atau nonaktifkan traces, metrics, dan logs secara terpisah. Jejak dan metrik secara default aktif ketika diagnostics.otel.enabled bernilai true; log secara default nonaktif dan hanya diekspor ketika diagnostics.otel.logs secara eksplisit bernilai true. Ekspor log secara default menggunakan OTLP; tetapkan diagnostics.otel.logsExporter ke stdout untuk JSONL di stdout, atau both untuk keduanya.

Referensi konfigurasi

{  diagnostics: {    enabled: true,    otel: {      enabled: true,      endpoint: "http://otel-collector:4318",      tracesEndpoint: "http://otel-collector:4318/v1/traces",      metricsEndpoint: "http://otel-collector:4318/v1/metrics",      logsEndpoint: "http://otel-collector:4318/v1/logs",      protocol: "http/protobuf", // grpc menonaktifkan ekspor OTLP      serviceName: "openclaw-gateway", // jika tidak ditetapkan, gunakan OTEL_SERVICE_NAME, lalu "openclaw"      headers: { "x-collector-token": "..." },      traces: true,      metrics: true,      logs: true,      logsExporter: "otlp", // otlp | stdout | both      sampleRate: 0.2, // pengambil sampel span akar, 0.0..1.0      flushIntervalMs: 60000, // interval ekspor metrik (min. 1000 ms)      captureContent: {        enabled: false,        inputMessages: false,        outputMessages: false,        toolInputs: false,        toolOutputs: false,        systemPrompt: false,        toolDefinitions: false,      },    },  },}

Variabel lingkungan

Privasi dan perekaman konten

Konten mentah model/alat tidak diekspor secara default. Span membawa pengenal berbatas (saluran, penyedia, model, kategori kesalahan, ID permintaan berbasis hash saja, sumber alat, pemilik alat, nama/sumber skill) dan tidak pernah menyertakan teks prompt, teks respons, input alat, output alat, jalur berkas skill, atau kunci sesi. Nilai yang menyerupai kunci sesi agen bercakupan (misalnya diawali dengan agent:) diganti dengan unknown pada atribut berkardinalitas rendah. Catatan log OTLP secara default mempertahankan tingkat keparahan, pencatat log, lokasi kode, konteks jejak tepercaya, dan atribut yang telah disanitasi; isi pesan log mentah hanya diekspor ketika diagnostics.otel.captureContent bernilai boolean true. Subkunci terperinci captureContent.* tidak pernah mengaktifkan isi log. Metrik Talk hanya mengekspor metadata peristiwa berbatas (mode, transport, penyedia, jenis peristiwa)—tanpa transkrip, muatan audio, ID sesi, ID giliran, ID panggilan, ID ruang, atau token serah-terima.

Permintaan model keluar dapat menyertakan header W3C traceparent yang hanya dibuat dari konteks jejak diagnostik milik OpenClaw untuk panggilan model yang aktif. Header traceparent yang sudah diberikan pemanggil akan diganti, sehingga plugin atau opsi penyedia khusus tidak dapat memalsukan asal-usul jejak lintas layanan.

Tetapkan diagnostics.otel.captureContent.* ke true hanya ketika kolektor dan kebijakan retensi Anda disetujui untuk teks prompt, respons, alat, atau prompt sistem. Setiap subkunci bersifat independen:

• inputMessages—konten prompt pengguna.
• outputMessages—konten respons model.
• toolInputs—muatan argumen alat.
• toolOutputs—muatan hasil alat.
• systemPrompt—prompt sistem/pengembang yang telah disusun.
• toolDefinitions—nama, deskripsi, dan skema alat model.

Ketika subkunci mana pun diaktifkan, span model dan alat mendapatkan atribut openclaw.content.* yang berbatas dan telah disunting hanya untuk kelas tersebut.

Konten toolInputs/toolOutputs direkam untuk eksekusi alat pada runtime agen bawaan (openclaw.content.tool_input dan gen_ai.tool.call.arguments pada span selesai/kesalahan; openclaw.content.tool_output dan gen_ai.tool.call.result pada span selesai). Nama openclaw.content.* tetap menjadi nama atribut OpenClaw yang stabil; salinan gen_ai.tool.call.* mencerminkannya untuk penampil native semconv. Panggilan alat harness eksternal (Codex, Claude CLI) memancarkan span tool.execution.* tanpa muatan konten. Konten yang direkam berjalan melalui saluran tepercaya khusus pemroses dan tidak pernah ditempatkan pada bus peristiwa diagnostik publik.

Pengambilan sampel dan pengosongan

• Jejak: diagnostics.otel.sampleRate menetapkan TraceIdRatioBasedSampler hanya pada span akar (0.0 membuang semuanya, 1.0 menyimpan semuanya). Jika tidak ditetapkan, nilai bawaan OpenTelemetry SDK digunakan (selalu aktif).
• Metrik: diagnostics.otel.flushIntervalMs (dibatasi ke nilai minimum 1000); jika tidak ditetapkan, nilai bawaan ekspor berkala SDK digunakan.
• Log: Log OTLP mengikuti logging.level (tingkat log berkas) dan menggunakan jalur penyamaran rekaman log diagnostik, bukan pemformatan konsol. Instalasi bervolume tinggi sebaiknya memilih pengambilan sampel/pemfilteran kolektor OTLP daripada pengambilan sampel lokal. Tetapkan diagnostics.otel.logsExporter: "stdout" jika platform Anda sudah mengirim stdout/stderr ke pemroses log dan Anda tidak memiliki kolektor log OTLP. Rekaman stdout berupa satu objek JSON per baris dengan ts, signal, service.name, tingkat keparahan, isi, atribut yang disamarkan, dan bidang jejak tepercaya jika tersedia.
• Korelasi log berkas: Log berkas JSONL menyertakan traceId, spanId, parentSpanId, dan traceFlags pada tingkat teratas ketika pemanggilan log membawa konteks jejak diagnostik yang valid, sehingga pemroses log dapat menghubungkan baris log lokal dengan span yang diekspor.
• Korelasi permintaan: Permintaan HTTP dan frame WebSocket Gateway membuat cakupan jejak permintaan internal. Log dan peristiwa diagnostik di dalam cakupan tersebut secara bawaan mewarisi jejak permintaan, sedangkan span eksekusi agen dan pemanggilan model dibuat sebagai anak agar header traceparent penyedia tetap berada pada jejak yang sama.
• Korelasi pemanggilan model: Span openclaw.model.call secara bawaan menyertakan ukuran komponen prompt yang aman dan atribut token per pemanggilan ketika hasil penyedia menampilkan penggunaan. openclaw.model.usage tetap menjadi span akuntansi tingkat eksekusi untuk biaya agregat, konteks, dan dasbor kanal, serta tetap berada pada jejak diagnostik yang sama ketika runtime yang memancarkannya memiliki konteks jejak tepercaya.

Metrik yang diekspor

Penggunaan model

• openclaw.tokens (penghitung, atribut: openclaw.token, openclaw.channel, openclaw.provider, openclaw.model, openclaw.agent)
• openclaw.cost.usd (penghitung, atribut: openclaw.channel, openclaw.provider, openclaw.model)
• openclaw.run.duration_ms (histogram, atribut: openclaw.channel, openclaw.provider, openclaw.model)
• openclaw.context.tokens (histogram, atribut: openclaw.context, openclaw.channel, openclaw.provider, openclaw.model)
• gen_ai.client.token.usage (histogram, metrik konvensi semantik GenAI, atribut: gen_ai.token.type = input/output, gen_ai.provider.name, gen_ai.operation.name, gen_ai.request.model)
• gen_ai.client.operation.duration (histogram, detik, metrik konvensi semantik GenAI, atribut: gen_ai.provider.name, gen_ai.operation.name, gen_ai.request.model, error.type opsional)
• openclaw.model_call.duration_ms (histogram, atribut: openclaw.provider, openclaw.model, openclaw.api, openclaw.transport, ditambah openclaw.errorCategory dan openclaw.failureKind pada kesalahan yang diklasifikasikan)
• openclaw.model_call.request_bytes (histogram, ukuran byte UTF-8 dari muatan permintaan model akhir; tanpa isi muatan mentah)
• openclaw.model_call.response_bytes (histogram, ukuran byte UTF-8 dari muatan potongan respons yang dialirkan; delta teks, pemikiran, dan pemanggilan alat berfrekuensi tinggi hanya menghitung byte delta inkremental; tanpa isi respons mentah)
• openclaw.model_call.time_to_first_byte_ms (histogram, waktu berlalu sebelum peristiwa respons pertama yang dialirkan)
• openclaw.model.failover (penghitung, atribut: openclaw.provider, openclaw.model, openclaw.failover.to_provider, openclaw.failover.to_model, openclaw.failover.reason, openclaw.failover.suspended, openclaw.lane)
• openclaw.skill.used (penghitung, atribut: openclaw.skill.name, openclaw.skill.source, openclaw.skill.activation, openclaw.agent opsional, openclaw.toolName opsional)

Alur pesan

• openclaw.webhook.received (penghitung, atribut: openclaw.channel, openclaw.webhook)
• openclaw.webhook.error (penghitung, atribut: openclaw.channel, openclaw.webhook)
• openclaw.webhook.duration_ms (histogram, atribut: openclaw.channel, openclaw.webhook)
• openclaw.message.queued (penghitung, atribut: openclaw.channel, openclaw.source)
• openclaw.message.received (penghitung, atribut: openclaw.channel, openclaw.source)
• openclaw.message.dispatch.started (penghitung, atribut: openclaw.channel, openclaw.source)
• openclaw.message.dispatch.completed (penghitung, atribut: openclaw.channel, openclaw.outcome, openclaw.reason, openclaw.source)
• openclaw.message.dispatch.duration_ms (histogram, atribut: openclaw.channel, openclaw.outcome, openclaw.reason, openclaw.source)
• openclaw.message.processed (penghitung, atribut: openclaw.channel, openclaw.outcome)
• openclaw.message.duration_ms (histogram, atribut: openclaw.channel, openclaw.outcome)
• openclaw.message.delivery.started (penghitung, atribut: openclaw.channel, openclaw.delivery.kind)
• openclaw.message.delivery.duration_ms (histogram, atribut: openclaw.channel, openclaw.delivery.kind, openclaw.outcome, openclaw.errorCategory)

Percakapan

• openclaw.talk.event (penghitung, atribut: openclaw.talk.event_type, openclaw.talk.mode, openclaw.talk.transport, openclaw.talk.brain, openclaw.talk.provider)
• openclaw.talk.event.duration_ms (histogram, atribut: sama seperti openclaw.talk.event; dipancarkan ketika peristiwa Percakapan melaporkan durasi)
• openclaw.talk.audio.bytes (histogram, atribut: sama seperti openclaw.talk.event; dipancarkan untuk peristiwa frame audio Percakapan yang melaporkan panjang byte)

Antrean dan sesi

• openclaw.queue.lane.enqueue (penghitung, atribut: openclaw.lane)
• openclaw.queue.lane.dequeue (penghitung, atribut: openclaw.lane)
• openclaw.queue.depth (histogram, atribut: openclaw.lane atau openclaw.channel=heartbeat)
• openclaw.queue.wait_ms (histogram, atribut: openclaw.lane)
• openclaw.session.state (penghitung, atribut: openclaw.state, openclaw.reason)
• openclaw.session.stuck (penghitung, atribut: openclaw.state; dipancarkan untuk pencatatan sesi kedaluwarsa yang dapat dipulihkan)
• openclaw.session.stuck_age_ms (histogram, atribut: openclaw.state; dipancarkan untuk pencatatan sesi kedaluwarsa yang dapat dipulihkan)
• openclaw.session.turn.created (penghitung, atribut: openclaw.agent, openclaw.channel, openclaw.trigger)
• openclaw.session.recovery.requested (penghitung, atribut: openclaw.state, openclaw.action, openclaw.active_work_kind, openclaw.reason)
• openclaw.session.recovery.completed (penghitung, atribut: openclaw.state, openclaw.action, openclaw.status, openclaw.active_work_kind, openclaw.reason)
• openclaw.session.recovery.age_ms (histogram, atribut: sama seperti penghitung pemulihan yang bersesuaian)
• openclaw.run.attempt (penghitung, atribut: openclaw.attempt)

Telemetri keaktifan sesi

diagnostics.stuckSessionWarnMs adalah ambang usia tanpa kemajuan untuk diagnostik keaktifan sesi. Sesi processing tidak bertambah usianya menuju ambang ini selama OpenClaw mengamati kemajuan respons, alat, status, blok, atau runtime ACP. Sinyal tetap aktif pengetikan tidak dihitung sebagai kemajuan, sehingga model atau harness yang diam tetap dapat dideteksi.

OpenClaw mengklasifikasikan sesi berdasarkan pekerjaan yang masih dapat diamati:

• session.long_running: pekerjaan tertanam aktif, pemanggilan model, atau pemanggilan alat masih mengalami kemajuan. Pemanggilan model yang memiliki pemilik dan tetap diam setelah diagnostics.stuckSessionWarnMs juga dilaporkan sebagai berjalan lama sebelum diagnostics.stuckSessionAbortMs, sehingga penyedia model yang lambat atau tidak mengalirkan respons tidak tampak seperti sesi Gateway yang macet selama pembatalan masih dapat diamati.
• session.stalled: pekerjaan aktif ada, tetapi eksekusi aktif belum melaporkan kemajuan baru-baru ini. Pemanggilan model yang memiliki pemilik beralih dari session.long_running ke session.stalled saat atau setelah diagnostics.stuckSessionAbortMs; aktivitas model/alat kedaluwarsa tanpa pemilik tidak dianggap sebagai pekerjaan berjalan lama yang tidak berbahaya. Eksekusi tertanam yang macet awalnya tetap hanya diamati, lalu dibatalkan dan dikosongkan setelah diagnostics.stuckSessionAbortMs tanpa kemajuan agar giliran yang mengantre di belakang jalur dapat dilanjutkan. Jika tidak ditetapkan, ambang pembatalan secara bawaan menggunakan jendela diperpanjang yang lebih aman, yaitu setidaknya 5 menit dan 3x diagnostics.stuckSessionWarnMs.
• session.stuck: pencatatan sesi kedaluwarsa tanpa pekerjaan aktif, atau sesi antrean menganggur dengan aktivitas model/alat kedaluwarsa tanpa pemilik. Ini segera melepaskan jalur sesi yang terdampak setelah gerbang pemulihan lulus.

Pemulihan memancarkan peristiwa terstruktur session.recovery.requested dan session.recovery.completed. Status sesi diagnostik ditandai menganggur hanya setelah hasil pemulihan yang mengubah keadaan (aborted atau released) dan hanya jika generasi pemrosesan yang sama masih berlaku.

Hanya session.stuck yang memancarkan penghitung openclaw.session.stuck, histogram openclaw.session.stuck_age_ms, dan span openclaw.session.stuck. Diagnostik session.stuck yang berulang mengurangi frekuensi selama sesi tetap tidak berubah, sehingga dasbor sebaiknya memberikan peringatan saat terjadi peningkatan berkelanjutan, bukan pada setiap detak Heartbeat. Untuk opsi konfigurasi dan nilai bawaannya, lihat Referensi konfigurasi.

Peringatan keaktifan juga memancarkan:

• openclaw.liveness.warning (penghitung, atribut: openclaw.liveness.reason)
• openclaw.liveness.event_loop_delay_p99_ms (histogram, atribut: openclaw.liveness.reason)
• openclaw.liveness.event_loop_delay_max_ms (histogram, atribut: openclaw.liveness.reason)
• openclaw.liveness.event_loop_utilization (histogram, atribut: openclaw.liveness.reason)
• openclaw.liveness.cpu_core_ratio (histogram, atribut: openclaw.liveness.reason)

Siklus hidup harness

• openclaw.harness.duration_ms (histogram, atribut: openclaw.harness.id, openclaw.harness.plugin, openclaw.outcome, openclaw.harness.phase pada kesalahan)

Eksekusi alat dan deteksi perulangan

• openclaw.tool.execution.duration_ms (histogram, atribut: gen_ai.tool.name, openclaw.toolName, openclaw.tool.source, openclaw.tool.owner, openclaw.tool.params.kind, ditambah openclaw.errorCategory pada kesalahan)
• openclaw.tool.execution.blocked (penghitung, atribut: gen_ai.tool.name, openclaw.toolName, openclaw.tool.source, openclaw.tool.owner, openclaw.tool.params.kind, openclaw.deniedReason)
• openclaw.tool.loop (penghitung, atribut: openclaw.toolName, openclaw.loop.level, openclaw.loop.action, openclaw.loop.detector, openclaw.loop.count, openclaw.loop.paired_tool opsional; dipancarkan ketika perulangan pemanggilan alat yang repetitif terdeteksi)

Exec

• openclaw.exec.duration_ms (histogram, atribut: openclaw.exec.target, openclaw.exec.mode, openclaw.outcome, openclaw.failureKind)

Internal diagnostik (memori, muatan, kesehatan pengekspor)

• openclaw.payload.large (penghitung, atribut: openclaw.payload.surface, openclaw.payload.action, openclaw.channel, openclaw.plugin, openclaw.reason)
• openclaw.payload.large_bytes (histogram, atribut: sama seperti openclaw.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 (histogram, tanpa atribut; sampel memori proses)
• openclaw.memory.pressure (penghitung, atribut: openclaw.memory.level, openclaw.memory.reason)
• openclaw.diagnostic.async_queue.dropped (penghitung, atribut: openclaw.diagnostic.async_queue.drop_class; pembuangan akibat tekanan balik antrean diagnostik internal)
• openclaw.telemetry.exporter.events (penghitung, atribut: openclaw.exporter, openclaw.signal, openclaw.status, openclaw.reason opsional, openclaw.errorCategory opsional; telemetri mandiri siklus hidup/kegagalan pengekspor)

Span yang diekspor

• openclaw.model.usage
  • openclaw.channel, openclaw.provider, openclaw.model
  • openclaw.tokens.* (input/output/cache_read/cache_write/total)
  • gen_ai.system secara bawaan, atau gen_ai.provider.name ketika konvensi semantik GenAI terbaru diaktifkan
  • gen_ai.request.model, gen_ai.operation.name, gen_ai.usage.*
• openclaw.run
  • openclaw.outcome, openclaw.channel, openclaw.provider, openclaw.model, openclaw.errorCategory
• openclaw.model.call
  • gen_ai.system secara bawaan, atau gen_ai.provider.name ketika konvensi semantik GenAI terbaru diaktifkan
  • gen_ai.request.model, gen_ai.operation.name, openclaw.provider, openclaw.model, openclaw.api, openclaw.transport
  • openclaw.errorCategory, error.type, dan openclaw.failureKind opsional saat terjadi kesalahan
  • openclaw.model_call.request_bytes, openclaw.model_call.response_bytes, openclaw.model_call.time_to_first_byte_ms
  • openclaw.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 (hanya ukuran komponen yang aman, tanpa teks prompt)
  • openclaw.model_call.usage.* dan gen_ai.usage.* ketika hasil panggilan model memuat penggunaan penyedia untuk panggilan individual tersebut
  • Peristiwa span openclaw.provider.request dengan atribut openclaw.upstreamRequestIdHash (dibatasi, berbasis hash) ketika hasil penyedia upstream mengekspos ID permintaan; ID mentah tidak pernah diekspor
  • Dengan OTEL_SEMCONV_STABILITY_OPT_IN=gen_ai_latest_experimental, span panggilan model menggunakan nama span inferensi GenAI terbaru {gen_ai.operation.name} {gen_ai.request.model} dan jenis span CLIENT, bukan openclaw.model.call.
• openclaw.harness.run
  • openclaw.harness.id, openclaw.harness.plugin, openclaw.outcome, openclaw.provider, openclaw.model, openclaw.channel
  • Saat selesai: openclaw.harness.result_classification, openclaw.harness.yield_detected, openclaw.harness.items.started, openclaw.harness.items.completed, openclaw.harness.items.active
  • Saat terjadi kesalahan: openclaw.harness.phase, openclaw.errorCategory, openclaw.harness.cleanup_failed opsional
• openclaw.tool.execution
  • gen_ai.tool.name, gen_ai.operation.name (execute_tool), openclaw.toolName, openclaw.tool.source, gen_ai.tool.call.id opsional, openclaw.tool.owner, openclaw.tool.params.*
  • openclaw.errorCategory/openclaw.errorCode opsional saat terjadi kesalahan, openclaw.deniedReason dan openclaw.outcome=blocked ketika ditolak oleh kebijakan atau sandbox
• openclaw.exec
  • openclaw.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.processed
  • openclaw.channel, openclaw.webhook
• openclaw.webhook.error
  • openclaw.channel, openclaw.webhook, openclaw.error
• openclaw.message.processed
  • openclaw.channel, openclaw.outcome, openclaw.reason
• openclaw.message.delivery
  • openclaw.channel, openclaw.delivery.kind, openclaw.outcome, openclaw.errorCategory, openclaw.delivery.result_count
• openclaw.session.stuck
  • openclaw.state, openclaw.ageMs, openclaw.queueDepth
• openclaw.context.assembled
  • openclaw.prompt.size, openclaw.history.size, openclaw.context.tokens, openclaw.errorCategory (tanpa konten prompt, riwayat, respons, atau kunci sesi)
• openclaw.tool.loop
  • openclaw.toolName, openclaw.loop.level, openclaw.loop.action, openclaw.loop.detector, openclaw.loop.count, openclaw.loop.paired_tool opsional (tanpa pesan perulangan, parameter, atau keluaran alat)
• openclaw.memory.pressure
  • openclaw.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, openclaw.memory.threshold_bytes/openclaw.memory.rss_growth_bytes/openclaw.memory.window_ms opsional

Ketika pengambilan konten diaktifkan secara eksplisit, span model dan alat juga dapat menyertakan atribut openclaw.content.* yang dibatasi dan disunting untuk kelas konten tertentu yang Anda pilih.

Katalog peristiwa diagnostik

Peristiwa di bawah ini mendukung metrik dan span di atas. Plugin juga dapat berlangganan langsung ke peristiwa tersebut tanpa ekspor OTLP.

Penggunaan model

• model.usage - token, biaya, durasi, konteks, penyedia/model/saluran, ID sesi. usage adalah penghitungan penyedia/giliran untuk biaya dan telemetri; context.used adalah cuplikan prompt/konteks saat ini dan dapat lebih rendah daripada usage.total penyedia ketika input yang di-cache atau panggilan perulangan alat terlibat.

Alur pesan

• webhook.received / webhook.processed / webhook.error
• message.queued / message.processed
• message.delivery.started / message.delivery.completed / message.delivery.error

Antrean dan sesi

• queue.lane.enqueue / queue.lane.dequeue
• session.state / session.long_running / session.stalled / session.stuck
• run.attempt / run.progress
• diagnostic.heartbeat (penghitung agregat: Webhook/antrean/sesi)

Siklus hidup harness

• harness.run.started / harness.run.completed / harness.run.error - siklus hidup per eksekusi untuk harness agen. Mencakup harnessId, pluginId opsional, penyedia/model/saluran, dan ID eksekusi. Penyelesaian menambahkan durationMs, outcome, resultClassification opsional, yieldDetected, dan jumlah itemLifecycle. Kesalahan menambahkan phase (prepare/start/send/resolve/cleanup), errorCategory, dan cleanupFailed opsional.

Eksekusi

• exec.process.completed - hasil akhir terminal, durasi, target, mode, kode keluar, dan jenis kegagalan. Teks perintah dan direktori kerja tidak disertakan.
• exec.approval.followup_suppressed - tindak lanjut persetujuan yang kedaluwarsa dibuang setelah sesi terikat ulang. Mencakup approvalId, reason (session_rebound), phase (direct_delivery atau gateway_preflight), dan stempel waktu dispatcher. Kunci sesi, rute, dan teks perintah tidak disertakan.

Tanpa pengekspor

Pertahankan ketersediaan peristiwa diagnostik bagi Plugin atau tujuan khusus tanpa menjalankan diagnostics-otel:

{  diagnostics: { enabled: true },}

Untuk keluaran debug yang ditargetkan tanpa menaikkan logging.level, gunakan tanda diagnostik. Tanda tidak peka huruf besar-kecil dan mendukung karakter pengganti (telegram.* atau *):

{  diagnostics: { flags: ["telegram.http"] },}

Atau sebagai penggantian env sekali pakai:

OPENCLAW_DIAGNOSTICS=telegram.http,telegram.payload openclaw gateway

Keluaran tanda dikirim ke berkas log standar (logging.file) dan tetap disunting oleh logging.redactSensitive. Panduan lengkap: Tanda diagnostik.

Menonaktifkan

{  diagnostics: { otel: { enabled: false } },}

Atau jangan sertakan diagnostics-otel dalam plugins.allow, atau jalankan openclaw plugins disable diagnostics-otel.

Terkait

• Pencatatan log - log berkas, keluaran konsol, pemantauan CLI, dan tab Log di Control UI
• Internal pencatatan log Gateway - gaya log WS, prefiks subsistem, dan pengambilan konsol
• Tanda diagnostik - tanda log debug yang ditargetkan
• Ekspor diagnostik - alat paket dukungan operator (terpisah dari ekspor OTEL)
• Referensi konfigurasi - referensi lengkap bidang diagnostics.*