diff --git a/site2/docs/reference-metrics.md b/site2/docs/reference-metrics.md
index ef15eabeec4dc..81a46671365e5 100644
--- a/site2/docs/reference-metrics.md
+++ b/site2/docs/reference-metrics.md
@@ -200,20 +200,19 @@ All the topic metrics are labelled with the following labels:
 | pulsar_subscription_delayed | Gauge | The total message batches (entries) are delayed for dispatching. |
 | pulsar_storage_write_latency_le_* | Histogram | The entry rate of a topic that the storage write latency is smaller with a given threshold.<br> Available thresholds: <br><ul><li>pulsar_storage_write_latency_le_0_5: <= 0.5ms </li><li>pulsar_storage_write_latency_le_1: <= 1ms</li><li>pulsar_storage_write_latency_le_5: <= 5ms</li><li>pulsar_storage_write_latency_le_10: <= 10ms</li><li>pulsar_storage_write_latency_le_20: <= 20ms</li><li>pulsar_storage_write_latency_le_50: <= 50ms</li><li>pulsar_storage_write_latency_le_100: <= 100ms</li><li>pulsar_storage_write_latency_le_200: <= 200ms</li><li>pulsar_storage_write_latency_le_1000: <= 1s</li><li>pulsar_storage_write_latency_le_overflow: > 1s</li></ul> |
 | pulsar_entry_size_le_* | Histogram | The entry rate of a topic that the entry size is smaller with a given threshold.<br> Available thresholds: <br><ul><li>pulsar_entry_size_le_128: <= 128 bytes </li><li>pulsar_entry_size_le_512: <= 512 bytes</li><li>pulsar_entry_size_le_1_kb: <= 1 KB</li><li>pulsar_entry_size_le_2_kb: <= 2 KB</li><li>pulsar_entry_size_le_4_kb: <= 4 KB</li><li>pulsar_entry_size_le_16_kb: <= 16 KB</li><li>pulsar_entry_size_le_100_kb: <= 100 KB</li><li>pulsar_entry_size_le_1_mb: <= 1 MB</li><li>pulsar_entry_size_le_overflow: > 1 MB</li></ul> |
-| pulsar_in_bytes_total | Counter | The total number of bytes received for this topic |
-| pulsar_in_messages_total | Counter | The total number of messages received for this topic |
-| pulsar_out_bytes_total | Counter | The total number of bytes read from this topic |
-| pulsar_out_messages_total | Counter | The total number of messages read from this topic |
-| pulsar_compaction_removed_event_count | Gauge | The removed event count of compaction |
-| pulsar_compaction_succeed_count | Gauge | The succeed count of compaction |
-| pulsar_compaction_failed_count | Gauge | The failed count of compaction |
-| pulsar_compaction_duration_time_in_mills | Gauge | The duration time of compaction |
-| pulsar_compaction_read_throughput | Gauge | The read throughput of compaction |
-| pulsar_compaction_write_throughput | Gauge | The write throughput of compaction |
+| pulsar_in_bytes_total | Counter | The total number of messages in bytes received for this topic. |
+| pulsar_in_messages_total | Counter | The total number of messages received for this topic. |
+| pulsar_out_bytes_total | Counter | The total number of messages in bytes read from this topic. |
+| pulsar_out_messages_total | Counter | The total number of messages read from this topic. |
+| pulsar_compaction_removed_event_count | Gauge | The total number of removed events of the compaction. |
+| pulsar_compaction_succeed_count | Gauge | The total number of successes of the compaction. |
+| pulsar_compaction_failed_count | Gauge | The total number of failures of the compaction. |
+| pulsar_compaction_duration_time_in_mills | Gauge | The duration time of the compaction. |
+| pulsar_compaction_read_throughput | Gauge | The read throughput of the compaction. |
+| pulsar_compaction_write_throughput | Gauge | The write throughput of the compaction. |
 | pulsar_compaction_latency_le_* | Histogram | The compaction latency with given quantile. <br> Available thresholds: <br><ul><li>pulsar_compaction_latency_le_0_5: <= 0.5ms </li><li>pulsar_compaction_latency_le_1: <= 1ms</li><li>pulsar_compaction_latency_le_5: <= 5ms</li><li>pulsar_compaction_latency_le_10: <= 10ms</li><li>pulsar_compaction_latency_le_20: <= 20ms</li><li>pulsar_compaction_latency_le_50: <= 50ms</li><li>pulsar_compaction_latency_le_100: <= 100ms</li><li>pulsar_compaction_latency_le_200: <= 200ms</li><li>pulsar_compaction_latency_le_1000: <= 1s</li><li>pulsar_compaction_latency_le_overflow: > 1s</li></ul> |
-| pulsar_compaction_compacted_entries_count | Gauge | The compacted entries count |
-| pulsar_compaction_compacted_entries_size |Gauge  | The compacted entries size |
-
+| pulsar_compaction_compacted_entries_count | Gauge | The total number of the compacted entries. |
+| pulsar_compaction_compacted_entries_size |Gauge  | The total size of the compacted entries. |
 
 #### Replication metrics
 
diff --git a/site2/website/versioned_docs/version-2.8.2/reference-metrics.md b/site2/website/versioned_docs/version-2.8.2/reference-metrics.md
index a56092b4d653b..278c20f37b846 100644
--- a/site2/website/versioned_docs/version-2.8.2/reference-metrics.md
+++ b/site2/website/versioned_docs/version-2.8.2/reference-metrics.md
@@ -198,10 +198,19 @@ All the topic metrics are labelled with the following labels:
 | pulsar_subscription_delayed | Gauge | The total message batches (entries) are delayed for dispatching. |
 | pulsar_storage_write_latency_le_* | Histogram | The entry rate of a topic that the storage write latency is smaller with a given threshold.<br> Available thresholds: <br><ul><li>pulsar_storage_write_latency_le_0_5: <= 0.5ms </li><li>pulsar_storage_write_latency_le_1: <= 1ms</li><li>pulsar_storage_write_latency_le_5: <= 5ms</li><li>pulsar_storage_write_latency_le_10: <= 10ms</li><li>pulsar_storage_write_latency_le_20: <= 20ms</li><li>pulsar_storage_write_latency_le_50: <= 50ms</li><li>pulsar_storage_write_latency_le_100: <= 100ms</li><li>pulsar_storage_write_latency_le_200: <= 200ms</li><li>pulsar_storage_write_latency_le_1000: <= 1s</li><li>pulsar_storage_write_latency_le_overflow: > 1s</li></ul> |
 | pulsar_entry_size_le_* | Histogram | The entry rate of a topic that the entry size is smaller with a given threshold.<br> Available thresholds: <br><ul><li>pulsar_entry_size_le_128: <= 128 bytes </li><li>pulsar_entry_size_le_512: <= 512 bytes</li><li>pulsar_entry_size_le_1_kb: <= 1 KB</li><li>pulsar_entry_size_le_2_kb: <= 2 KB</li><li>pulsar_entry_size_le_4_kb: <= 4 KB</li><li>pulsar_entry_size_le_16_kb: <= 16 KB</li><li>pulsar_entry_size_le_100_kb: <= 100 KB</li><li>pulsar_entry_size_le_1_mb: <= 1 MB</li><li>pulsar_entry_size_le_overflow: > 1 MB</li></ul> |
-| pulsar_in_bytes_total | Counter | The total number of bytes received for this topic |
-| pulsar_in_messages_total | Counter | The total number of messages received for this topic |
-| pulsar_out_bytes_total | Counter | The total number of bytes read from this topic |
-| pulsar_out_messages_total | Counter | The total number of messages read from this topic |
+| pulsar_in_bytes_total | Counter | The total number of messages in bytes received for this topic. |
+| pulsar_in_messages_total | Counter | The total number of messages received for this topic. |
+| pulsar_out_bytes_total | Counter | The total number of messages in bytes read from this topic. |
+| pulsar_out_messages_total | Counter | The total number of messages read from this topic. |
+| pulsar_compaction_removed_event_count | Gauge | The total number of removed events of the compaction. |
+| pulsar_compaction_succeed_count | Gauge | The total number of successes of the compaction. |
+| pulsar_compaction_failed_count | Gauge | The total number of failures of the compaction. |
+| pulsar_compaction_duration_time_in_mills | Gauge | The duration time of the compaction. |
+| pulsar_compaction_read_throughput | Gauge | The read throughput of the compaction. |
+| pulsar_compaction_write_throughput | Gauge | The write throughput of the compaction. |
+| pulsar_compaction_latency_le_* | Histogram | The compaction latency with given quantile. <br> Available thresholds: <br><ul><li>pulsar_compaction_latency_le_0_5: <= 0.5ms </li><li>pulsar_compaction_latency_le_1: <= 1ms</li><li>pulsar_compaction_latency_le_5: <= 5ms</li><li>pulsar_compaction_latency_le_10: <= 10ms</li><li>pulsar_compaction_latency_le_20: <= 20ms</li><li>pulsar_compaction_latency_le_50: <= 50ms</li><li>pulsar_compaction_latency_le_100: <= 100ms</li><li>pulsar_compaction_latency_le_200: <= 200ms</li><li>pulsar_compaction_latency_le_1000: <= 1s</li><li>pulsar_compaction_latency_le_overflow: > 1s</li></ul> |
+| pulsar_compaction_compacted_entries_count | Gauge | The total number of the compacted entries. |
+| pulsar_compaction_compacted_entries_size |Gauge  | The total size of the compacted entries. |
 
 #### Replication metrics