0.29 Upgrade Guide

An upgrade guide that addresses breaking changes in 0.29.0

by
Author avatar for stephenwakely Stephen Wakely , Author avatar for neuronull neuronull

Vector’s 0.29.0 release includes breaking changes:

  1. Removal of the datadog_logs and datadog_metrics sinks’ api_key setting

Vector’s 0.29.0 release includes deprecations:

  1. The logdna sink has been renamed to mezmo
  2. The socket source tcp and unix mode setting max_length has been deprecated

We cover them below to help you upgrade quickly:

Upgrade guide

Breaking changes

Removal of the datadog_logs and datadog_metrics sinks’ api_key setting

The api_key option has been hidden on the documentation for the datadog_logs and datadog_metrics sinks for a few releases now, with the documented name for that setting being default_api_key.

In v0.28.0, the api_key was communicated as deprecated and as part of the deprecation policy, is fully removed in this release.

Any usages of api_key setting in these sinks will no longer work and they will need to be instead defined as default_api_key.

Deprecation notices

The logdna sink has been renamed to mezmo

Following LogDNA’s re-branding to Mezmo, the logdna sink has been renamed to mezmo. The old name logdna has been deprecated and will be removed in a future release. Please update your configurations accordingly.

-type = "logdna"
+type = "mezmo"

The socket source tcp and unix mode setting max_length has been deprecated

The socket source modes tcp and unix have had a max_length setting which is meant to be replaced by the max_length setting within the framing setting. The max_length setting will be removed from these modes in a future release. Please replace any explicit usages of max_length with a framing setting in your configurations.