From 8d6910d46763450bc35791595e5bd92909df485f Mon Sep 17 00:00:00 2001
From: Juha Mynttinen <juha.mynttinen@aiven.io>
Date: Wed, 20 Dec 2023 08:01:54 +0200
Subject: [PATCH] Clarify Add Kafka producer and consumer Datadog metrics

First, remove the false claim that kafka.producer.* and kafka.consumer.* metrics are client side. Some broker-side metrics also have the prefix.

Change the topic to clearly state the page is about client-side metrics.
---
 .../kafka/howto/add-missing-producer-consumer-metrics.rst | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/docs/products/kafka/howto/add-missing-producer-consumer-metrics.rst b/docs/products/kafka/howto/add-missing-producer-consumer-metrics.rst
index 5f19b9af76..4da1eda696 100644
--- a/docs/products/kafka/howto/add-missing-producer-consumer-metrics.rst
+++ b/docs/products/kafka/howto/add-missing-producer-consumer-metrics.rst
@@ -1,8 +1,6 @@
-Add ``kafka.producer.`` and ``kafka.consumer`` Datadog metrics
-==============================================================
+Add client-side Apache Kafka® producer and consumer Datadog metrics
+===================================================================
 
 When you enable the :doc:`Datadog integration </docs/integrations/datadog/datadog-metrics>` in Aiven for Apache Kafka®, the service supports all of the broker-side metrics listed in the `Datadog Kafka integration documentation <https://docs.datadoghq.com/integrations/kafka/?tab=host#data-collected>`_ and allows you to send additional :doc:`custom metrics <datadog-customised-metrics>`.
 
-However, all metrics that have a prefix like ``kafka.producer.*`` or ``kafka.consumer.*`` are client-side metrics that should be collected from the producer or consumer, and sent to Datadog.
-
-The dedicated `Datadog documentation <https://docs.datadoghq.com/integrations/faq/troubleshooting-and-deep-dive-for-kafka>`_ (see "Missing producer and consumer metrics" chapter) provides a way to include the missing metrics natively for Java based producers and consumers or via `DogStatsD <https://docs.datadoghq.com/developers/dogstatsd/>`_ for clients in other languages.
+Additionally, you can collect client-side metrics directly from the producer or consumer and send them to Datadog. For guidance, refer to the *Missing producer and consumer metrics* section in the `Datadog documentation <https://docs.datadoghq.com/integrations/faq/troubleshooting-and-deep-dive-for-kafka>`_, which outlines the process for integrating missing metrics natively for Java-based producers and consumers. For clients using languages other than Java, incorporating these metrics can be achieved through `DogStatsD <https://docs.datadoghq.com/developers/dogstatsd/>`_.