[4.8] Documents the keep-hostname pecularities for opentelemetry sources

content/chapter-parsers/opentelemetry/_index.md

@@ -40,4 +40,4 @@ The mapping of AnyValue type fields is limited.
 Available in {{< product >}} 4.8 and later.
 
 *Description:* If set to yes, the parser extracts the `host.name` attribute if available in the message. Otherwise, it leaves the [HOST](https://opentelemetry.io/docs/specs/semconv/attributes-registry/host/) field as-is.
-
+If you're receiving messages using the [`syslog-ng-otlp()` source]({{< relref "/chapter-sources/source-syslog-ng-otlp/_index.md" >}}), the `opentelemetry()` parser will return the original hostname regardless of the where the message originated (OTLP, syslog, and so on).

content/chapter-sources/opentelemetry/_index.md

@@ -37,6 +37,10 @@ log otel_forward_mode_alts {
 
 {{< include-headless "chunk/option-source-concurrent-requests.md" >}}
 
+## keep-hostname()
+
+The `opentelemetry()` source ignores this option and uses the address of the OTLP peer as the HOST.
+
 {{% include-headless "chunk/option-source-log-fetch-limit.md" %}}
 
 ## `port()` {#port}

content/chapter-sources/source-syslog-ng-otlp/_index.md

@@ -65,7 +65,9 @@ The `syslog-ng-otlp()` source has the following options.
 
 {{< include-headless "chunk/option-source-host-override.md" >}}
 
-{{< include-headless "chunk/option-source-keep-hostname.md" >}}
+## keep-hostname()
+
+The `syslog-ng-otlp()` source ignores this option and uses the hostname from the message as the `${HOST}`.
 
 {{< include-headless "chunk/option-source-keep-timestamp.md" >}}
 

content/whats-new/_index.md

@@ -12,6 +12,7 @@ This page is a changelog that collects the major changes and additions to this d
 - You can send messages and metrics to [Elasticsearch data streams](https://www.elastic.co/guide/en/elasticsearch/reference/current/data-streams.html) to store your log and metrics data as time series data using the [`elasticsearch-datastream()`]({{< relref "/chapter-destinations/elasticsearch-data-stream/_index.md" >}}) destination driver.
 - You can use the [`server-side-encryption()`]({{< relref "/chapter-destinations/destination-s3/_index.md#server-side-encryption" >}}) and [`kms-key()`]({{< relref "/chapter-destinations/destination-s3/_index.md#kms-key" >}}) options to configure encryption for [Amazon S3 destinations]({{< relref "/chapter-destinations/destination-s3/_index.md" >}}).
 - You can now set static gRPC headers in the [`bigquery()`]({{< relref "/chapter-destinations/google-bigquery/_index.md#headers" >}}), [`loki()`]({{< relref "/chapter-destinations/destination-loki/_index.md#headers" >}}), and the [`opentelemetry()`]({{< relref "/chapter-destinations/opentelemetry/_index.md#headers" >}}) destinations.
+- The `opentelemetry()` parser has a new [`set-hostname()`]({{< relref "/chapter-parsers/opentelemetry/_index.md#set-hostname" >}}) option.
 
 ## Version 4.7 release (2024-04-18)