From 269b457d30940e51f532d6a1b616b9506f87232f Mon Sep 17 00:00:00 2001
From: Igor Soarez <soarez@apple.com>
Date: Tue, 16 Apr 2024 15:20:52 +0100
Subject: [PATCH] MINOR: Add missing docs for migration metrics (#15718)

Reviewers: Mickael Maison <mickael.maison@gmail.com>
---
 docs/ops.html | 20 +++++++++++++++++++-
 1 file changed, 19 insertions(+), 1 deletion(-)

diff --git a/docs/ops.html b/docs/ops.html
index fc8ae78740d..c3abea5e014 100644
--- a/docs/ops.html
+++ b/docs/ops.html
@@ -2113,6 +2113,24 @@ These metrics are reported on both Controllers and Brokers in a KRaft Cluster
     <td>The number of active brokers as observed by this Controller.</td>
     <td>kafka.controller:type=KafkaController,name=ActiveBrokerCount</td>
   </tr>
+  <tr>
+    <td>Migrating ZK Broker Count</td>
+    <td>The number of brokers registered with the Controller that haven't yet migrated to KRaft mode.</td>
+    <td>kafka.controller:type=KafkaController,name=MigratingZkBrokerCount</td>
+  </tr>
+  <tr>
+    <td>ZK Migrating State</td>
+    <td>
+      <ul style="list-style: none; padding-left: 0; margin: 0;">
+        <li>0 - NONE, cluster created in KRaft mode;</li>
+        <li>4 - ZK, Migration has not started, controller is a ZK controller;</li>
+        <li>2 - PRE_MIGRATION, the KRaft Controller is waiting for all ZK brokers to register in migration mode;</li>
+        <li>1 - MIGRATION, ZK metadata has been migrated, but some broker is still running in ZK mode;</li>
+        <li>3 - POST_MIGRATION, the cluster migration is complete;</li>
+      </ul>
+    </td>
+    <td>kafka.controller:type=KafkaController,name=ZkMigrationState</td>
+  </tr>
   <tr>
     <td>Global Topic Count</td>
     <td>The number of global topics as observed by this Controller.</td>
@@ -2126,7 +2144,7 @@ These metrics are reported on both Controllers and Brokers in a KRaft Cluster
   <tr>
     <td>Offline Partition Count</td>
     <td>The number of offline topic partitions (non-internal) as observed by this Controller.</td>
-    <td>kafka.controller:type=KafkaController,name=OfflinePartitionCount</td>
+    <td>kafka.controller:type=KafkaController,name=OfflinePartitionsCount</td>
   </tr>
   <tr>
     <td>Preferred Replica Imbalance Count</td>