Skip to main content

OTEL-010: Receivers should not bind to 0.0.0.0

Severity: warn (advisory)

Rule Details

Binding a receiver to 0.0.0.0 tells the Collector to accept traffic on every network interface the host has — including public ones. For sidecars and single-node agents you almost always want localhost (or 127.0.0.1) so only workloads on the same network namespace can push data. For gateway Collectors, bind to a specific private interface rather than 0.0.0.0.

This rule fires when any string under a receiver contains the substring 0.0.0.0.

Options

This rule has no options.

Examples

Avoid
receivers:
otlp:
protocols:
grpc:
endpoint: "0.0.0.0:4317"
http:
endpoint: "0.0.0.0:4318"
Prefer
receivers:
otlp:
protocols:
grpc:
endpoint: "localhost:4317"
http:
endpoint: "localhost:4318"

When Not To Use It

A gateway Collector that genuinely needs to accept traffic from arbitrary hosts on a trusted private network. In that case prefer binding to a specific interface (e.g. 10.0.0.5:4317) over the wildcard, and combine with OTEL-033 / OTEL-031 to enforce TLS.

  • OTEL-033 — receiver on non-localhost endpoint without TLS
  • OTEL-060zpages endpoint bound to 0.0.0.0
  • OTEL-070 — telemetry metrics address bound to 0.0.0.0

Version

Available since augur v0.1.0.

Further Reading

Resources