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.