From df3da3f0556daebdbf24eacc6109572535452a59 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..f5d44bc080 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 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, metrics client-side metrics can be collected from the producer or consumer itself, 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.