Deprecations

See the deprecation policy for details.

Active Deprecations

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

aggregate_failed_updates counter without the _total suffix
Deprecated since 0.59.0

The aggregate transform now also emits the failed-updates counter with the _total suffix, matching Vector’s counter naming convention:

  • aggregate_failed_updates_total

The previous name without the _total suffix is deprecated and will be removed in a future release. Migrate any dashboards or alerts that reference:

  • aggregate_failed_updates
legacy memory enrichment table counters without the _total suffix
Deprecated since 0.59.0

The memory enrichment table failure and TTL-expiration counters are now also emitted with the _total suffix, matching Vector’s counter naming convention:

  • memory_enrichment_table_failed_insertions_total
  • memory_enrichment_table_failed_reads_total
  • memory_enrichment_table_ttl_expirations_total

The previous names without the _total suffix are deprecated and will be removed in a future release. Migrate any dashboards or alerts that reference:

  • memory_enrichment_table_failed_insertions
  • memory_enrichment_table_failed_reads
  • memory_enrichment_table_ttl_expirations
Stable Vector artifacts hosted at packages.timber.io
Deprecated since 0.59.0

Stable Vector release archives and packages are now hosted in the public COSE release bucket. The packages.timber.io/vector URLs are deprecated and users should switch to install.datadoghq.com/vector instead.

Starting with Vector 0.59.0, the Vector installer and the download instructions on vector.dev point to artifacts in the COSE bucket. Existing packages.timber.io URLs continue to work during the deprecation period.

ArtifactMigration outcome
Stable Vector releases, installers, and package-manager downloadsMigrated to exact-version paths under install.datadoghq.com/vector/<version>/; stable latest or .X aliases are not provided
packages.timber.io/vector versioned, latest, and version-alias URLsRemain readable through December 31, 2026, and may be deleted at any time after that date
Nightly and custom buildsTreated as transient artifacts that are superseded by stable releases, so existing builds are not migrated; future builds are published to install.datadoghq.com under vector/nightly/ and vector/custom/
Helm chartsGitHub Release assets; https://helm.vector.dev remains the Helm repository index
All other legacy artifactsNot migrated and will be deleted
host process_runtime counter without the _total suffix
Deprecated since 0.59.0

The host_metrics source now also emits the process runtime counter with the _total suffix, matching Vector’s counter naming convention:

  • process_runtime_total

The previous name without the _total suffix is deprecated and will be removed in a future release. Migrate any dashboards or alerts that reference:

  • process_runtime
scheme-less address and routing.endpoints values in the vector sink defaulting to http
Deprecated since 0.59.0

A vector sink endpoint such as 127.0.0.1 without an explicit scheme currently defaults to http. This behavior is deprecated and will change to https in a future release. Note that when TLS is enabled, a scheme-less address already defaults to https.

Migrate by specifying the scheme explicitly:

sinks:
  my_sink:
    type: vector
    address: http://127.0.0.1:6000
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.

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.

Boolean syntax for the compression field in the vector sink
Deprecated since 0.56.0 · Removed in 0.59.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.

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.