Deprecations

See the deprecation policy for details.

Active Deprecations

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

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.

azure_monitor_logs sink
Deprecated since 0.54.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
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
The encoding field will be removed. Use decoding and framing instead.

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.
Sidebar