Skip to main content

OTEL-058: Multiple receivers bound to the same endpoint

Severity: deny (blocking)

Rule Details​

Two receivers pointed at the same host:port will both try to bind(2) it at Collector startup. One succeeds, one fails with address already in use, and the Collector exits. This is usually the result of a merge that duplicated an OTLP block, or a template that emits the same receiver twice under different names.

This rule fires when two distinct receivers have the same endpoint string.

Options​

This rule has no options.

Examples​

Incorrect
receivers:
  otlp:
    protocols:
      grpc:
        endpoint: localhost:4317
  otlp/secondary:
    protocols:
      grpc:
        endpoint: localhost:4317       # collides
Correct
receivers:
  otlp:
    protocols:
      grpc:
        endpoint: localhost:4317
  otlp/secondary:
    protocols:
      grpc:
        endpoint: localhost:14317

When Not To Use It​

Never — the config cannot start.

  • OTEL-010 — receivers should not bind to 0.0.0.0
  • OTEL-020 — unused receiver

Version​

Available since augur v0.1.0.

Further Reading​

Resources​