Project: Vector (Observability and Analysis / Observability)
File: 2023-11-07-0-34-0-upgrade-guide.md

date: "2023-11-07" title: "0.34 Upgrade Guide" description: "An upgrade guide that addresses breaking changes in 0.34.0" authors: ["dsmith3197"] release: "0.34.0" hideonrelease_notes: false badges: type: breaking change Vector's 0.34.0 release includes breaking changes: and deprecations: We cover them below to help you upgrade quickly: The `region` config option has been removed from the Datadog Events, Logs, and Metrics sinks. Instead the `site` option should be used. The `region` and `application_key` config options have been removed from the Enterprise configuration. Instead of `region`, `site` should be used. `application_key` is no longer required. The deprecated `component_name` tag has been removed from all internal metrics. Instead, the `component_id` tag should be used. The following deprecated internal metrics have been removed. The `componenterrorstotal` metric should be used

| Metric Name | Components | |--|-| | parseerrorstotal | apache metrics, dnstap, eventstoredb, http server, mongodb, nginx, prometheus | | httprequesterrors_total | apache metrics, aws ecs metrics, eventstoredb, http client, nginx, splunk hec | | httperrorresponse_total | aws ecs metrics, http client | | requestreaderrors_total | aws kinesis firehose, heroku logplex | | requestautomaticdecodeerrorstotal | aws kinesis firehose | | sqsmessageprocessingfailedtotal | aws sqs | | sqsmessagedeletefailedtotal | aws sqs | | sqsmessagedeletebatchfailed_total | aws sqs | | sqsmessagereceivefailedtotal | aws sqs | | sqsmessagedeletefailedtotal | aws sqs | | decoderframingerrors_total | codecs | | decoderdeserializeerrors_total | codecs | | encoderframingerrors_total | codecs | | encoderserializeerrors_total | codecs | | communicationerrorstotal | docker | | timestampparseerrors_total | docker | | loggingdrivererrors_total | docker | | fingerprintreaderrors_total | file | | filedeleteerrors_total | file | | filewatcherrors_total | file | | checkpointwriteerrors_total | file | | globerrorstotal | file | | decodeerrorstotal | file | | httpbadrequests_total | http server | | invalidrecordtotal | journald | | invalidrecordbytes_total | journald | | consumeroffsetupdatesfailedtotal | kafka | | kafkaheaderextractionfailurestotal | kafka | | k8seventannotationfailurestotal | k8s | | requestsreceivedtotal | heroku logplex | | requesterrorstotal | mongodb, postgresql | | reloaderrorstotal | reload | | configloaderrors_total | reload | | recovererrorstotal | reload | | encodeerrorstotal | sematext | | connectionerrorstotal | socket, tcp, unix | | connectionfailedtotal | tcp, udp, unix | | connectionsendackerrorstotal | tcp | | windowsservicedoesnotexist_total | windows | The `peeraddr` tag has been removed from the `componentreceivedbytestotal` internal metric for TCP-based sources due to its unbounded cardinality. The `blackhole` sink no longer reports events processed every second by default. Instead this behavior can be opted into by setting `printintervalsecs` to `1` (or any other integer). This change was made due to users being surprised that this sink generates output by default. In this release, we drop support for enabling the OpenSSL legacy provider via `--openssl-legacy-provider` (and its environment variable: `VECTOROPENSSLLEGACY_PROVIDER`). This flag was deprecated in v0.33.0. The legacy OpenSSL provider (and other providers than the default provider) can still be enabled if desired through The deprecated name of the `armv7` RPM package, `vector-<version>-1.armv7.rpm`, is no longer published. Instead, it is published as `vector-<version>-1.armv7hl.rpm` to better follow RPM guidelines. If you are using `yum` to install the RPM, this change should be transparent. The default config location is now `/etc/vector/vector.yaml` rather than `/etc/vector/vector.toml`. This is part of the migration to YAML as Vector's preferred configuration language (though TOML and JSON will still be supported for the forseeable future). If you need Vector to load `/etc/vector/vector.toml` you must now specify `--config /etc/vector/vector.toml` or `VECTOR_CONFIG=/etc/vector/vector.toml` See the associated for more details on the motivation for migrating from TOML to YAML as the default configuration language. The `requestscompletedtotal`, `requestdurationseconds`, and `requestsreceivedtotal` internal metrics are removed in the 0.35.0 release. | Deprecated metric | Replacement metric | Affected components | |--|-|| | requestscompletedtotal | httpclientresponses_total | apache metrics, aws ecs metrics, http client, prometheus remote write, prometheus scrape | | requestdurationseconds | httpclientresponserttseconds | apache metrics, aws ecs metrics, http client, prometheus remote write, prometheus scrape | | requestsreceivedtotal | httpserverrequestsreceivedtotal | aws kinesis firehose, heroku logplex, prometheus exporter, splunk hec | Starting with the `v0.34.0` release, we are starting our migration of OS package hosting from `repositories.timber.io` to `apt.vector.dev` and `yum.vector.dev`. This is the last point release that will be published to `repositories.timber.io` (any `v0.34.x` patch releases will still be published). The repositories at `repositories.timber.io` will be decommissioned on February 28th, Please see the for details about this change and instructions on how to migrate.