diff --git a/site/content/3.12/release-notes/version-3.12/api-changes-in-3-12.md b/site/content/3.12/release-notes/version-3.12/api-changes-in-3-12.md index 71b5b0071a..7f3b4eb5e0 100644 --- a/site/content/3.12/release-notes/version-3.12/api-changes-in-3-12.md +++ b/site/content/3.12/release-notes/version-3.12/api-changes-in-3-12.md @@ -116,6 +116,14 @@ the query. In that case, `warnings` contains an empty array. In previous versions, no `warnings` attribute was returned when parsing a query produced no warnings. +#### Metrics API + +The metrics endpoint includes the following new metric: + +| Label | Description | +|:------|:------------| +| `arangodb_aql_cursors_active` | Current number of active AQL query cursors. | + ### Endpoints moved diff --git a/site/content/3.12/release-notes/version-3.12/whats-new-in-3-12.md b/site/content/3.12/release-notes/version-3.12/whats-new-in-3-12.md index 2fef58a356..49bbbd8123 100644 --- a/site/content/3.12/release-notes/version-3.12/whats-new-in-3-12.md +++ b/site/content/3.12/release-notes/version-3.12/whats-new-in-3-12.md @@ -251,6 +251,18 @@ of outgrowing the maximum number of file descriptors the ArangoDB process can open. Thus, these options should only be enabled on deployments with a limited number of collections/shards/indexes. +### Active AQL query cursors metric + +The `arangodb_aql_cursors_active` metric has been added and shows the number +of active AQL query cursors. + +AQL query cursors are created for queries that produce more results than +specified in the `batchSize` query option (default value: `1000`). Such results +can be fetched incrementally by client operations in chunks. +As it is unclear if and when a client will fetch any remaining data from a +cursor, every cursor has a server-side timeout value (TTL) after which it is +considered inactive and garbage-collected. + ## Client tools ### arangodump