chore(releasing): Prepare v0.40.0 release

Signed-off-by: Jesse Szwedko <[email protected]>
vectordotdev · Jul 29, 2024 · 1167aa9 · 1167aa9
1 parent e89661c
commit 1167aa9
Show file tree

Hide file tree

Showing 25 changed files with 571 additions and 178 deletions.
diff --git a/changelog.d/17125_proxy_auth_url_encoded.fix.md b/changelog.d/17125_proxy_auth_url_encoded.fix.md
diff --git a/changelog.d/18669_csv_documentation_u8_display.fix.md b/changelog.d/18669_csv_documentation_u8_display.fix.md
diff --git a/changelog.d/19614_gcp_token_regeneration.enhancement.md b/changelog.d/19614_gcp_token_regeneration.enhancement.md
diff --git a/changelog.d/19637_influxdb_line_protocol_decoder.enhancement.md b/changelog.d/19637_influxdb_line_protocol_decoder.enhancement.md
diff --git a/changelog.d/20017_make_sqs_timeout_settings_configurable.enhancement.md b/changelog.d/20017_make_sqs_timeout_settings_configurable.enhancement.md
diff --git a/changelog.d/20575_kinesis_batching.fix.md b/changelog.d/20575_kinesis_batching.fix.md
diff --git a/changelog.d/20595-statsd_source_key_sanitization.enhancement.md b/changelog.d/20595-statsd_source_key_sanitization.enhancement.md
diff --git a/changelog.d/20687-kafka_source_validate_deadlock.fix.md b/changelog.d/20687-kafka_source_validate_deadlock.fix.md
diff --git a/changelog.d/20732_datadog_agent_zstd.enhancement.md b/changelog.d/20732_datadog_agent_zstd.enhancement.md
diff --git a/changelog.d/20763_loki_sink_drop_invalid_timestamp_event.fix.md b/changelog.d/20763_loki_sink_drop_invalid_timestamp_event.fix.md
diff --git a/changelog.d/20768-default_gelf_stream_framing.breaking.md b/changelog.d/20768-default_gelf_stream_framing.breaking.md
diff --git a/changelog.d/20800_reduce_nested_fields.breaking.md b/changelog.d/20800_reduce_nested_fields.breaking.md
diff --git a/changelog.d/20834_nats_jetstream_sink.feature.md b/changelog.d/20834_nats_jetstream_sink.feature.md
diff --git a/changelog.d/20891_disallow_zero_for_sink_retry_params.fix.md b/changelog.d/20891_disallow_zero_for_sink_retry_params.fix.md
diff --git a/changelog.d/demo_logs_host.enhancement.md b/changelog.d/demo_logs_host.enhancement.md
diff --git a/changelog.d/template-semantic-timestamp.fix.md b/changelog.d/template-semantic-timestamp.fix.md
diff --git a/changelog.d/update-x86-64-cross-base.breaking.md b/changelog.d/update-x86-64-cross-base.breaking.md
diff --git a/changelog.d/vector_tap_duration_flag.enhancement.md b/changelog.d/vector_tap_duration_flag.enhancement.md
diff --git a/changelog.d/vrl-secrets-impure.fix.md b/changelog.d/vrl-secrets-impure.fix.md
diff --git a/distribution/install.sh b/distribution/install.sh
@@ -13,7 +13,7 @@ set -u
 # If PACKAGE_ROOT is unset or empty, default it.
 PACKAGE_ROOT="${PACKAGE_ROOT:-"https://packages.timber.io/vector"}"
 # If VECTOR_VERSION is unset or empty, default it.
-VECTOR_VERSION="${VECTOR_VERSION:-"0.39.0"}"
+VECTOR_VERSION="${VECTOR_VERSION:-"0.40.0"}"
 _divider="--------------------------------------------------------------------------------"
 _prompt=">>>"
 _indent="   "

diff --git a/website/content/en/highlights/2024-07-29-0-40-0-upgrade-guide.md b/website/content/en/highlights/2024-07-29-0-40-0-upgrade-guide.md
@@ -0,0 +1,166 @@
+---
+date: "2024-07-29"
+title: "0.40 Upgrade Guide"
+description: "An upgrade guide that addresses breaking changes in 0.40.0"
+authors: ["jszwedko"]
+release: "0.40.0"
+hide_on_release_notes: false
+badges:
+  type: breaking change
+---
+
+Vector's 0.40.0 release includes three **breaking changes**:
+
+1. [GELF codec defaults to null-delimited messages for stream-based sources](#gelf)
+1. [Reduce transforms now properly aggregate nested fields](#reduce-aggregate)
+1. [Vector no longer supports CentOS 7](#centos7)
+
+We cover them below to help you upgrade quickly:
+
+## Upgrade guide
+
+### Breaking Change
+
+#### GELF codec defaults to null-delimited messages for stream-based sources {#gelf}
+
+The GELF codec with stream-based sources now uses null byte (`\\0`) by default as messages delimiter
+instead of newline (`\\n`) character. This better matches GELF server behavior.
+
+##### Configuration changes
+
+In order to maintain the previous behavior, you must set the `framing.method` option to the
+`character_delimited` method and the `framing.character_delimited.delimiter` option to `\\n` when
+using GELF codec with stream-based sources.
+
+##### Example configuration change for socket source
+
+###### Previous
+
+```yaml
+sources:
+  my_source_id:
+    type: "socket"
+    address: "0.0.0.0:9000"
+    mode: "tcp"
+    decoding:
+      codec: "gelf"
+```
+
+###### Current
+
+```yaml
+sources:
+  my_source_id:
+    type: "socket"
+    address: "0.0.0.0:9000"
+    mode: "tcp"
+    decoding:
+      codec: "gelf"
+    framing:
+      method: "character_delimited"
+    character_delimited:
+      delimiter: "\n"
+```
+
+#### Reduce transforms now properly aggregate nested fields {#reduce-aggregate}
+
+Reduce transforms can now properly aggregate nested fields.
+
+This is a breaking change because previously, merging object elements used the "discard" strategy.
+The new behavior is to use the default strategy based on the element type.
+
+##### Example
+
+###### Config
+
+```toml
+group_by = [ "id" ]
+merge_strategies.id = "discard"
+merge_strategies."a.b[0]" = "array"
+```
+
+###### Event 1
+
+```json
+{
+  "id": 777,
+  "an_array": [
+    {
+      "inner": 1
+    }
+  ],
+  "message": {
+    "a": {
+      "b": [1, 2],
+      "num": 1
+    }
+  }
+}
+```
+
+###### Event 2
+
+```json
+{
+  "id": 777,
+  "an_array": [
+    {
+      "inner": 2
+    }
+  ],
+  "message": {
+    "a": {
+      "b": [3, 4],
+      "num": 2
+    }
+  }
+}
+```
+
+###### Reduced Event
+
+Old behavior:
+
+```json
+{
+  "id": 777,
+  "an_array": [
+    {
+      "inner": 2
+    }
+  ],
+  "message": {
+    "a": {
+      "b": [1, 2],
+      "num": 1
+    }
+  }
+}
+```
+
+New behavior:
+
+```json
+{
+  "id": 777,
+  "an_array": [
+    {
+      "inner": 1
+    }
+  ],
+  "message": {
+    "a": {
+      "b": [
+        [1, 2],
+        [3,4]
+      ],
+      "num": 3
+    }
+  }
+}
+```
+
+#### Vector no longer supports CentOS 7 {#centos7}
+
+With this release, Vector has dropped support for CentOS 7 because CentOS 7 became EOL on June 30th,
+2024.
diff --git a/website/content/en/releases/0.40.0.md b/website/content/en/releases/0.40.0.md
@@ -0,0 +1,4 @@
+---
+title: Vector v0.40.0 release notes
+weight: 21
+---
diff --git a/website/cue/reference/administration/interfaces/kubectl.cue b/website/cue/reference/administration/interfaces/kubectl.cue
@@ -19,7 +19,7 @@ administration: interfaces: kubectl: {
 	role_implementations: [Name=string]: {
 		commands: {
 			_deployment_variant:       string
-			_vector_version:           "0.39"
+			_vector_version:           "0.40"
 			_namespace:                string | *"vector"
 			_controller_resource_type: string
 			_controller_resource_name: string | *_deployment_variant