From ca261ee9880f639ba606a0c7282bf4fba38dcc57 Mon Sep 17 00:00:00 2001 From: supritha-kumar Date: Tue, 23 Sep 2025 08:58:54 +0530 Subject: [PATCH 1/5] Update rest-buckets-table.adoc Had made changes for 7.6 which have been approved by reporter porting the changes to other versions of Server https://github.com/couchbase/docs-server/pull/3859/files --- modules/rest-api/partials/rest-buckets-table.adoc | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/modules/rest-api/partials/rest-buckets-table.adoc b/modules/rest-api/partials/rest-buckets-table.adoc index 87b5554d42..cf1f39aa15 100644 --- a/modules/rest-api/partials/rest-buckets-table.adoc +++ b/modules/rest-api/partials/rest-buckets-table.adoc @@ -23,8 +23,8 @@ | xref:rest-api:rest-retrieve-bucket-nodes.adoc[Listing Nodes by Bucket] | `GET` -| `/pools/default/buckets/[bucket-name]/stats` -| xref:rest-api:rest-bucket-stats.adoc[Getting Bucket Statistics] +| `/pools/default/stats/range` +| xref:rest-api:rest-statistics.adoc[Statistics] | `GET` | `/pools/default/buckets/default` From 925a0c9b2cdba994fed678c5fbb11e3558ea7c12 Mon Sep 17 00:00:00 2001 From: supritha-kumar Date: Tue, 23 Sep 2025 09:03:55 +0530 Subject: [PATCH 2/5] Update rest-xdcr-table.adoc Had made changes for 7.6 which have been approved by reporter porting the changes to other versions of Server https://github.com/couchbase/docs-server/pull/3859/files --- modules/rest-api/partials/rest-xdcr-table.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/rest-api/partials/rest-xdcr-table.adoc b/modules/rest-api/partials/rest-xdcr-table.adoc index de6a8c9753..945dee3ad7 100644 --- a/modules/rest-api/partials/rest-xdcr-table.adoc +++ b/modules/rest-api/partials/rest-xdcr-table.adoc @@ -44,7 +44,7 @@ | `GET` -| `/pools/default/buckets/[source_bucket]/stats/[destination_endpoint]` +| `/pools/defaults/stats/range/[source_bucket]/stats/[destination_endpoint]` | xref:rest-api:rest-xdcr-statistics.adoc[Getting Statistics] |=== From 2623e8b1394d6f6d51aab6f87b90fa8cbb6b7577 Mon Sep 17 00:00:00 2001 From: Shwetha Rao Date: Mon, 6 Oct 2025 15:44:44 +0530 Subject: [PATCH 3/5] Corrected the added content as per doc requirements --- modules/introduction/partials/new-features-80.adoc | 12 ++++++++++++ modules/rest-api/pages/rest-bucket-stats.adoc | 7 ++++++- modules/rest-api/partials/rest-buckets-table.adoc | 6 +++++- modules/rest-api/partials/rest-xdcr-table.adoc | 4 ++-- 4 files changed, 25 insertions(+), 4 deletions(-) diff --git a/modules/introduction/partials/new-features-80.adoc b/modules/introduction/partials/new-features-80.adoc index b0f1cfe35a..1381e1320e 100644 --- a/modules/introduction/partials/new-features-80.adoc +++ b/modules/introduction/partials/new-features-80.adoc @@ -89,6 +89,12 @@ curl --get -u \ -d clusterLabels=none|uuidOnly|uuidAndName ---- +https://jira.issues.couchbase.com/browse/MB-66615[MB-66615]:: +The REST API `GET /pools/default/buckets/[bucket-name]/stats` (xref:rest-api:rest-bucket-stats.adoc[Getting Bucket Statistics]) is deprecated and replaced with `GET /pools/default/stats/range/[metric_name]/[function-expression]`. +Similarly, to retrieve statistics for multiple metrics, the REST API `POST /pools/default/stats/range` is supported. ++ +For more information, see xref:rest-api:rest-statistics-single.adoc[Getting a Single Statistic] and xref:rest-api:rest-statistics-multiple.adoc[Getting Multiple Statistics]. + [#section-new-feature-800-services] === Services @@ -281,6 +287,12 @@ https://jira.issues.couchbase.com/browse/MB-62507[MB-62507]:: XDCR supports Generic Services Log Level configuration using the REST API through the `genericServicesLogLevel` settings. For more information, see xref:rest-api:rest-xdcr-adv-settings.adoc[XDCR Advanced Settings]. + +https://jira.issues.couchbase.com/browse/MB-66615[MB-66615]:: +To retrieve the XDCR statistics details, instead of the REST API `GET /pools/default/buckets/[source_bucket]/stats/[destination_endpoint]`, Couchbase now supports the REST API `GET /pools/default/stats/range/[statistics_name]`. ++ +For more information, see xref:rest-api:rest-statistics-single.adoc[Getting a Single Statistic]. + [#section-new-features-800-security-authentication] === Security and Authentication diff --git a/modules/rest-api/pages/rest-bucket-stats.adoc b/modules/rest-api/pages/rest-bucket-stats.adoc index b2b8afe8e8..2644ce128b 100644 --- a/modules/rest-api/pages/rest-bucket-stats.adoc +++ b/modules/rest-api/pages/rest-bucket-stats.adoc @@ -1,11 +1,16 @@ = Getting Bucket Statistics -:description: pass:q[To retrieve bucket statistics, use the `GET` operation with the `/pools/default/buckets/bucket_name/stats` URI.] +:description: pass:q[See the IMPORTANT note.] :page-topic-type: reference :page-aliases: rest-api:rest-node-retrieve-stats +[.deprecated]#Deprecated# + [abstract] {description} +IMPORTANT: As of Couchbase Server 8.0, this REST API endpoint is deprecated. +For retrieving bucket statistics, use xref:rest-api:rest-statistics-single.adoc[Getting a Single Statistic] instead. + == HTTP method and URI Statistics can be retrieved at the bucket level. diff --git a/modules/rest-api/partials/rest-buckets-table.adoc b/modules/rest-api/partials/rest-buckets-table.adoc index cf1f39aa15..94e8987762 100644 --- a/modules/rest-api/partials/rest-buckets-table.adoc +++ b/modules/rest-api/partials/rest-buckets-table.adoc @@ -23,8 +23,12 @@ | xref:rest-api:rest-retrieve-bucket-nodes.adoc[Listing Nodes by Bucket] | `GET` +| `/pools/default/stats/range/[metric_name]/[function-expression]` +| xref:rest-api:rest-statistics-single.adoc[Getting a Single Statistic] + +| `POST` | `/pools/default/stats/range` -| xref:rest-api:rest-statistics.adoc[Statistics] +| xref:rest-api:rest-statistics-multiple.adoc[Getting Multiple Statistics] | `GET` | `/pools/default/buckets/default` diff --git a/modules/rest-api/partials/rest-xdcr-table.adoc b/modules/rest-api/partials/rest-xdcr-table.adoc index 945dee3ad7..8b5361709e 100644 --- a/modules/rest-api/partials/rest-xdcr-table.adoc +++ b/modules/rest-api/partials/rest-xdcr-table.adoc @@ -44,7 +44,7 @@ | `GET` -| `/pools/defaults/stats/range/[source_bucket]/stats/[destination_endpoint]` -| xref:rest-api:rest-xdcr-statistics.adoc[Getting Statistics] +| `/pools/default/stats/range/[statistics_name]` +| xref:rest-api:rest-statistics-single.adoc[Getting a Single Statistic] |=== From 9450306e286e70c884540dfe2dcbd091f9acca63 Mon Sep 17 00:00:00 2001 From: Shwetha Rao Date: Mon, 6 Oct 2025 15:58:26 +0530 Subject: [PATCH 4/5] minor edit --- modules/rest-api/pages/rest-bucket-stats.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/rest-api/pages/rest-bucket-stats.adoc b/modules/rest-api/pages/rest-bucket-stats.adoc index 2644ce128b..fca00b9760 100644 --- a/modules/rest-api/pages/rest-bucket-stats.adoc +++ b/modules/rest-api/pages/rest-bucket-stats.adoc @@ -9,7 +9,7 @@ {description} IMPORTANT: As of Couchbase Server 8.0, this REST API endpoint is deprecated. -For retrieving bucket statistics, use xref:rest-api:rest-statistics-single.adoc[Getting a Single Statistic] instead. +For retrieving bucket statistics, use xref:rest-api:rest-statistics-single.adoc[Getting a Single Statistic] or xref:rest-api:rest-statistics-multiple.adoc[Getting Multiple Statistics] instead. == HTTP method and URI From 5509b873ea5f1ad4ca84d3e33bfae8c147600df2 Mon Sep 17 00:00:00 2001 From: Shwetha Rao Date: Mon, 6 Oct 2025 16:47:50 +0530 Subject: [PATCH 5/5] Updated Important Note --- modules/rest-api/pages/rest-bucket-stats.adoc | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/modules/rest-api/pages/rest-bucket-stats.adoc b/modules/rest-api/pages/rest-bucket-stats.adoc index fca00b9760..aaeadff1f2 100644 --- a/modules/rest-api/pages/rest-bucket-stats.adoc +++ b/modules/rest-api/pages/rest-bucket-stats.adoc @@ -8,8 +8,8 @@ [abstract] {description} -IMPORTANT: As of Couchbase Server 8.0, this REST API endpoint is deprecated. -For retrieving bucket statistics, use xref:rest-api:rest-statistics-single.adoc[Getting a Single Statistic] or xref:rest-api:rest-statistics-multiple.adoc[Getting Multiple Statistics] instead. +IMPORTANT: As of Couchbase Server 8.0, the REST API endpoint `GET /pools/default/buckets//stats` is deprecated. +For retrieving bucket statistics details, use xref:rest-api:rest-statistics-single.adoc[Getting a Single Statistic] or xref:rest-api:rest-statistics-multiple.adoc[Getting Multiple Statistics] instead. == HTTP method and URI