0.61 Upgrade Guide

An upgrade guide that addresses breaking changes in 0.61.0

Scheme-less vector sink endpoints default to https

Summary

address and routing.endpoints values in the vector sink that omit the scheme (for example, 127.0.0.1:6000 instead of http://127.0.0.1:6000) now default to https. Previously they defaulted to http unless TLS was enabled. The http default was deprecated in 0.59.0.

Endpoints that already specify a scheme, and scheme-less endpoints in configurations that enable TLS, are unaffected. A scheme-less endpoint pointing at a plaintext vector source now fails the TLS handshake.

Migration

Where possible, enable TLS on the receiving vector source and connect using https://, which is now the default when the scheme is omitted. See the source’s TLS configuration.

To retain plaintext connections, specify http:// explicitly. Setting tls.enabled: false alone does not restore the previous http default. For example:

Old

sinks:
  my_sink:
    type: vector
    inputs: [in]
    routing:
      endpoints: ["127.0.0.1:6000", "127.0.0.1:6001"]

New

sinks:
  my_sink:
    type: vector
    inputs: [in]
    routing:
      endpoints: ["http://127.0.0.1:6000", "http://127.0.0.1:6001"]

The same applies to address, for example, address: http://127.0.0.1:6000.