0.32 Upgrade Guide

An upgrade guide that addresses breaking changes in 0.32.0

Page source Edit this page

Vector’s 0.32.0 release includes deprecations:

  1. VRL to_timestamp function
  2. Deprecation of legacy OpenSSL providers

and potentially impactful changes:

  1. Upgrade of OpenSSL from 1.1.1 to 3.1.2

We cover them below to help you upgrade quickly:

Upgrade guide

Deprecations

VRL to_timestamp function

The to_timestamp function in VRL was deprecated. Instead, the following functions should be used:

  • parse_timestamp to parse string timestamps
  • from_unix_timestamp to parse integer timestamps

This removes some confusion that existed around “magic formats” that the to_timestamp had by requiring string timestamp formats to be specified explicitly.

Deprecation of legacy OpenSSL providers

With the upgrade to OpenSSL 3.1.2, the legacy algorithm provider was deprecated. The default will be switched in a future version to default provider. You can opt into this behavior now by setting the environment variable VECTOR_OPENSSL_LEGACY_PROVIDER=false.

Potentially impactful changes

Upgrade of OpenSSL from 1.1.1 to 3.1.2

As part of moving off of OpenSSL 1.1.1 before it becomes end-of-life in September, Vector has upgraded the version that it statically compiles in to 3.1.2. We don’t anticipate any end-user impact from this change to users of Vector, but please let us know if you see any breakages resulting from this upgrade.