Exportation OpenTelemetry

OpenClaw exporte les diagnostics via le plugin officiel OpenClawdiagnostics-otel en utilisant OTLP/HTTP (protobuf). Tout collecteur ou backend acceptant OTLP/HTTP fonctionne sans modification de code. Pour les journaux de fichiers locaux et leur lecture, voir Logging.

Fonctionnement global

Les événements de diagnostic sont des enregistrements structurés, en cours de traitement, émis par le Gateway et les plugins inclus pour les exécutions de modèle, le flux de messages, les sessions, les files d’attente, et l’exécution.
Le plugin diagnostics-otel s’abonne à ces événements et les exporte en tant que métriques, traces et journaux OpenTelemetry via OTLP/HTTP.
Les appels de fournisseur reçoivent un en-tête W3C traceparentOpenClaw du contexte de span d’appel de modèle de confiance d’OpenClaw lorsque le transport du fournisseur accepte les en-têtes personnalisés. Le contexte de trace émis par le plugin n’est pas propagé.
Les exportateurs ne s’attachent que lorsque la surface de diagnostic et le plugin sont tous deux activés, donc le coût en cours de traitement reste proche de zéro par défaut.

Quick start

Pour les installations empaquetées, installez d’abord le plugin :

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,
    },
  },
}

Vous pouvez également activer le plugin depuis le CLI :

openclaw plugins enable diagnostics-otel

Signaux exportés

Signal	Ce qu’il contient
Métriques	Compteurs et histogrammes pour l’utilisation des jetons, le coût, la durée d’exécution, le basculement, l’utilisation des compétences, le flux de messages, les événements Talk, les voies de file d’attente, l’état/récupération de session, l’exécution d’outils, les charges utiales surdimensionnées, l’exécution et la pression mémoire.
Traces	Spans pour l’utilisation de modèles, les appels de modèles, le cycle de vie du harnais, l’utilisation des compétences, l’exécution d’outils, exec, le traitement de webhooks/messages, l’assemblage du contexte et les boucles d’outils.
Journaux	Enregistrements `logging.file` structurés exportés via OTLP lorsque `diagnostics.otel.logs` est activé ; les corps des journaux sont retenus sauf si la capture de contenu est explicitement activée.

Activez traces, metrics et logs indépendamment. Les traces et les métriques sont activées par défaut lorsque diagnostics.otel.enabled est vrai. Les journaux sont désactivés par défaut et ne sont exportés que lorsque diagnostics.otel.logs est explicitement true.

Référence de configuration

{
  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,
      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,
      },
    },
  },
}

Variables d’environnement

Variable	Objet
`OTEL_EXPORTER_OTLP_ENDPOINT`	Remplacer `diagnostics.otel.endpoint`. Si la valeur contient déjà `/v1/traces`, `/v1/metrics` ou `/v1/logs`, elle est utilisée telle quelle.
`OTEL_EXPORTER_OTLP_TRACES_ENDPOINT` / `OTEL_EXPORTER_OTLP_METRICS_ENDPOINT` / `OTEL_EXPORTER_OTLP_LOGS_ENDPOINT`	Remplacements de point de terminaison spécifiques aux signaux utilisés lorsque la clé de configuration Signal`diagnostics.otel.*Endpoint`Signal correspondante n’est pas définie. La configuration spécifique au signal l’emporte sur la variable d’environnement spécifique au signal, qui l’emporte sur le point de terminaison partagé.
`OTEL_SERVICE_NAME`	Remplacer `diagnostics.otel.serviceName`.
`OTEL_EXPORTER_OTLP_PROTOCOL`	Remplacer le protocole de connexion (seul `http/protobuf` est reconnu aujourd’hui).
`OTEL_SEMCONV_STABILITY_OPT_IN`	Définir sur `gen_ai_latest_experimental` pour émettre la dernière forme expérimentale de span d’inférence GenAI, y compris les noms de span `{gen_ai.operation.name} {gen_ai.request.model}`, le type de span `CLIENT` et `gen_ai.provider.name` au lieu de l’ancien `gen_ai.system`. Les métriques GenAI utilisent toujours des attributs sémantiques bornés et de faible cardinalité, quelle que soit la valeur.
`OPENCLAW_OTEL_PRELOADED`	Définissez à `1` lorsqu’un autre préchargement ou processus hôte a déjà enregistré le SDK OpenTelemetry global. Le plugin ignore alors son propre cycle de vie NodeSDK mais connecte toujours les écouteurs de diagnostic et respecte `traces`/`metrics`/`logs`.

Confidentialité et capture de contenu

Le contenu brut du model/tool n’est pas exporté par défaut. Les spans contiennent des identifiants délimités (channel, provider, model, catégorie d’erreur, identifiants de demande hachés uniquement, source de l’outil, propriétaire de l’outil et nom/source de la compétence) et n’incluent jamais le texte de l’invite, le texte de réponse, les entrées de l’outil, les sorties de l’outil, les chemins de fichiers de compétence ou les clés de session. Les enregistrements de journaux OTLP conservent la gravité, le logger, l’emplacement du code, le contexte de trace approuvé et les attributs assainis par défaut, mais le corps du message de journal brut n’est exporté que lorsque diagnostics.otel.captureContent est défini sur le booléen true. Les sous-clés granulaires de captureContent.* n’activent pas les corps de journaux. Les étiquettes qui ressemblent à des clés de session d’agent délimitées sont remplacées par unknown. Les métriques Talk n’exportent que des métadonnées d’événement délimitées telles que le mode, le transport, le provider et le type d’événement. Elles n’incluent pas les transcriptions, les charges utiles audio, les identifiants de session, les identifiants de tour, les identifiants d’appel, les identifiants de salle ou les jetons de transfert.

Les demandes de model sortantes peuvent inclure un en-tête W3C traceparent. Cet en-tête est généré uniquement à partir du contexte de trace de diagnostic détenu par OpenClaw pour l’appel de model actif. Les en-têtes traceparent existants fournis par l’appelant sont remplacés, de sorte que les plugins ou les options de provider personnalisées ne peuvent pas usurper l’ascendance de trace interservices.

Définissez diagnostics.otel.captureContent.* à true uniquement lorsque votre collecteur et votre stratégie de rétention sont approuvés pour le texte de l’invite, de la réponse, de l’outil ou de l’invite système. Chaque sous-clé est un choix indépendant :

inputMessages - contenu de l’invite utilisateur.
outputMessages - contenu de la réponse du model.
toolInputs - charges utiles des arguments de l’outil.
toolOutputs - charges utiles des résultats de l’outil.
systemPrompt - invite système/développeur assemblée.
toolDefinitions - noms, descriptions et schémas des outils du model.

Lorsqu’une sous-clé est activée, les spans de modèle et d’outil obtiennent des attributs bornés et rédigés pour cette classe uniquement. Utilisez le booléen openclaw.content.*``captureContent: true uniquement pour les captures de diagnostics générales où les corps des messages de journal OTLP sont également approuvés pour l’exportation.

Échantillonnage et vidage

Traces : diagnostics.otel.sampleRate (racine de la span uniquement, 0.0 supprime tout, 1.0 conserve tout).
Métriques : diagnostics.otel.flushIntervalMs (minimum 1000).
Journaux : Les journaux OTLP respectent logging.level (niveau de journalisation des fichiers). Ils utilisent le chemin de rédaction des enregistrements de journaux de diagnostic, et non le formatage de la console. Les installations à fort volume devraient privilégier l’échantillonnage/filtrage du collecteur OTLP par rapport à l’échantillonnage local.
Corrélation des journaux de fichiers : Les journaux de fichiers JSONL incluent des éléments de premier niveau traceId, spanId, parentSpanId et traceFlags lorsque l’appel de journal transporte un contexte de trace de diagnostic valide, ce qui permet aux processeurs de journaux de joindre les lignes de journaux locales aux spans exportées.
Corrélation des requêtes : Les requêtes HTTP du Gateway et les trames WebSocket créent une étendue de trace de requête interne. Les journaux et les événements de diagnostic dans cette étendue héritent de la trace de requête par défaut, tandis que les spans d’exécution d’agent et d’appel de modèle sont créés en tant qu’enfants afin que les en-têtes traceparent du fournisseur restent sur la même trace.

Métriques exportées

Utilisation du modèle

openclaw.tokens (compteur, attrs : openclaw.token, openclaw.channel, openclaw.provider, openclaw.model, openclaw.agent)
openclaw.cost.usd (compteur, attrs : openclaw.channel, openclaw.provider, openclaw.model)
openclaw.run.duration_ms (histogramme, attrs : openclaw.channel, openclaw.provider, openclaw.model)
openclaw.context.tokens (histogramme, attrs : openclaw.context, openclaw.channel, openclaw.provider, openclaw.model)
gen_ai.client.token.usage (histogram, métrique de conventions sémantiques GenAI, attrs : gen_ai.token.type = input/output, gen_ai.provider.name, gen_ai.operation.name, gen_ai.request.model)
gen_ai.client.operation.duration (histogram, secondes, métrique de conventions sémantiques GenAI, attrs : gen_ai.provider.name, gen_ai.operation.name, gen_ai.request.model, optionnel error.type)
openclaw.model_call.duration_ms (histogram, attrs : openclaw.provider, openclaw.model, openclaw.api, openclaw.transport, plus openclaw.errorCategory et openclaw.failureKind pour les erreurs classées)
openclaw.model_call.request_bytes (histogram, taille en octets UTF-8 de la charge utile finale de la requête du modèle ; pas de contenu de charge utile brute)
openclaw.model_call.response_bytes (histogramme, taille en octets UTF-8 des événements de réponse de modèle diffusés excluant les instantanés partial accumulés sur les événements delta ; pas de contenu de réponse brut)
openclaw.model_call.time_to_first_byte_ms (histogramme, temps écoulé avant le premier événement de réponse diffusé)
openclaw.model.failover (compteur, attrs : openclaw.provider, openclaw.model, openclaw.failover.to_provider, openclaw.failover.to_model, openclaw.failover.reason, openclaw.failover.suspended, openclaw.lane)
openclaw.skill.used (compteur, attrs : openclaw.skill.name, openclaw.skill.source, openclaw.skill.activation, optionnel openclaw.agent, optionnel openclaw.toolName)

Flux de messages

openclaw.webhook.received (compteur, attrs : openclaw.channel, openclaw.webhook)
openclaw.webhook.error (compteur, attrs : openclaw.channel, openclaw.webhook)
openclaw.webhook.duration_ms (histogramme, attrs : openclaw.channel, openclaw.webhook)
openclaw.message.queued (compteur, attrs : openclaw.channel, openclaw.source)
openclaw.message.received (compteur, attrs : openclaw.channel, openclaw.source)
openclaw.message.dispatch.started (compteur, attrs : openclaw.channel, openclaw.source)
openclaw.message.dispatch.completed (compteur, attrs : openclaw.channel, openclaw.outcome, openclaw.reason, openclaw.source)
openclaw.message.dispatch.duration_ms (histogram, attrs : openclaw.channel, openclaw.outcome, openclaw.reason, openclaw.source)
openclaw.message.processed (counter, attrs : openclaw.channel, openclaw.outcome)
openclaw.message.duration_ms (histogram, attrs : openclaw.channel, openclaw.outcome)
openclaw.message.delivery.started (counter, attrs : openclaw.channel, openclaw.delivery.kind)
openclaw.message.delivery.duration_ms (histogram, attrs : openclaw.channel, openclaw.delivery.kind, openclaw.outcome, openclaw.errorCategory)

Talk

openclaw.talk.event (counter, attrs : openclaw.talk.event_type, openclaw.talk.mode, openclaw.talk.transport, openclaw.talk.brain, openclaw.talk.provider)
openclaw.talk.event.duration_ms (histogram, attrs : identiques à openclaw.talk.event ; émis lorsqu’un événement Talk signale une durée)
openclaw.talk.audio.bytes (histogram, attrs : identiques à openclaw.talk.event ; émis pour les événements de trame audio Talk qui signalent une longueur en octets)

Files d’attente et sessions

openclaw.queue.lane.enqueue (counter, attrs : openclaw.lane)
openclaw.queue.lane.dequeue (counter, attrs : openclaw.lane)
openclaw.queue.depth (histogram, attrs : openclaw.lane ou openclaw.channel=heartbeat)
openclaw.queue.wait_ms (histogram, attrs : openclaw.lane)
openclaw.session.state (counter, attrs : openclaw.state, openclaw.reason)
openclaw.session.stuck (counter, attrs : openclaw.state ; émis pour la gestion des sessions périmées récupérables)
openclaw.session.stuck_age_ms (histogram, attrs : openclaw.state ; émis pour la gestion des sessions périmées récupérables)
openclaw.session.turn.created (compteur, attrs : openclaw.agent, openclaw.channel, openclaw.trigger)
openclaw.session.recovery.requested (compteur, attrs : openclaw.state, openclaw.action, openclaw.active_work_kind, openclaw.reason)
openclaw.session.recovery.completed (compteur, attrs : openclaw.state, openclaw.action, openclaw.status, openclaw.active_work_kind, openclaw.reason)
openclaw.session.recovery.age_ms (histogramme, attrs : identiques à ceux du compteur de récupération correspondant)
openclaw.run.attempt (compteur, attrs : openclaw.attempt)

Télémétrie de l’activité des sessions

diagnostics.stuckSessionWarnMs est le seuil d’ancienneté sans progression pour les diagnostics de vivacité de session. Une session processing ne vieillit pas vers ce seuil tant que OpenClaw observe une progression de réponse, d’outil, de statut, de bloc ou du runtime ACP. Les keepalives de frappe ne sont pas comptés comme une progression, un modèle ou un harnais silencieux peut donc toujours être détecté.

OpenClaw classe les sessions en fonction du travail qu’il peut encore observer :

session.long_running : le travail intégré actif, les appels au modèle ou les appels à l’outil progressent toujours.
session.stalled : un travail actif existe, mais l’exécution active n’a pas signalé de progression récente. Les exécutions intégrées bloquées restent d’abord en observation seule, puis sont interrompues-vidées après diagnostics.stuckSessionAbortMs sans progression afin que les tours en file d’attente derrière la voie puissent reprendre. S’il n’est pas défini, le seuil d’interruption correspond par défaut à la fenêtre étendue plus sûre d’au moins 5 minutes et 3x diagnostics.stuckSessionWarnMs.
session.stuck : gestion de session obsolète sans travail actif, ou une session en file d’attente inactive avec une activité de modèle/outil sans propriétaire obsolète. Cela libère la voie de session affectée immédiatement après le passage des portes de récupération.

La récupération émet des événements structurés session.recovery.requested et session.recovery.completed. L’état de diagnostic de la session est marqué inactif uniquement après un résultat de récupération mutateur (aborted ou released) et uniquement si la même génération de traitement est toujours actuelle.

Seul session.stuck émet le compteur openclaw.session.stuck, l’histogramme openclaw.session.stuck_age_ms et la portée openclaw.session.stuck. Les diagnostics session.stuck répétés se désengagent tant que la session reste inchangée, les tableaux de bord doivent donc alerter sur les augmentations soutenues plutôt qu’à chaque battement de cœur. Pour le paramètre de configuration et les valeurs par défaut, consultez Référence de configuration.

Les avertissements de vivacité émettent également :

openclaw.liveness.warning (compteur, attrs : openclaw.liveness.reason)
openclaw.liveness.event_loop_delay_p99_ms (histogramme, attrs : openclaw.liveness.reason)
openclaw.liveness.event_loop_delay_max_ms (histogramme, attrs : openclaw.liveness.reason)
openclaw.liveness.event_loop_utilization (histogramme, attrs : openclaw.liveness.reason)
openclaw.liveness.cpu_core_ratio (histogramme, attrs : openclaw.liveness.reason)

Cycle de vie du harnais

openclaw.harness.duration_ms (histogramme, attrs : openclaw.harness.id, openclaw.harness.plugin, openclaw.outcome, openclaw.harness.phase en cas d’erreurs)

Exécution d’outil

openclaw.tool.execution.duration_ms (histogramme, attrs : gen_ai.tool.name, openclaw.toolName, openclaw.tool.source, openclaw.tool.owner, openclaw.tool.params.kind, plus openclaw.errorCategory en cas d’erreurs)
openclaw.tool.execution.blocked (compteur, attrs : gen_ai.tool.name, openclaw.toolName, openclaw.tool.source, openclaw.tool.owner, openclaw.tool.params.kind, openclaw.deniedReason)

Exec

openclaw.exec.duration_ms (histogramme, attrs : openclaw.exec.target, openclaw.exec.mode, openclaw.outcome, openclaw.failureKind)

Diagnostics internals (memory and tool loop)

openclaw.payload.large (compteur, attrs : openclaw.payload.surface, openclaw.payload.action, openclaw.channel, openclaw.plugin, openclaw.reason)
openclaw.payload.large_bytes (histogramme, attrs : identiques à openclaw.payload.large)
openclaw.memory.heap_used_bytes (histogram, attrs : openclaw.memory.kind)
openclaw.memory.rss_bytes (histogram)
openclaw.memory.pressure (counter, attrs : openclaw.memory.level)
openclaw.tool.loop.iterations (counter, attrs : openclaw.toolName, openclaw.outcome)
openclaw.tool.loop.duration_ms (histogram, attrs : openclaw.toolName, openclaw.outcome)

Exported spans

openclaw.model.usage
- openclaw.channel, openclaw.provider, openclaw.model
- openclaw.tokens.* (input/output/cache_read/cache_write/total)
- gen_ai.system par défaut, ou gen_ai.provider.name lorsque les dernières conventions sémantiques GenAI sont activées
- 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 par défaut, ou gen_ai.provider.name lorsque les dernières conventions sémantiques GenAI sont activées
- gen_ai.request.model, gen_ai.operation.name, openclaw.provider, openclaw.model, openclaw.api, openclaw.transport
- openclaw.errorCategory et openclaw.failureKind facultatif en cas d’erreurs
- openclaw.model_call.request_bytes, openclaw.model_call.response_bytes, openclaw.model_call.time_to_first_byte_ms
- openclaw.provider.request_id_hash (haché borné basé sur SHA de l’id de requête du fournisseur amont ; les ids bruts ne sont pas exportés)
- Avec OTEL_SEMCONV_STABILITY_OPT_IN=gen_ai_latest_experimental, les spans d’appel de modèle utilisent le dernier nom de span d’inférence GenAI {gen_ai.operation.name} {gen_ai.request.model} et le kind de span CLIENT au lieu de openclaw.model.call.
openclaw.harness.run
- openclaw.harness.id, openclaw.harness.plugin, openclaw.outcome, openclaw.provider, openclaw.model, openclaw.channel
- À la fin : openclaw.harness.result_classification, openclaw.harness.yield_detected, openclaw.harness.items.started, openclaw.harness.items.completed, openclaw.harness.items.active
- En cas d’erreur : openclaw.harness.phase, openclaw.errorCategory, facultatif 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 (aucun contenu de prompt, d’historique, de réponse ou de clé de session)
openclaw.tool.loop
- openclaw.toolName, openclaw.outcome, openclaw.iterations, openclaw.errorCategory (pas de messages de boucle, de paramètres ou de sortie de tool)
openclaw.memory.pressure
- openclaw.memory.level, openclaw.memory.heap_used_bytes, openclaw.memory.rss_bytes

Lorsque la capture de contenu est explicitement activée, les spans de model et de tool peuvent également inclure des attributs openclaw.content.* délimités et masqués pour les classes de contenu spécifiques que vous avez choisies.

Catalogue des événements de diagnostic

Les événements ci-dessous prennent en charge les métriques et les spans ci-dessus. Les plugins peuvent également s’y abonner directement sans exportation OTLP.

Utilisation du modèle

model.usage - tokens, coût, durée, contexte, provider/model/channel, ids de session. usage est la comptabilité provider/turn pour le coût et la télémétrie ; context.used est l’instantané actuel du prompt/contexte et peut être inférieur au usage.total du provider lorsque des entrées mises en cache ou des appels tool-loop sont impliqués.

Flux de messages

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

File d’attente et session

queue.lane.enqueue / queue.lane.dequeue
session.state / session.long_running / session.stalled / session.stuck
run.attempt / run.progress
diagnostic.heartbeat (compteurs agrégés : webhooks/queue/session)

Cycle de vie du harnais

harness.run.started / harness.run.completed / harness.run.error - cycle de vie par exécution pour le harnais de l’agent. Inclut harnessId, pluginId en option, provider/model/channel, et l’id d’exécution. L’achèvement ajoute durationMs, outcome, resultClassification en option, yieldDetected, et les comptes itemLifecycle. Les erreurs ajoutent phase (prepare/start/send/resolve/cleanup), errorCategory, et cleanupFailed en option.

Exec

exec.process.completed - résultat final, durée, cible, mode, code de sortie et type d’échec. Le texte de la commande et les répertoires de travail ne sont pas inclus.

Sans exportateur

Vous pouvez garder les événements de diagnostic disponibles pour les plugins ou les récepteurs personnalisés sans exécuter diagnostics-otel :

{
  diagnostics: { enabled: true },
}

Pour une sortie de débogage ciblée sans déclencher logging.level, utilisez les drapeaux de diagnostic. Les drapeaux ne tiennent pas compte de la casse et prennent en charge les caractères génériques (ex. telegram.* ou *) :

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

Ou en tant que substitution d’environnement ponctuelle :

OPENCLAW_DIAGNOSTICS=telegram.http,telegram.payload openclaw gateway

La sortie des drapeaux va vers le fichier journal standard (logging.file) et est toujours rédigée par logging.redactSensitive. Guide complet : Diagnostics flags.

Désactiver

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

Vous pouvez également omettre diagnostics-otel de plugins.allow, ou exécuter openclaw plugins disable diagnostics-otel.

Connexes

Logging - journaux de fichiers, sortie console, suivi CLI et l’onglet Logs de l’UI de contrôle
Gateway logging internals - styles de journaux WS, préfixes de sous-système et capture console
Diagnostics flags - drapeaux de journal de débogage ciblés
Diagnostics export - outil de bundle de support pour l’opérateur (séparé de l’export OTEL)
Configuration reference - référence complète du champ diagnostics.*