Deprecations

See the deprecation policy for details.

Active Deprecations

The current Vector release is v0.58.0. Deprecated configuration and features are retained for at least one minor release before they are eligible for removal.

omitting the version field on influxdb_logs and influxdb_metrics sinks
Deprecated since 0.58.0

The version field selects the InfluxDB API version whose settings are used. It will be required in a future release. Until then, when version is unset the version is inferred from the configured settings.

  • version: "1" uses the v1 settings: database, consistency, retention_policy_name, username, and password.
  • version: "2" uses the v2 settings: org, bucket, and token.

Migrate by adding version: "1" or version: "2" to match the settings already present:

sinks:
  my_sink:
    type: influxdb_logs
    version: "2"
    org: my-org
    bucket: vector-bucket
    token: ${INFLUXDB_TOKEN}
Environment-variable and secret placeholders in non-string positions
Deprecated since 0.57.0

Placeholders (${VAR} and SECRET[backend.key]) in structural positions of a Vector configuration file are deprecated and will be removed in a future release. Current behavior is unchanged.

Affected patterns:

  • Unquoted placeholders in non-string fields (count = ${MY_COUNT}).
  • Placeholders in map keys (${KEY} = value).
  • Placeholders in TOML table headers ([${SECTION}]).
  • Placeholders as inline array elements that expand to multiple values (inputs = [${VECTOR_INPUTS}] where VECTOR_INPUTS=a,b).

Migration guidance will accompany the removal PR. envsubst can be used today to pre-expand env-var placeholders into a fully static config as a workaround.

See RFC: parse-first config interpolation for the full rationale.

Boolean syntax for the compression field in the vector sink
Deprecated since 0.56.0

The boolean syntax (compression: true / compression: false) is deprecated. Use the string syntax instead: compression: "gzip", compression: "zstd", or compression: "none".

The bool_or_vector_compression deserializer will be removed once the boolean syntax is no longer supported.

series_api_version: v1 option on the datadog_metrics sink
Deprecated since 0.56.0

The series_api_version: v1 option is deprecated in favor of v2 (the default). The v1 series endpoint (/api/v1/series) is a legacy endpoint.

Users should remove series_api_version: v1 from their configuration or set it to v2.

Past Deprecations

These features have been removed from Vector since version 0.57.0, when the new deprecation system was introduced.

GreptimeDB v0.x support in greptimedb_metrics and greptimedb_logs sinks
Deprecated since 0.55.0 · Removed in 0.56.0
The greptimedb_metrics and greptimedb_logs sinks drop support for GreptimeDB v0.x. Users must upgrade their GreptimeDB instance to v1.x before upgrading Vector.
azure_monitor_logs sink
Deprecated since 0.54.0 · Removed in 0.58.0

The azure_monitor_logs sink is deprecated in favor of the new azure_logs_ingestion sink, which uses the Azure Monitor Logs Ingestion API.

Users should migrate before Microsoft ends support for the old Data Collector API (scheduled for September 2026).

buffer_byte_size and buffer_events gauge metrics
Deprecated since 0.53.0 · Removed in 0.58.0
The buffer_byte_size and buffer_events gauges are deprecated in favor of the buffer_size_bytes and buffer_size_events metrics.
encoding field on HTTP server sources
Deprecated since 0.50.0 · Removed in 0.58.0
The encoding field will be removed. Use decoding and framing instead.
Sidebar