From b964a1509e123c56badd2815c71ac12b1e56f587 Mon Sep 17 00:00:00 2001
From: huoyao1125 <90880576+huoyao1125@users.noreply.github.com>
Date: Mon, 1 Jun 2026 20:21:43 +0800
Subject: [PATCH 1/3] Update built-in-monitoring-premium.md
---
tidb-cloud/premium/built-in-monitoring-premium.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/tidb-cloud/premium/built-in-monitoring-premium.md b/tidb-cloud/premium/built-in-monitoring-premium.md
index 78765df71ddc1..8d072a23eb6f0 100644
--- a/tidb-cloud/premium/built-in-monitoring-premium.md
+++ b/tidb-cloud/premium/built-in-monitoring-premium.md
@@ -44,6 +44,7 @@ The following sections illustrate the metrics on the **Metrics** page for {{{ .p
| Connection Count | All, active connection | All: the number of connections.
Active connections: the number of active connections. |
| Disconnection Count | {result} | The number of clients disconnected. |
+
### Database
| Metric name | Labels | Description |
From dd54617d584f9353c686405c25cb2ff01c3671ae Mon Sep 17 00:00:00 2001
From: huoyao1125 <90880576+huoyao1125@users.noreply.github.com>
Date: Mon, 1 Jun 2026 20:31:25 +0800
Subject: [PATCH 2/3] Update built-in-monitoring-premium.md
---
tidb-cloud/premium/built-in-monitoring-premium.md | 3 ++-
1 file changed, 2 insertions(+), 1 deletion(-)
diff --git a/tidb-cloud/premium/built-in-monitoring-premium.md b/tidb-cloud/premium/built-in-monitoring-premium.md
index 8d072a23eb6f0..8e5f96fdc2b0a 100644
--- a/tidb-cloud/premium/built-in-monitoring-premium.md
+++ b/tidb-cloud/premium/built-in-monitoring-premium.md
@@ -43,7 +43,8 @@ The following sections illustrate the metrics on the **Metrics** page for {{{ .p
| Transaction Duration | avg-{transaction model}, 99-{transaction model} | The average or the 99th percentile duration of transactions. |
| Connection Count | All, active connection | All: the number of connections.
Active connections: the number of active connections. |
| Disconnection Count | {result} | The number of clients disconnected. |
-
+| Table Count by TTL Schedule Delay | `{name}` | Shows how many TTL-enabled tables fall into each schedule delay range. The `name` label is a delay bucket. Possible bucket values: `01 hour`, `02 hour`, `06 hour`, `12 hour`, `24 hour`, `72 hour`, `one week`, `others`. |
+| TTL Insert/Delete Rows by Day | `insert current day`, `delete current day`, `insert last day`, `delete last day`, `insert 2 days ago`, `delete 2 days ago` | Shows the total number of rows written into TTL-tracked tables (insert) and rows deleted by TTL jobs (delete) within a calendar day. A persistent insert/delete imbalance — where inserts consistently exceed deletes — indicates TTL is not keeping pace with data ingestion, leading to storage growth. Day-over-day comparison helps distinguish normal traffic variation from a degradation trend. |
### Database
From 34b5d0d0d3c290619516af73895e4dfbfa70700f Mon Sep 17 00:00:00 2001
From: xixirangrang
Date: Tue, 2 Jun 2026 10:32:40 +0800
Subject: [PATCH 3/3] Apply suggestions from code review
---
tidb-cloud/premium/built-in-monitoring-premium.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/tidb-cloud/premium/built-in-monitoring-premium.md b/tidb-cloud/premium/built-in-monitoring-premium.md
index 8e5f96fdc2b0a..1589dd020d4a4 100644
--- a/tidb-cloud/premium/built-in-monitoring-premium.md
+++ b/tidb-cloud/premium/built-in-monitoring-premium.md
@@ -43,8 +43,8 @@ The following sections illustrate the metrics on the **Metrics** page for {{{ .p
| Transaction Duration | avg-{transaction model}, 99-{transaction model} | The average or the 99th percentile duration of transactions. |
| Connection Count | All, active connection | All: the number of connections.
Active connections: the number of active connections. |
| Disconnection Count | {result} | The number of clients disconnected. |
-| Table Count by TTL Schedule Delay | `{name}` | Shows how many TTL-enabled tables fall into each schedule delay range. The `name` label is a delay bucket. Possible bucket values: `01 hour`, `02 hour`, `06 hour`, `12 hour`, `24 hour`, `72 hour`, `one week`, `others`. |
-| TTL Insert/Delete Rows by Day | `insert current day`, `delete current day`, `insert last day`, `delete last day`, `insert 2 days ago`, `delete 2 days ago` | Shows the total number of rows written into TTL-tracked tables (insert) and rows deleted by TTL jobs (delete) within a calendar day. A persistent insert/delete imbalance — where inserts consistently exceed deletes — indicates TTL is not keeping pace with data ingestion, leading to storage growth. Day-over-day comparison helps distinguish normal traffic variation from a degradation trend. |
+| Table Count by TTL Schedule Delay | `{name}` | Shows the number of TTL-enabled tables grouped by schedule delay. The `name` label is a delay bucket. Possible bucket values: `01 hour`, `02 hour`, `06 hour`, `12 hour`, `24 hour`, `72 hour`, `one week`, and `others`. |
+| TTL Insert/Delete Rows by Day | `insert current day`, `delete current day`, `insert last day`, `delete last day`, `insert 2 days ago`, `delete 2 days ago` | Shows the number of rows inserted into TTL-managed tables and the number of rows deleted by TTL jobs for each calendar day. A sustained gap where inserts consistently exceed deletes indicates that TTL processing is falling behind data ingestion, which can lead to storage growth. Comparing values across multiple days helps distinguish normal workload fluctuations from a long-term backlog trend. |
### Database