Upgrade to Observe Agent v2.0.0

Observe Agent v2.0.0 includes the following breaking changes. Before upgrading the previous versions of Observe Agent to v2.0.0 (Linux, Windows, MacOS, Ansible), please check the following breaking changes.

CLI Changes renaming the config flags

The flag to specify the observe agent config has been changed from --config to --observe-config. The flag to specify OTel config has been changed from --otel-config to --config. This makes our start command fully compatible with the base otelcol command CLI. If you were using the default file location for the observe config and not specifying OTel config overrides via command line flag, no change is required.

Config file env var changes

The following changes are happening to the environment variables that the observe-agent automatically populates:

  • OBSERVE_ENDPOINT has been removed and replaced with:

    • OBSERVE_COLLECTOR_URL (ex: https://198826828955.collect.observe-eng.com/)

    • OBSERVE_OTEL_ENDPOINT (ex: https://198826828955.collect.observe-eng.com/v2/otel)

    • OBSERVE_PROMETHEUS_ENDPOINT (ex: https://198826828955.collect.observe-eng.com/v1/prometheus)

  • OBSERVE_TOKEN has been renamed to OBSERVE_AUTHORIZATION_HEADER (this always had the "Bearer " prefix)

All metrics are now exported as Prometheus metrics by default

This will improve the performance of the Observe metric monitoring. To export metrics as OTel metrics, see: Using OpenTelemetry Metrics with Observe Agent v2. All previously collected metrics will still be collected going forward, but the names may be changed as follows:

Periods to Underscores

All periods in metric names are replaced with underscores. Ex: http_client_duration.bucket -> http_client_duration_bucket

Suffixed with Total

Any metric that is a cumulative counter (aka monotonic) will be suffixed with _total. Ex: http_client_request_size -> http_client_request_size_total

Suffixed with Unit

Any metric with a unit defined in the metadata will have the unit added as a suffix to the name. Ex: file.mtime -> file_mtime_seconds

Combinations of the above

Multiple of the above transformations may be applied to a metric. Ex: process.cpu.time -> process_cpu_time_seconds_total

For more information, see the OTel Prometheus Remote Write Exporter design doc.