Skip to main content
RunBook Academy

← All break/fix scenarios in Observability

intermediateotel-pipeline~25 min

Break/Fix: OTel Collector Pipeline Broken

Reported symptoms

  • OTel Collector is failing

Evidence

  • · Collector logs show pipeline errors
Diagnosis and resolutionclick to reveal

Root cause

The pipeline configuration is wrong.

Remediation

1. Inspect collector logs. 2. Validate pipeline config. 3. Fix.

Verification

Pipeline runs without errors.

Prevention

Linting pipeline config

Scenario

You are operating a production observability platform. The following symptoms appear:

  • OTel Collector is failing

Available evidence:

  • Collector logs show pipeline errors

Your task

Determine the cause, recover, document, and validate.

Investigation

The investigation follows the discipline taught in Part XCVIII:

  1. Form hypothesis, find evidence, test, validate.
  2. Use the available evidence above to bound the search.
  3. Reach one of the likely root causes.

Recovery procedure

(Do not reveal until you have reasoned through the problem.)

  1. Identify the failing component.
  2. Apply the remediation pathway.
  3. Validate with the verification step.
  4. Document the incident.

Remediation

  1. Inspect collector logs. 2. Validate pipeline config. 3. Fix.

Verification

Pipeline runs without errors.

Rollback

Revert

Prevention

Linting pipeline config