Back to Vector

0.32 Upgrade Guide

website/content/en/highlights/2023-08-15-0-32-0-upgrade-guide.md

0.55.01.8 KB
Original Source

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 {#deprecated-to-timestamp}

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 {#legacy-openssl}

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 {#openssl-upgrade}

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.