From 000644e5d5bdce0c23902aa4ed83b7d6a5d702bb Mon Sep 17 00:00:00 2001
From: Dragos Misca <dragosvictor@users.noreply.github.com>
Date: Tue, 29 Oct 2024 04:39:47 -0700
Subject: [PATCH] [feat][doc] PIP-264: Add replication subscription metrics
 reference (#941)

* [feat][doc] PIP-264: Add replication subscription metrics reference

* Apply to 4.0.x

---------

Co-authored-by: Lari Hotari <lhotari@users.noreply.github.com>
---
 docs/reference-metrics-opentelemetry.md          | 16 ++++++++++++++++
 .../reference-metrics-opentelemetry.md           | 16 ++++++++++++++++
 2 files changed, 32 insertions(+)

diff --git a/docs/reference-metrics-opentelemetry.md b/docs/reference-metrics-opentelemetry.md
index 524cea21358c..74950473d9f4 100644
--- a/docs/reference-metrics-opentelemetry.md
+++ b/docs/reference-metrics-opentelemetry.md
@@ -1081,3 +1081,19 @@ The total number of expired tokens.
 The remaining time of expiring token in seconds.
 * Type: Histogram
 * Unit: `s`
+
+### Replication Subscription Metrics
+
+#### pulsar.broker.replication.subscription.snapshot.operation.count
+The number of snapshot operations attempted.
+* Type: Counter
+* Unit: `{operation}`
+
+#### pulsar.broker.replication.subscription.snapshot.operation.duration
+Time taken to complete a consistent snapshot operation across clusters.
+* Type: Histogram
+* Unit: `s`
+* Attributes:
+  * `pulsar.replication.subscription.snapshot.operation.result` - The result of the snapshot operation. Can be one of:
+    * `success`
+    * `timeout`
diff --git a/versioned_docs/version-4.0.x/reference-metrics-opentelemetry.md b/versioned_docs/version-4.0.x/reference-metrics-opentelemetry.md
index 524cea21358c..74950473d9f4 100644
--- a/versioned_docs/version-4.0.x/reference-metrics-opentelemetry.md
+++ b/versioned_docs/version-4.0.x/reference-metrics-opentelemetry.md
@@ -1081,3 +1081,19 @@ The total number of expired tokens.
 The remaining time of expiring token in seconds.
 * Type: Histogram
 * Unit: `s`
+
+### Replication Subscription Metrics
+
+#### pulsar.broker.replication.subscription.snapshot.operation.count
+The number of snapshot operations attempted.
+* Type: Counter
+* Unit: `{operation}`
+
+#### pulsar.broker.replication.subscription.snapshot.operation.duration
+Time taken to complete a consistent snapshot operation across clusters.
+* Type: Histogram
+* Unit: `s`
+* Attributes:
+  * `pulsar.replication.subscription.snapshot.operation.result` - The result of the snapshot operation. Can be one of:
+    * `success`
+    * `timeout`