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 suffixThe 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
_total suffixThe 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_totalmemory_enrichment_table_failed_reads_totalmemory_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_insertionsmemory_enrichment_table_failed_readsmemory_enrichment_table_ttl_expirations
packages.timber.ioStable 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.
| Artifact | Migration outcome |
|---|---|
| Stable Vector releases, installers, and package-manager downloads | Migrated 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 URLs | Remain readable through December 31, 2026, and may be deleted at any time after that date |
| Nightly and custom builds | Treated 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 charts | GitHub Release assets; https://helm.vector.dev remains the Helm repository index |
| All other legacy artifacts | Not migrated and will be deleted |
process_runtime counter without the _total suffixThe 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
address and routing.endpoints values in the vector sink defaulting to httpA 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
version field on influxdb_logs and influxdb_metrics sinksThe 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, andpassword.version: "2"uses the v2 settings:org,bucket, andtoken.
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}
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}]whereVECTOR_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 sinkThe 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.
compression field in the vector sinkThe 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_metrics and greptimedb_logs sinksgreptimedb_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 sinkThe 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 metricsbuffer_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 sourcesencoding field will be removed. Use decoding and framing instead.