Skip to content
Nexus Docs
↑↓Navigate↵SelectescClose

Runbook: OTel Collector Down

Recovery steps for the local Nexus OpenTelemetry Collector

Last updated on:

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

Symptoms

Section titled “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

Section titled “Checks”

From the repository root:

Terminal window
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

Section titled “Recovery”
Terminal window
just compose up -d otel-collector tempo loki prometheus grafana

Then verify:

Terminal window
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.