How do I resolve "unable to read the file file:OBSERVE_URL" when deploying Observe Agent?

Data Ingestion
, ,
1

Issue Overview:

Starting with Observe Agent version 2.5.0, you may encounter the following error when referencing environment variables in the otel_config_overrides section:

Error: failed to get config: cannot resolve the configuration: unable to read the file file:OBSERVE_URL: open OBSERVE_URL: no such file or directory

In Observe Agent v2.5.0 and later, the agent enforces stricter parsing for variable references.

Previously, you may have written configuration overrides like:

otel_config_overrides:
  exporters:
    otlp:
      endpoint: ${OBSERVE_URL}

Solution:

To fix this, you must now use the ${env:VARNAME} syntax to explicitly indicate that the value should come from an environment variable.

Example:

otel_config_overrides:
  exporters:
    otlp:
      endpoint: ${env:OBSERVE_URL}

This tells the agent to look for the environment variable OBSERVE_URL rather than a file path.