0.60 Upgrade Guide

An upgrade guide that addresses breaking changes in 0.60.0

Datadog metrics series v1 removed

Summary

The datadog_metrics sink no longer accepts series_api_version: v1, which was deprecated in 0.56.0. Configurations that select v1 now fail to load.

Migration

Remove series_api_version: v1 to use the default v3 endpoint, or set series_api_version: v2 if your destination requires the v2 endpoint.

InfluxDB sinks require an explicit version

Summary

The version option is now required for the influxdb_logs and influxdb_metrics sinks. Omitting it was deprecated in 0.58.0, and the version is no longer inferred from the configured settings. Configurations without version now fail to load.

Settings that belong to the other version are now rejected even when set to null. For example, version: "2" with database: null fails with unknown field 'database'. Remove these settings from the configuration.

Migration

Add version: "1" or version: "2" to match the configured InfluxDB settings. Use "1" with database, consistency, retention_policy_name, username, and password; use "2" with org, bucket, and token.

Old

sinks:
  influx:
    type: influxdb_metrics
    endpoint: http://localhost:8086
    org: my-org
    bucket: my-bucket
    token: ${INFLUXDB_TOKEN}

New

sinks:
  influx:
    type: influxdb_metrics
    endpoint: http://localhost:8086
    version: "2"
    org: my-org
    bucket: my-bucket
    token: ${INFLUXDB_TOKEN}