Runbook: OTel Collector Down

Recovery steps for the local Nexus OpenTelemetry Collector

Last updated on: 21 de septiembre de 2026

Esta página aún no está disponible en tu idioma.

This runbook covers the local Nexus OpenTelemetry Collector used by the dev compose stack.

Symptoms

http://127.0.0.1:18888/metrics is unreachable.
Grafana Explore shows no recent Tempo traces or Loki logs.
Service logs mention OTLP export failures.

Checks

From the repository root:

just compose ps otel-collector
just logs otel-collector
just compose config --quiet

If the config command fails, fix deploy/compose/otel-collector.yaml before restarting.

Recovery

just compose up -d otel-collector tempo loki prometheus grafana

Then verify:

curl -fsS http://127.0.0.1:18888/metrics | grep otelcol_receiver_accepted

Tier 2 telemetry is operational-only. Do not copy tenant request bodies, API keys, prompts, completions, or tenant IDs into collector logs or debugging payloads.

See Observability (Local Stack) for the full LGTM stack this collector feeds, and Telemetry Tiering for what Tier 2 telemetry may and may not contain.