Extend the topic setting description for the Kafka output

Author: vishaangelova

reference/fleet/kafka-output-settings.md

@@ -131,14 +131,27 @@ Use this option to set the Kafka topic for each {{agent}} event.
 
     You can set a static topic, for example `elastic-agent`, or you can choose to set a topic dynamically based on an [Elastic Common Schema (ECS)](ecs://reference/index.md) field. Available fields include:
 
-    * `data_stream_type`
+    * `data_stream.type`
     * `data_stream.dataset`
     * `data_stream.namespace`
     * `@timestamp`
     * `event-dataset`
 
-    You can also set a custom field. This is useful if you’re using the [`add_fields` processor](/reference/fleet/add_fields-processor.md) as part of your {{agent}} input. Otherwise, setting a custom field is not recommended.
+    You can also set a custom field. This is useful if you need to construct a more complex or structured topic name.
+    
+    To set a dynamic topic value for outputting {{agent}} data to Kafka, you can add the [`add_fields` processor](/reference/fleet/add_fields-processor.md) to any integration policies on your Fleet-managed {{agents}}.
+    
+    For example, the following processor creates a dynamic topic value by interpolating multiple [data stream fields](ecs://reference/ecs-data_stream.md):
 
+    ```yaml
+    - add_fields:
+      target: ''
+      fields: 
+        kafka_topic: '${data_stream.type}-${data_stream.dataset}-${data_stream.namespace}' <1>
+    ```
+    1. Depending on the values of the data stream fields, this generates topic names such as `logs-system.auth-production` or `metrics-nginx-default` as the value of the custom `kafka_topic` field.
+
+    For more information, refer to [](/reference/fleet/agent-processors.md).
 
 ### Header settings [_header_settings]
 

reference/fleet/kafka-output.md

@@ -69,10 +69,10 @@ inputs {
 
 The `kafka` output supports the following settings, grouped by category. Many of these settings have sensible defaults that allow you to run {{agent}} with minimal configuration.
 
-* [Kafka output configuration settings](#output-kafka-commonly-used-settings)
+* [Commonly used settings](#output-kafka-commonly-used-settings)
 * [Authentication settings](#output-kafka-authentication-settings)
 * [Memory queue settings](#output-kafka-memory-queue-settings)
-* [Topics settings](#output-kafka-topics-settings)
+* [Topic settings](#output-kafka-topic-settings)
 * [Partition settings](#output-kafka-partition-settings)
 * [Header settings](#output-kafka-header-settings)
 * [Other configuration settings](#output-kafka-configuration-settings)
@@ -157,12 +157,36 @@ This sample configuration forwards events to the output when there are enough ev
     **Default:** `10s`
 
 
-## Topics settings [output-kafka-topics-settings]
+## Topic settings [output-kafka-topic-settings]
 
 Use these options to set the Kafka topic for each {{agent}} event.
 
 `topic` $$$kafka-topic-setting$$$
-:   The default Kafka topic used for produced events.
+:   Set a default topic to use for events sent by {{agent}} to the Kafka output.
+
+    You can set a static topic, for example `elastic-agent`, or you can choose to set a topic dynamically based on an [Elastic Common Schema (ECS)](ecs://reference/index.md) field. Available fields include:
+
+    * `data_stream.type`
+    * `data_stream.dataset`
+    * `data_stream.namespace`
+    * `@timestamp`
+    * `event-dataset`
+
+    You can also set a custom field. This is useful if you need to construct a more complex or structured topic name. 
+    
+    To set a dynamic topic value for outputting {{agent}} data to Kafka, you can add the [`add_fields` processor](/reference/fleet/add_fields-processor.md) to the input configuration settings of your standalone {{agent}}.
+    
+    For example, the following processor creates a dynamic topic value by interpolating multiple [data stream fields](ecs://reference/ecs-data_stream.md):
+
+    ```yaml
+    - add_fields:
+      target: ''
+      fields: 
+        kafka_topic: '${data_stream.type}-${data_stream.dataset}-${data_stream.namespace}' <1>
+    ```
+    1. Depending on the values of the data stream fields, this generates topic names such as `logs-system.auth-production` or `metrics-nginx-default` as the value of the custom `kafka_topic` field.
+
+    For more information, refer to [](/reference/fleet/agent-processors.md).
 
 
 ## Partition settings [output-kafka-partition-settings]