From 717122a71d08745f9f80e487b9e3a47c5618d5c1 Mon Sep 17 00:00:00 2001 From: Kris Zyp Date: Fri, 5 Dec 2025 08:37:33 -0700 Subject: [PATCH 1/3] Add replication-latency description --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index bc9e971..f4d4ba5 100644 --- a/README.md +++ b/README.md @@ -204,7 +204,7 @@ Metrics specific to Harper (all metrics are [Gauges](https://prometheus.io/docs/ | `cluster_connected_dbs` | Count of connected dbs by node. | | `cluster_disconnected_dbs` | Count of disconnected dbs by node. | | `replication_backlog` | Number of pending replication consumers by origin, database, & table (for NATS replication only). | -| `replication_backlog_time` | The difference in milliseconds between lastReceivedRemoteTime and lastReceivedLocalTime for each of the node's dbs (for Harper replication only). | +| `replication_backlog_time` | The difference in milliseconds between lastReceivedRemoteTime and lastReceivedLocalTime for each of the node's dbs (for Harper replication only). | | `replication_latency` | The difference in milliseconds between incoming transactions' timestamps (as record remotely) and the time when each transaction finished committing locally (for Harper replication only). | A complete sample response of `/metrics`: ```text From 6a0ace3e59bfe19f3b147434de177015734dbb51 Mon Sep 17 00:00:00 2001 From: Kris Zyp Date: Fri, 5 Dec 2025 13:39:46 -0700 Subject: [PATCH 2/3] Formatter starting working again --- README.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index f4d4ba5..0b25915 100644 --- a/README.md +++ b/README.md @@ -204,7 +204,8 @@ Metrics specific to Harper (all metrics are [Gauges](https://prometheus.io/docs/ | `cluster_connected_dbs` | Count of connected dbs by node. | | `cluster_disconnected_dbs` | Count of disconnected dbs by node. | | `replication_backlog` | Number of pending replication consumers by origin, database, & table (for NATS replication only). | -| `replication_backlog_time` | The difference in milliseconds between lastReceivedRemoteTime and lastReceivedLocalTime for each of the node's dbs (for Harper replication only). | | `replication_latency` | The difference in milliseconds between incoming transactions' timestamps (as record remotely) and the time when each transaction finished committing locally (for Harper replication only). | +| `replication_backlog_time` | The difference in milliseconds between lastReceivedRemoteTime and lastReceivedLocalTime for each of the node's dbs (for Harper replication only). | +| `replication_latency` | The difference in milliseconds between incoming transactions' timestamps (as recorded remotely) and the time when each transaction finished committing locally (for Harper replication only). | A complete sample response of `/metrics`: ```text From c7ecef77c0b9be4b47b69af75f88dcec00a710f1 Mon Sep 17 00:00:00 2001 From: Kris Zyp Date: Tue, 18 Aug 2026 06:18:31 -0600 Subject: [PATCH 3/3] Clarify replication latency metric Co-Authored-By: GPT-5 Codex --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 0b25915..2f7281b 100644 --- a/README.md +++ b/README.md @@ -205,7 +205,7 @@ Metrics specific to Harper (all metrics are [Gauges](https://prometheus.io/docs/ | `cluster_disconnected_dbs` | Count of disconnected dbs by node. | | `replication_backlog` | Number of pending replication consumers by origin, database, & table (for NATS replication only). | | `replication_backlog_time` | The difference in milliseconds between lastReceivedRemoteTime and lastReceivedLocalTime for each of the node's dbs (for Harper replication only). | -| `replication_latency` | The difference in milliseconds between incoming transactions' timestamps (as recorded remotely) and the time when each transaction finished committing locally (for Harper replication only). | +| `replication_latency` | The difference in milliseconds between incoming transactions' timestamps (as recorded remotely) and the time when each transaction finished committing locally (for Harper replication only). Unlike `replication_backlog_time`, this is recorded over time rather than calculated from the current `cluster_status`. | A complete sample response of `/metrics`: ```text