DOC-11708 Deprecated REST API endpoint for bucket stats (#3894)

Author: supritha-kumar

modules/introduction/partials/new-features-80.adoc

@@ -89,6 +89,12 @@ curl --get -u <username:password> \
     -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].
+
 https://jira.issues.couchbase.com/browse/MB-33315[MB-33315] Allow auto-failover for ephemeral buckets without a replica::
 Previously, Couchbase Server always prevented auto-failover on nodes containing an ephemeral bucket that does not have replicas.
 You can now configure Couchbase Server Enterprise Edition to allow a node to auto-failover even if it has an ephemeral bucket without a replica.
@@ -98,7 +104,6 @@ When you enable it, Couchbase Server creates empty vBuckets on other nodes to re
 If the failed over node rejoins the cluster, Couchbase Server moves the replacement vBuckets back to rejoining node.
 This option is useful if your application uses ephemeral buckets for data that's not irreplaceable, such as caches.
 This setting is not available in Couchbase Server Community Edition.
-
 +
 See xref:learn:clusters-and-availability/automatic-failover.adoc#auto-failover-and-ephemeral-buckets[Auto-Failover and Ephemeral Buckets] and xref:manage:manage-settings/general-settings.adoc#node-availability[Node Availability]  for more information.
 
@@ -108,7 +113,6 @@ Before version 8.0, you could only configure Couchbase Server to auto-failover a
 The new `failoverOnDataDiskNonResponsiveness` setting and corresponding settings in the Couchbase Web Console *Settings* page sets the nuber of seconds allowed for read or write operations to complete.
 If this period elapses before the operation completes, Couchbase Server triggers an auto-failover for the node.
 This setting is off by default.
-
 +
 See xref:learn:clusters-and-availability/automatic-failover.adoc#failover-on-data-disk-non-responsiveness[Failover on Data Disk Non-Responsiveness] to learn more about this feature. 
 See xref:manage:manage-settings/general-settings.adoc#node-availability[Node Availability] and xref:rest-api:rest-cluster-autofailover-enable.adoc[] to learn how to enable it.
@@ -348,6 +352,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
 

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, the REST API endpoint `GET /pools/default/buckets/<bucket-name>/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
 
 Statistics can be retrieved at the bucket level.

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/buckets/[bucket-name]/stats`
-| xref:rest-api:rest-bucket-stats.adoc[Getting Bucket Statistics]
+| `/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-multiple.adoc[Getting Multiple Statistics]
 
 | `GET`
 | `/pools/default/buckets/default`

modules/rest-api/partials/rest-xdcr-table.adoc

@@ -44,7 +44,7 @@
 
 
 | `GET`
-| `/pools/default/buckets/[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]
 
 |===