OpenClaw, resmi diagnostics-otel Plugin’i üzerinden OTLP/HTTP (protobuf) kullanarak tanılamaları dışa aktarır. Günlükler, container ve sandbox günlük işlem hatları için stdout JSONL olarak da yazılabilir. OTLP/HTTP kabul eden herhangi bir collector veya backend kod değişikliği olmadan çalışır. Yerel dosya günlükleri ve bunların nasıl okunacağı için bkz. Günlükleme.
Birlikte nasıl çalışır
- Tanılama olayları, Gateway ve paketle gelen Plugin’ler tarafından model çalıştırmaları, ileti akışı, oturumlar, kuyruklar ve exec için yayılan yapılandırılmış, işlem içi kayıtlardır.
diagnostics-otel Plugin’i bu olaylara abone olur ve bunları OTLP/HTTP üzerinden OpenTelemetry metrikleri, trace’leri ve günlükleri olarak dışa aktarır. Ayrıca tanılama günlük kayıtlarını stdout JSONL’ye yansıtabilir.- Sağlayıcı çağrıları, sağlayıcı taşıması özel üstbilgileri kabul ettiğinde OpenClaw’ın güvenilen model çağrısı span bağlamından bir W3C
traceparent üstbilgisi alır. Plugin tarafından yayılan trace bağlamı aktarılmaz.
- Dışa aktarıcılar yalnızca hem tanılama yüzeyi hem de Plugin etkinleştirildiğinde bağlanır; bu nedenle işlem içi maliyet varsayılan olarak neredeyse sıfır kalır.
Hızlı başlangıç
Paketli kurulumlarda önce Plugin’i yükleyin:
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,
},
},
}
openclaw plugins enable diagnostics-otel
protocol şu anda yalnızca http/protobuf destekler. grpc yok sayılır.
Dışa aktarılan sinyaller
| Sinyal | İçeriği |
|---|
| Metrikler | Token kullanımı, maliyet, çalıştırma süresi, failover, Skills kullanımı, ileti akışı, Talk olayları, kuyruk şeritleri, oturum durumu/kurtarma, araç yürütme, büyük boyutlu payload’lar, exec ve bellek baskısı için sayaçlar ve histogramlar. |
| Trace’ler | Model kullanımı, model çağrıları, harness yaşam döngüsü, Skills kullanımı, araç yürütme, exec, webhook/ileti işleme, bağlam derleme ve araç döngüleri için span’ler. |
| Günlükler | diagnostics.otel.logs etkinleştirildiğinde OTLP veya stdout JSONL üzerinden dışa aktarılan yapılandırılmış logging.file kayıtları; içerik yakalama açıkça etkinleştirilmedikçe günlük gövdeleri dışarıda bırakılır. |
traces, metrics ve logs ayarlarını birbirinden bağımsız olarak açıp kapatın. diagnostics.otel.enabled true olduğunda trace’ler ve metrikler varsayılan olarak açıktır. Günlükler varsayılan olarak kapalıdır ve yalnızca diagnostics.otel.logs açıkça true olduğunda dışa aktarılır. Günlük dışa aktarma varsayılan olarak OTLP’ye yapılır; stdout üzerinde JSONL için diagnostics.otel.logsExporter değerini stdout, her tanılama günlük kaydını hem OTLP’ye hem de stdout’a göndermek için both olarak ayarlayın.
Yapılandırma başvurusu
{
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 is ignored
serviceName: "openclaw-gateway",
headers: { "x-collector-token": "..." },
traces: true,
metrics: true,
logs: true,
logsExporter: "otlp", // otlp | stdout | both
sampleRate: 0.2, // root-span sampler, 0.0..1.0
flushIntervalMs: 60000, // metric export interval (min 1000ms)
captureContent: {
enabled: false,
inputMessages: false,
outputMessages: false,
toolInputs: false,
toolOutputs: false,
systemPrompt: false,
toolDefinitions: false,
},
},
},
}
Ortam değişkenleri
| Değişken | Amaç |
|---|
OTEL_EXPORTER_OTLP_ENDPOINT | diagnostics.otel.endpoint değerini geçersiz kılar. Değer zaten /v1/traces, /v1/metrics veya /v1/logs içeriyorsa olduğu gibi kullanılır. |
OTEL_EXPORTER_OTLP_TRACES_ENDPOINT / OTEL_EXPORTER_OTLP_METRICS_ENDPOINT / OTEL_EXPORTER_OTLP_LOGS_ENDPOINT | Eşleşen diagnostics.otel.*Endpoint yapılandırma anahtarı ayarlanmamışsa kullanılan sinyale özgü endpoint geçersiz kılmaları. Sinyale özgü yapılandırma, sinyale özgü env üzerinde; o da paylaşılan endpoint üzerinde önceliklidir. |
OTEL_SERVICE_NAME | diagnostics.otel.serviceName değerini geçersiz kılar. |
OTEL_EXPORTER_OTLP_PROTOCOL | Kablo protokolünü geçersiz kılar (bugün yalnızca http/protobuf dikkate alınır). |
OTEL_SEMCONV_STABILITY_OPT_IN | {gen_ai.operation.name} {gen_ai.request.model} span adları, CLIENT span türü ve eski gen_ai.system yerine gen_ai.provider.name dahil olmak üzere en son deneysel GenAI çıkarım span biçimini yaymak için gen_ai_latest_experimental olarak ayarlayın. GenAI metrikleri ne olursa olsun her zaman sınırlı, düşük kardinaliteli semantik öznitelikler kullanır. |
OPENCLAW_OTEL_PRELOADED | Başka bir preload veya ana işlem global OpenTelemetry SDK’sını zaten kaydettiğinde 1 olarak ayarlayın. Plugin bu durumda kendi NodeSDK yaşam döngüsünü atlar ancak yine de tanılama dinleyicilerini bağlar ve traces/metrics/logs ayarlarını dikkate alır. |
Gizlilik ve içerik yakalama
Ham model/araç içeriği varsayılan olarak dışa aktarılmaz. Span’ler sınırlı tanımlayıcılar taşır (kanal, sağlayıcı, model, hata kategorisi, yalnızca hash istek kimlikleri, araç kaynağı, araç sahibi ve Skills adı/kaynağı) ve asla prompt metni, yanıt metni, araç girdileri, araç çıktıları, Skills dosya yolları veya oturum anahtarları içermez. OTLP günlük kayıtları varsayılan olarak önem derecesini, logger’ı, kod konumunu, güvenilen trace bağlamını ve temizlenmiş öznitelikleri tutar; ancak ham günlük ileti gövdesi yalnızca diagnostics.otel.captureContent boolean true olarak ayarlandığında dışa aktarılır. Ayrıntılı captureContent.* alt anahtarları günlük gövdelerini etkinleştirmez. Kapsamlı ajan oturum anahtarlarına benzeyen etiketler unknown ile değiştirilir.
Talk metrikleri yalnızca mod, taşıma, sağlayıcı ve olay türü gibi sınırlı olay meta verilerini dışa aktarır. Transkriptler, ses payload’ları, oturum kimlikleri, turn kimlikleri, çağrı kimlikleri, oda kimlikleri veya devir token’ları içermez.
Giden model istekleri bir W3C traceparent üstbilgisi içerebilir. Bu üstbilgi yalnızca etkin model çağrısı için OpenClaw’a ait tanılama trace bağlamından oluşturulur. Mevcut çağıran tarafından sağlanmış traceparent üstbilgileri değiştirilir; böylece Plugin’ler veya özel sağlayıcı seçenekleri servisler arası trace soyunu taklit edemez.
diagnostics.otel.captureContent.* değerini yalnızca collector ve saklama politikanız prompt, yanıt, araç veya sistem prompt metni için onaylanmışsa true olarak ayarlayın. Her alt anahtar bağımsız olarak opt-in’dir:
inputMessages - kullanıcı prompt içeriği.outputMessages - model yanıt içeriği.toolInputs - araç argümanı payload’ları.toolOutputs - araç sonucu payload’ları.systemPrompt - birleştirilmiş sistem/geliştirici prompt’u.toolDefinitions - model aracı adları, açıklamaları ve şemaları.
Herhangi bir alt anahtar etkinleştirildiğinde, model ve araç span’leri yalnızca o sınıf için sınırlı, redakte edilmiş openclaw.content.* öznitelikleri alır. Boolean captureContent: true değerini yalnızca OTLP günlük ileti gövdelerinin de dışa aktarım için onaylandığı geniş tanılama yakalamaları için kullanın.
toolInputs/toolOutputs içeriği, yerleşik ajan runtime’ının araç yürütmeleri için yakalanır (tamamlanan/hatalı span’lerde openclaw.content.tool_input, tamamlanan span’lerde openclaw.content.tool_output). Harici harness araç çağrıları (Codex, Claude CLI) içerik payload’ları olmadan tool.execution.* span’leri yayar. Yakalanan içerik güvenilen, yalnızca dinleyiciye açık bir kanalda taşınır ve asla genel tanılama olay veri yoluna yerleştirilmez.
Örnekleme ve flush etme
- İzler:
diagnostics.otel.sampleRate (yalnızca kök span, 0.0 tümünü atar,
1.0 tümünü tutar).
- Metrikler:
diagnostics.otel.flushIntervalMs (minimum 1000).
- Günlükler: OTLP günlükleri
logging.level (dosya günlük düzeyi) ayarına uyar. Konsol biçimlendirmesini değil,
tanılama günlük kaydı redaksiyon yolunu kullanırlar. Yüksek hacimli
kurulumlar yerel örnekleme yerine OTLP collector örnekleme/filtrelemeyi tercih etmelidir.
Platformunuz stdout/stderr çıktısını zaten bir günlük işleyicisine
gönderiyorsa ve bir OTLP günlük
collector’ınız yoksa diagnostics.otel.logsExporter: "stdout" ayarını yapın. Stdout kayıtları satır başına bir JSON nesnesidir ve uygun olduğunda ts, signal,
service.name, önem derecesi, gövde, redakte edilmiş öznitelikler ve güvenilir iz alanlarını içerir.
- Dosya günlüğü korelasyonu: JSONL dosya günlükleri, günlük çağrısı geçerli bir
tanılama iz bağlamı taşıdığında üst düzey
traceId,
spanId, parentSpanId ve traceFlags içerir; bu da günlük işleyicilerinin yerel günlük satırlarını
dışa aktarılan span’lerle birleştirmesine olanak tanır.
- İstek korelasyonu: Gateway HTTP istekleri ve WebSocket çerçeveleri
dahili bir istek iz kapsamı oluşturur. Bu kapsamdaki günlükler ve tanılama olayları
varsayılan olarak istek izini devralırken, aracı çalıştırma ve model çağrısı span’leri
alt öğeler olarak oluşturulur, böylece sağlayıcı
traceparent başlıkları aynı izde kalır.
- Model çağrısı korelasyonu:
openclaw.model.call span’leri varsayılan olarak güvenli istem
bileşeni boyutlarını içerir ve sağlayıcı sonucu kullanımı açığa çıkarıyorsa çağrı başına token özniteliklerini içerir.
openclaw.model.usage, toplu maliyet, bağlam ve kanal panoları için çalıştırma düzeyi
muhasebe span’i olarak kalır; yayan çalışma zamanında güvenilir iz
bağlamı olduğunda aynı tanılama izinde kalır.
Dışa aktarılan metrikler
Model kullanımı
openclaw.tokens (sayaç, öznitelikler: openclaw.token, openclaw.channel, openclaw.provider, openclaw.model, openclaw.agent)openclaw.cost.usd (sayaç, öznitelikler: openclaw.channel, openclaw.provider, openclaw.model)openclaw.run.duration_ms (histogram, öznitelikler: openclaw.channel, openclaw.provider, openclaw.model)openclaw.context.tokens (histogram, öznitelikler: openclaw.context, openclaw.channel, openclaw.provider, openclaw.model)gen_ai.client.token.usage (histogram, GenAI semantic-conventions metriği, öznitelikler: gen_ai.token.type = input/output, gen_ai.provider.name, gen_ai.operation.name, gen_ai.request.model)gen_ai.client.operation.duration (histogram, saniye, GenAI semantic-conventions metriği, öznitelikler: gen_ai.provider.name, gen_ai.operation.name, gen_ai.request.model, isteğe bağlı error.type)openclaw.model_call.duration_ms (histogram, öznitelikler: openclaw.provider, openclaw.model, openclaw.api, openclaw.transport, ayrıca sınıflandırılmış hatalarda openclaw.errorCategory ve openclaw.failureKind)openclaw.model_call.request_bytes (histogram, son model isteği yükünün UTF-8 bayt boyutu; ham yük içeriği yok)openclaw.model_call.response_bytes (histogram, akış yanıt parçacığı yüklerinin UTF-8 bayt boyutu; yüksek frekanslı metin, düşünme ve araç çağrısı deltaları yalnızca artımlı delta baytlarını sayar; ham yanıt içeriği yok)openclaw.model_call.time_to_first_byte_ms (histogram, ilk akış yanıt olayından önce geçen süre)openclaw.model.failover (sayaç, öznitelikler: openclaw.provider, openclaw.model, openclaw.failover.to_provider, openclaw.failover.to_model, openclaw.failover.reason, openclaw.failover.suspended, openclaw.lane)openclaw.skill.used (sayaç, öznitelikler: openclaw.skill.name, openclaw.skill.source, openclaw.skill.activation, isteğe bağlı openclaw.agent, isteğe bağlı openclaw.toolName)
İleti akışı
openclaw.webhook.received (sayaç, öznitelikler: openclaw.channel, openclaw.webhook)openclaw.webhook.error (sayaç, öznitelikler: openclaw.channel, openclaw.webhook)openclaw.webhook.duration_ms (histogram, öznitelikler: openclaw.channel, openclaw.webhook)openclaw.message.queued (sayaç, öznitelikler: openclaw.channel, openclaw.source)openclaw.message.received (sayaç, öznitelikler: openclaw.channel, openclaw.source)openclaw.message.dispatch.started (sayaç, öznitelikler: openclaw.channel, openclaw.source)openclaw.message.dispatch.completed (sayaç, öznitelikler: openclaw.channel, openclaw.outcome, openclaw.reason, openclaw.source)openclaw.message.dispatch.duration_ms (histogram, öznitelikler: openclaw.channel, openclaw.outcome, openclaw.reason, openclaw.source)openclaw.message.processed (sayaç, öznitelikler: openclaw.channel, openclaw.outcome)openclaw.message.duration_ms (histogram, öznitelikler: openclaw.channel, openclaw.outcome)openclaw.message.delivery.started (sayaç, öznitelikler: openclaw.channel, openclaw.delivery.kind)openclaw.message.delivery.duration_ms (histogram, öznitelikler: openclaw.channel, openclaw.delivery.kind, openclaw.outcome, openclaw.errorCategory)
Talk
openclaw.talk.event (sayaç, öznitelikler: openclaw.talk.event_type, openclaw.talk.mode, openclaw.talk.transport, openclaw.talk.brain, openclaw.talk.provider)openclaw.talk.event.duration_ms (histogram, öznitelikler: openclaw.talk.event ile aynı; bir Talk olayı süre bildirdiğinde yayılır)openclaw.talk.audio.bytes (histogram, öznitelikler: openclaw.talk.event ile aynı; bayt uzunluğu bildiren Talk ses çerçevesi olayları için yayılır)
Kuyruklar ve oturumlar
openclaw.queue.lane.enqueue (sayaç, öznitelikler: openclaw.lane)openclaw.queue.lane.dequeue (sayaç, öznitelikler: openclaw.lane)openclaw.queue.depth (histogram, öznitelikler: openclaw.lane veya openclaw.channel=heartbeat)openclaw.queue.wait_ms (histogram, öznitelikler: openclaw.lane)openclaw.session.state (sayaç, öznitelikler: openclaw.state, openclaw.reason)openclaw.session.stuck (sayaç, öznitelikler: openclaw.state; kurtarılabilir bayat oturum kayıt tutma için yayılır)openclaw.session.stuck_age_ms (histogram, öznitelikler: openclaw.state; kurtarılabilir bayat oturum kayıt tutma için yayılır)openclaw.session.turn.created (sayaç, öznitelikler: openclaw.agent, openclaw.channel, openclaw.trigger)openclaw.session.recovery.requested (sayaç, öznitelikler: openclaw.state, openclaw.action, openclaw.active_work_kind, openclaw.reason)openclaw.session.recovery.completed (sayaç, öznitelikler: openclaw.state, openclaw.action, openclaw.status, openclaw.active_work_kind, openclaw.reason)openclaw.session.recovery.age_ms (histogram, öznitelikler: eşleşen kurtarma sayacıyla aynı)openclaw.run.attempt (sayaç, öznitelikler: openclaw.attempt)
Oturum canlılığı telemetrisi
diagnostics.stuckSessionWarnMs, oturum canlılığı tanılamaları için ilerleme olmayan yaş eşiğidir.
Bir processing oturumu, OpenClaw yanıt, araç, durum, blok veya ACP çalışma zamanı ilerlemesi gözlemlediği sürece
bu eşiğe doğru yaşlanmaz.
Yazıyor keepalive’ları ilerleme olarak sayılmaz, bu nedenle sessiz bir model veya harness
yine de algılanabilir.
OpenClaw, oturumları hâlâ gözlemleyebildiği işe göre sınıflandırır:
session.long_running: etkin gömülü iş, model çağrıları veya araç çağrıları
hâlâ ilerleme kaydediyor. diagnostics.stuckSessionWarnMs süresini aşacak kadar sessiz kalan
sahipli model çağrıları da diagnostics.stuckSessionAbortMs öncesinde uzun süren olarak raporlanır;
böylece yavaş veya akışsız model sağlayıcıları, iptal gözlemlenebilir kaldıkları sürece
durmuş gateway oturumları gibi görünmez.session.stalled: etkin iş var, ancak etkin çalıştırma yakın zamanda
ilerleme bildirmedi. Sahipli model çağrıları diagnostics.stuckSessionAbortMs zamanında veya sonrasında
session.long_running durumundan session.stalled durumuna geçer; sahipsiz
bayat model/araç etkinliği zararsız uzun süren iş olarak değerlendirilmez.
Durmuş gömülü çalıştırmalar önce yalnızca gözlem modunda kalır, ardından
ilerleme olmadan diagnostics.stuckSessionAbortMs sonrasında iptal-boşaltma yapar;
böylece hattın arkasındaki kuyruğa alınmış dönüşler devam edebilir. Ayarlanmadığında iptal eşiği,
en az 5 dakika ve diagnostics.stuckSessionWarnMs değerinin 3 katı olan daha güvenli
genişletilmiş pencereye varsayılanlanır.session.stuck: etkin iş olmayan bayat oturum kayıt tutma veya bayat sahipsiz
model/araç etkinliğine sahip boşta bekleyen kuyruğa alınmış oturum. Bu,
kurtarma kapıları geçtikten hemen sonra etkilenen oturum hattını serbest bırakır.
Kurtarma, yapılandırılmış session.recovery.requested ve
session.recovery.completed olayları yayar. Tanılama oturum durumu yalnızca
değişiklik yapan bir kurtarma sonucu (aborted veya released) sonrasında ve yalnızca
aynı işleme nesli hâlâ geçerliyse boşta olarak işaretlenir.
Yalnızca session.stuck, openclaw.session.stuck sayacını,
openclaw.session.stuck_age_ms histogramını ve openclaw.session.stuck
span’ini yayar. Tekrarlanan session.stuck tanılamaları oturum değişmeden kaldığı sürece
geri çekilir; bu nedenle panolar her
Heartbeat işaretine değil, sürdürülen artışlara alarm vermelidir. Yapılandırma düğmesi ve varsayılanlar için
Yapılandırma başvurusu bölümüne bakın.
Canlılık uyarıları ayrıca şunları yayar:
openclaw.liveness.warning (sayaç, öznitelikler: openclaw.liveness.reason)openclaw.liveness.event_loop_delay_p99_ms (histogram, öznitelikler: openclaw.liveness.reason)openclaw.liveness.event_loop_delay_max_ms (histogram, öznitelikler: openclaw.liveness.reason)openclaw.liveness.event_loop_utilization (histogram, öznitelikler: openclaw.liveness.reason)openclaw.liveness.cpu_core_ratio (histogram, öznitelikler: openclaw.liveness.reason)
Harness yaşam döngüsü
openclaw.harness.duration_ms (histogram, öznitelikler: openclaw.harness.id, openclaw.harness.plugin, openclaw.outcome, hatalarda openclaw.harness.phase)
Araç yürütme
openclaw.tool.execution.duration_ms (histogram, öznitelikler: gen_ai.tool.name, openclaw.toolName, openclaw.tool.source, openclaw.tool.owner, openclaw.tool.params.kind, ayrıca hatalarda openclaw.errorCategory)openclaw.tool.execution.blocked (sayaç, öznitelikler: gen_ai.tool.name, openclaw.toolName, openclaw.tool.source, openclaw.tool.owner, openclaw.tool.params.kind, openclaw.deniedReason)
Exec
openclaw.exec.duration_ms (histogram, öznitelikler: openclaw.exec.target, openclaw.exec.mode, openclaw.outcome, openclaw.failureKind)
Tanılama iç bileşenleri (bellek ve araç döngüsü)
openclaw.payload.large (sayaç, öznitelikler: openclaw.payload.surface, openclaw.payload.action, openclaw.channel, openclaw.plugin, openclaw.reason)openclaw.payload.large_bytes (histogram, öznitelikler: openclaw.payload.large ile aynı)openclaw.memory.heap_used_bytes (histogram, öznitelikler: openclaw.memory.kind)openclaw.memory.rss_bytes (histogram)openclaw.memory.pressure (sayaç, öznitelikler: openclaw.memory.level)openclaw.tool.loop.iterations (sayaç, öznitelikler: openclaw.toolName, openclaw.outcome)openclaw.tool.loop.duration_ms (histogram, öznitelikler: openclaw.toolName, openclaw.outcome)
Dışa aktarılan span’ler
openclaw.model.usage
openclaw.channel, openclaw.provider, openclaw.modelopenclaw.tokens.* (input/output/cache_read/cache_write/total)- Varsayılan olarak
gen_ai.system veya en yeni GenAI semantik kuralları etkinleştirildiğinde gen_ai.provider.name
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
- Varsayılan olarak
gen_ai.system veya en yeni GenAI semantik kuralları etkinleştirildiğinde gen_ai.provider.name
gen_ai.request.model, gen_ai.operation.name, openclaw.provider, openclaw.model, openclaw.api, openclaw.transport- Hatalarda
openclaw.errorCategory ve isteğe bağlı openclaw.failureKind
openclaw.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 (yalnızca güvenli bileşen boyutları, prompt metni yok)- Model çağrısı sonucu ilgili tekil çağrı için sağlayıcı kullanımını taşıdığında
openclaw.model_call.usage.* ve gen_ai.usage.*
openclaw.provider.request_id_hash (üst sağlayıcı istek kimliğinin sınırlı SHA tabanlı karması; ham kimlikler dışa aktarılmaz)OTEL_SEMCONV_STABILITY_OPT_IN=gen_ai_latest_experimental ile model çağrısı span’leri openclaw.model.call yerine en yeni GenAI çıkarım span adı {gen_ai.operation.name} {gen_ai.request.model} ve CLIENT span türünü kullanır.
openclaw.harness.run
openclaw.harness.id, openclaw.harness.plugin, openclaw.outcome, openclaw.provider, openclaw.model, openclaw.channel- Tamamlandığında:
openclaw.harness.result_classification, openclaw.harness.yield_detected, openclaw.harness.items.started, openclaw.harness.items.completed, openclaw.harness.items.active
- Hata durumunda:
openclaw.harness.phase, openclaw.errorCategory, isteğe bağlı openclaw.harness.cleanup_failed
openclaw.tool.execution
gen_ai.tool.name, openclaw.toolName, openclaw.errorCategory, openclaw.tool.params.*
openclaw.exec
openclaw.exec.target, openclaw.exec.mode, openclaw.outcome, openclaw.failureKind, openclaw.exec.command_length, openclaw.exec.exit_code, 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 (prompt, geçmiş, yanıt veya oturum anahtarı içeriği yok)
openclaw.tool.loop
openclaw.toolName, openclaw.outcome, openclaw.iterations, openclaw.errorCategory (döngü iletileri, parametreler veya araç çıktısı yok)
openclaw.memory.pressure
openclaw.memory.level, openclaw.memory.heap_used_bytes, openclaw.memory.rss_bytes
İçerik yakalama açıkça etkinleştirildiğinde, model ve araç span’leri, etkinleştirdiğiniz belirli içerik sınıfları için sınırlı ve redakte edilmiş openclaw.content.* özniteliklerini de içerebilir.
Tanılama olay kataloğu
Aşağıdaki olaylar, yukarıdaki metrikleri ve span’leri destekler. Plugin’ler bunlara OTLP dışa aktarımı olmadan da doğrudan abone olabilir.
Model kullanımı
model.usage - token’lar, maliyet, süre, bağlam, sağlayıcı/model/kanal, oturum kimlikleri. usage, maliyet ve telemetri için sağlayıcı/tur muhasebesidir; context.used geçerli prompt/bağlam anlık görüntüsüdür ve önbelleğe alınmış girdi veya araç döngüsü çağrıları söz konusu olduğunda sağlayıcı usage.total değerinden düşük olabilir.
İleti akışı
webhook.received / webhook.processed / webhook.errormessage.queued / message.processedmessage.delivery.started / message.delivery.completed / message.delivery.error
Kuyruk ve oturum
queue.lane.enqueue / queue.lane.dequeuesession.state / session.long_running / session.stalled / session.stuckrun.attempt / run.progressdiagnostic.heartbeat (toplu sayaçlar: webhook’lar/kuyruk/oturum)
Harness yaşam döngüsü
harness.run.started / harness.run.completed / harness.run.error -
ajan harness’ı için çalıştırma başına yaşam döngüsü. harnessId, isteğe bağlı pluginId, sağlayıcı/model/kanal ve çalıştırma kimliğini içerir. Tamamlama durationMs, outcome, isteğe bağlı resultClassification, yieldDetected ve itemLifecycle sayılarını ekler. Hatalar phase (prepare/start/send/resolve/cleanup), errorCategory ve isteğe bağlı cleanupFailed ekler.
Exec
exec.process.completed - terminal sonuç, süre, hedef, mod, çıkış kodu ve hata türü. Komut metni ve çalışma dizinleri dahil edilmez.exec.approval.followup_suppressed - oturum geri sıçramasından sonra eski onay takip işlemi düşürüldü. approvalId, reason (session_rebound), phase (direct_delivery veya gateway_preflight) ve dağıtıcı zaman damgasını içerir. Oturum anahtarları, rotalar ve komut metni dahil edilmez.
Dışa aktarıcı olmadan
diagnostics-otel çalıştırmadan tanılama olaylarını Plugin’ler veya özel havuzlar için kullanılabilir tutabilirsiniz:
{
diagnostics: { enabled: true },
}
logging.level değerini yükseltmeden hedefli hata ayıklama çıktısı için tanılama bayraklarını kullanın. Bayraklar büyük/küçük harfe duyarlı değildir ve joker karakterleri destekler (örn. telegram.* veya *):
{
diagnostics: { flags: ["telegram.http"] },
}
OPENCLAW_DIAGNOSTICS=telegram.http,telegram.payload openclaw gateway
logging.file) gider ve yine de logging.redactSensitive tarafından redakte edilir. Tam kılavuz:
Tanılama bayrakları.
Devre dışı bırakma
{
diagnostics: { otel: { enabled: false } },
}
diagnostics-otel öğesini plugins.allow dışında bırakabilir veya openclaw plugins disable diagnostics-otel komutunu çalıştırabilirsiniz.
İlgili
