Skip to main content

OTEL-062: Extension in service.extensions but not defined

Severity: warn (advisory)

Rule Details​

service.extensions is the list of enabled extensions. Each entry must refer to a block that actually exists in the top-level extensions: section. If it does not, the Collector aborts startup with a cryptic "unknown extension" error. This rule catches stray references — usually left over from renaming or removing an extension without updating the service block.

This rule fires when a name in service.extensions does not have a matching entry in extensions:.

Options​

This rule has no options.

Examples​

Avoid
extensions:
  health_check:
    endpoint: "localhost:13133"

service:
  extensions: [health_check, pprof]    # pprof not defined
Prefer
extensions:
  health_check:
    endpoint: "localhost:13133"

service:
  extensions: [health_check]

When Not To Use It​

Never — this configuration cannot start.

  • OTEL-011 — health_check extension recommended
  • OTEL-012 — health_check configured but not listed in service.extensions

Version​

Available since augur v0.1.0.

Further Reading​

Resources​