Merge branch 'link-fixes' of https://github.com/arangodb/docs-hugo into link-fixes

Author: nikhil-varma

site/config/_default/config.yaml

@@ -32,9 +32,13 @@ outputFormats:
     baseName: nav
     isHTML: true
     mediaType: text/html
+  notfound:
+    baseName: notfound
+    isHTML: true
+    mediaType: text/html
 
 outputs:
-  home: ["HTML", "navigation"]
+  home: ["HTML", "navigation", "notfound"]
 
 enableRobotsTXT: true
 

site/content/3.10/release-notes/version-3.10/whats-new-in-3-10.md

@@ -1406,6 +1406,30 @@ The caching subsystem now provides the following 3 additional metrics:
   so they can be recycled quickly. The overall amount of inactive tables is
   limited, so not much memory will be used here.
 
+### Observability of in-memory cache subsystem
+
+<small>Introduced in: v3.10.11</small>
+
+The following metrics have been added to improve the observability of in-memory
+cache subsystem:
+- `rocksdb_cache_free_memory_tasks_total`: Total number of free memory tasks
+  that were scheduled by the in-memory edge cache subsystem. This metric will
+  be increased whenever the cache subsystem schedules a task to free up memory
+  in one of the managed in-memory caches. It is expected to see this metric
+  rising when the cache subsystem hits its global memory budget.
+- `rocksdb_cache_free_memory_tasks_duration_total`: Total amount of time spent
+  inside the free memory tasks of the in-memory cache subsystem. Free memory
+  tasks are scheduled by the cache subsystem to free up memory in existing cache
+  hash tables.
+- `rocksdb_cache_migrate_tasks_total`: Total number of migrate tasks that were
+  scheduled by the in-memory edge cache subsystem. This metric will be increased 
+  whenever the cache subsystem schedules a task to migrate an existing cache hash
+  table to a bigger or smaller size.
+- `rocksdb_cache_migrate_tasks_duration_total`: Total amount of time spent inside
+  the migrate tasks of the in-memory cache subsystem. Migrate tasks are scheduled
+  by the cache subsystem to migrate existing cache hash tables to a bigger or
+  smaller table.
+
 ### Replication improvements
 
 For synchronous replication of document operations in the cluster, the follower

site/content/3.11/release-notes/version-3.10/whats-new-in-3-10.md

@@ -1406,6 +1406,30 @@ The caching subsystem now provides the following 3 additional metrics:
   so they can be recycled quickly. The overall amount of inactive tables is
   limited, so not much memory will be used here.
 
+### Observability of in-memory cache subsystem
+
+<small>Introduced in: v3.10.11</small>
+
+The following metrics have been added to improve the observability of in-memory
+cache subsystem:
+- `rocksdb_cache_free_memory_tasks_total`: Total number of free memory tasks
+  that were scheduled by the in-memory edge cache subsystem. This metric will
+  be increased whenever the cache subsystem schedules a task to free up memory
+  in one of the managed in-memory caches. It is expected to see this metric
+  rising when the cache subsystem hits its global memory budget.
+- `rocksdb_cache_free_memory_tasks_duration_total`: Total amount of time spent
+  inside the free memory tasks of the in-memory cache subsystem. Free memory
+  tasks are scheduled by the cache subsystem to free up memory in existing cache
+  hash tables.
+- `rocksdb_cache_migrate_tasks_total`: Total number of migrate tasks that were
+  scheduled by the in-memory edge cache subsystem. This metric will be increased 
+  whenever the cache subsystem schedules a task to migrate an existing cache hash
+  table to a bigger or smaller size.
+- `rocksdb_cache_migrate_tasks_duration_total`: Total amount of time spent inside
+  the migrate tasks of the in-memory cache subsystem. Migrate tasks are scheduled
+  by the cache subsystem to migrate existing cache hash tables to a bigger or
+  smaller table.  
+
 ### Replication improvements
 
 For synchronous replication of document operations in the cluster, the follower

site/content/3.11/release-notes/version-3.11/whats-new-in-3-11.md

@@ -1217,6 +1217,30 @@ The following metrics have been added:
 | `rocksdb_cache_edge_empty_inserts_total` | Total number of insertions into the in-memory edge cache for non-connected edges. |
 | `rocksdb_cache_edge_inserts_total` | Total number of insertions into the in-memory edge cache. |
 
+### Observability of in-memory cache subsystem
+
+<small>Introduced in: v3.10.11, v.3.11.4</small>
+
+The following metrics have been added to improve the observability of in-memory
+cache subsystem:
+- `rocksdb_cache_free_memory_tasks_total`: Total number of free memory tasks
+  that were scheduled by the in-memory edge cache subsystem. This metric will
+  be increased whenever the cache subsystem schedules a task to free up memory
+  in one of the managed in-memory caches. It is expected to see this metric
+  rising when the cache subsystem hits its global memory budget.
+- `rocksdb_cache_free_memory_tasks_duration_total`: Total amount of time spent
+  inside the free memory tasks of the in-memory cache subsystem. Free memory
+  tasks are scheduled by the cache subsystem to free up memory in existing cache
+  hash tables.
+- `rocksdb_cache_migrate_tasks_total`: Total number of migrate tasks that were
+  scheduled by the in-memory edge cache subsystem. This metric will be increased 
+  whenever the cache subsystem schedules a task to migrate an existing cache hash
+  table to a bigger or smaller size.
+- `rocksdb_cache_migrate_tasks_duration_total`: Total amount of time spent inside
+  the migrate tasks of the in-memory cache subsystem. Migrate tasks are scheduled
+  by the cache subsystem to migrate existing cache hash tables to a bigger or
+  smaller table.
+
 ## Client tools
 
 ### arangodump

site/content/3.12/release-notes/version-3.10/whats-new-in-3-10.md

@@ -1406,6 +1406,30 @@ The caching subsystem now provides the following 3 additional metrics:
   so they can be recycled quickly. The overall amount of inactive tables is
   limited, so not much memory will be used here.
 
+### Observability of in-memory cache subsystem
+
+<small>Introduced in: v3.10.11</small>
+
+The following metrics have been added to improve the observability of in-memory
+cache subsystem:
+- `rocksdb_cache_free_memory_tasks_total`: Total number of free memory tasks
+  that were scheduled by the in-memory edge cache subsystem. This metric will
+  be increased whenever the cache subsystem schedules a task to free up memory
+  in one of the managed in-memory caches. It is expected to see this metric
+  rising when the cache subsystem hits its global memory budget.
+- `rocksdb_cache_free_memory_tasks_duration_total`: Total amount of time spent
+  inside the free memory tasks of the in-memory cache subsystem. Free memory
+  tasks are scheduled by the cache subsystem to free up memory in existing cache
+  hash tables.
+- `rocksdb_cache_migrate_tasks_total`: Total number of migrate tasks that were
+  scheduled by the in-memory edge cache subsystem. This metric will be increased 
+  whenever the cache subsystem schedules a task to migrate an existing cache hash
+  table to a bigger or smaller size.
+- `rocksdb_cache_migrate_tasks_duration_total`: Total amount of time spent inside
+  the migrate tasks of the in-memory cache subsystem. Migrate tasks are scheduled
+  by the cache subsystem to migrate existing cache hash tables to a bigger or
+  smaller table.
+
 ### Replication improvements
 
 For synchronous replication of document operations in the cluster, the follower

site/content/3.12/release-notes/version-3.11/whats-new-in-3-11.md

@@ -1217,6 +1217,30 @@ The following metrics have been added:
 | `rocksdb_cache_edge_empty_inserts_total` | Total number of insertions into the in-memory edge cache for non-connected edges. |
 | `rocksdb_cache_edge_inserts_total` | Total number of insertions into the in-memory edge cache. |
 
+### Observability of in-memory cache subsystem
+
+<small>Introduced in: v3.10.11, v.3.11.4</small>
+
+The following metrics have been added to improve the observability of in-memory
+cache subsystem:
+- `rocksdb_cache_free_memory_tasks_total`: Total number of free memory tasks
+  that were scheduled by the in-memory edge cache subsystem. This metric will
+  be increased whenever the cache subsystem schedules a task to free up memory
+  in one of the managed in-memory caches. It is expected to see this metric
+  rising when the cache subsystem hits its global memory budget.
+- `rocksdb_cache_free_memory_tasks_duration_total`: Total amount of time spent
+  inside the free memory tasks of the in-memory cache subsystem. Free memory
+  tasks are scheduled by the cache subsystem to free up memory in existing cache
+  hash tables.
+- `rocksdb_cache_migrate_tasks_total`: Total number of migrate tasks that were
+  scheduled by the in-memory edge cache subsystem. This metric will be increased 
+  whenever the cache subsystem schedules a task to migrate an existing cache hash
+  table to a bigger or smaller size.
+- `rocksdb_cache_migrate_tasks_duration_total`: Total amount of time spent inside
+  the migrate tasks of the in-memory cache subsystem. Migrate tasks are scheduled
+  by the cache subsystem to migrate existing cache hash tables to a bigger or
+  smaller table.
+
 ## Client tools
 
 ### arangodump

site/content/3.12/release-notes/version-3.12/whats-new-in-3-12.md

@@ -137,6 +137,30 @@ The following metrics have been added:
 | `rocksdb_cache_edge_empty_inserts_total` | Total number of insertions into the in-memory edge cache for non-connected edges. |
 | `rocksdb_cache_edge_inserts_total` | Total number of insertions into the in-memory edge cache. |
 
+### Observability of in-memory cache subsystem
+
+<small>Introduced in: v3.10.11, v.3.11.4, v.3.12.0</small>
+
+The following metrics have been added to improve the observability of in-memory
+cache subsystem:
+- `rocksdb_cache_free_memory_tasks_total`: Total number of free memory tasks
+  that were scheduled by the in-memory edge cache subsystem. This metric will
+  be increased whenever the cache subsystem schedules a task to free up memory
+  in one of the managed in-memory caches. It is expected to see this metric
+  rising when the cache subsystem hits its global memory budget.
+- `rocksdb_cache_free_memory_tasks_duration_total`: Total amount of time spent
+  inside the free memory tasks of the in-memory cache subsystem. Free memory
+  tasks are scheduled by the cache subsystem to free up memory in existing cache
+  hash tables.
+- `rocksdb_cache_migrate_tasks_total`: Total number of migrate tasks that were
+  scheduled by the in-memory edge cache subsystem. This metric will be increased 
+  whenever the cache subsystem schedules a task to migrate an existing cache hash
+  table to a bigger or smaller size.
+- `rocksdb_cache_migrate_tasks_duration_total`: Total amount of time spent inside
+  the migrate tasks of the in-memory cache subsystem. Migrate tasks are scheduled
+  by the cache subsystem to migrate existing cache hash tables to a bigger or
+  smaller table.
+
 ### RocksDB .sst file partitioning (experimental)
 
 The following experimental startup options for RockDB .sst file partitioning

site/data/3.10/allMetrics.yaml

@@ -4991,6 +4991,45 @@
     startup option is enabled.
     On Agents and Coordinators, the values reported by this metric are always zero.
 
+- name: rocksdb_cache_free_memory_tasks_duration_total
+  introducedIn: "3.10.11"
+  help: |
+    Total amount of time spent in 'free memory' tasks of the in-memory 
+    cache subsystem.
+  unit: us
+  type: counter
+  category: Statistics
+  complexity: advanced
+  exposedBy:
+    - dbserver
+    - agent
+    - single
+  description: |
+    Total amount of time spent inside 'free memory' tasks of the in-memory
+    cache subsystem. 'free memory' tasks are scheduled by the cache subsystem
+    to free up memory in existing cache hash tables.
+
+- name: rocksdb_cache_free_memory_tasks_total
+  introducedIn: "3.10.11"
+  help: |
+    Total number of 'free memory' tasks scheduled by the in-memory
+    cache subsystem.
+  unit: number
+  type: counter
+  category: Statistics
+  complexity: advanced
+  exposedBy:
+    - dbserver
+    - agent
+    - single
+  description: |
+    Total number of 'free memory' tasks that were scheduled by the
+    in-memory edge cache subsystem. This metric will be increased
+    whenever the cache subsystem schedules a task to free up memory
+    in one of the managed in-memory caches. It is expected to see
+    this metric rising when the cache subsystem hits its global
+    memory budget.
+
 - name: rocksdb_cache_full_index_refills_total
   introducedIn: "3.10.2"
   help: |
@@ -5069,6 +5108,43 @@
     edge cache counts towards this allocation. This global limit can
     be controlled with the `--cache.size` startup option.
 
+- name: rocksdb_cache_migrate_tasks_duration_total
+  introducedIn: "3.10.11"
+  help: |
+    Total amount of time spent in 'migrate' tasks of the in-memory 
+    cache subsystem.
+  unit: us
+  type: counter
+  category: Statistics
+  complexity: advanced
+  exposedBy:
+    - dbserver
+    - agent
+    - single
+  description: |
+    Total amount of time spent inside 'migrate' tasks of the in-memory
+    cache subsystem. 'migrate' tasks are scheduled by the cache subsystem
+    to migrate existing cache hash tables to a bigger or smaller table.
+
+- name: rocksdb_cache_migrate_tasks_total
+  introducedIn: "3.10.11"
+  help: |
+    Total number of 'migrate' tasks scheduled by the in-memory
+    cache subsystem.
+  unit: number
+  type: counter
+  category: Statistics
+  complexity: advanced
+  exposedBy:
+    - dbserver
+    - agent
+    - single
+  description: |
+    Total number of 'migrate' tasks that were scheduled by the
+    in-memory edge cache subsystem. This metric will be increased
+    whenever the cache subsystem schedules a task to migrate an
+    existing cache hash table to a bigger or smaller size.
+
 - name: rocksdb_cache_peak_allocated
   introducedIn: "3.10.7"
   help: |

site/data/3.11/allMetrics.yaml

@@ -5537,6 +5537,45 @@
     the cache had no memory left). The metric is not decreased when data gets 
     evicted from the cache.
 
+- name: rocksdb_cache_free_memory_tasks_duration_total
+  introducedIn: "3.10.11"
+  help: |
+    Total amount of time spent in 'free memory' tasks of the in-memory 
+    cache subsystem.
+  unit: us
+  type: counter
+  category: Statistics
+  complexity: advanced
+  exposedBy:
+    - dbserver
+    - agent
+    - single
+  description: |
+    Total amount of time spent inside 'free memory' tasks of the in-memory
+    cache subsystem. 'free memory' tasks are scheduled by the cache subsystem
+    to free up memory in existing cache hash tables.
+
+- name: rocksdb_cache_free_memory_tasks_total
+  introducedIn: "3.10.11"
+  help: |
+    Total number of 'free memory' tasks scheduled by the in-memory
+    cache subsystem.
+  unit: number
+  type: counter
+  category: Statistics
+  complexity: advanced
+  exposedBy:
+    - dbserver
+    - agent
+    - single
+  description: |
+    Total number of 'free memory' tasks that were scheduled by the
+    in-memory edge cache subsystem. This metric will be increased
+    whenever the cache subsystem schedules a task to free up memory
+    in one of the managed in-memory caches. It is expected to see
+    this metric rising when the cache subsystem hits its global
+    memory budget.
+
 - name: rocksdb_cache_full_index_refills_total
   introducedIn: "3.10.2"
   help: |
@@ -5616,6 +5655,43 @@
     edge cache counts towards this allocation. This global limit can
     be controlled with the `--cache.size` startup option.
 
+- name: rocksdb_cache_migrate_tasks_duration_total
+  introducedIn: "3.10.11"
+  help: |
+    Total amount of time spent in 'migrate' tasks of the in-memory 
+    cache subsystem.
+  unit: us
+  type: counter
+  category: Statistics
+  complexity: advanced
+  exposedBy:
+    - dbserver
+    - agent
+    - single
+  description: |
+    Total amount of time spent inside 'migrate' tasks of the in-memory
+    cache subsystem. 'migrate' tasks are scheduled by the cache subsystem
+    to migrate existing cache hash tables to a bigger or smaller table.
+
+- name: rocksdb_cache_migrate_tasks_total
+  introducedIn: "3.10.11"
+  help: |
+    Total number of 'migrate' tasks scheduled by the in-memory
+    cache subsystem.
+  unit: number
+  type: counter
+  category: Statistics
+  complexity: advanced
+  exposedBy:
+    - dbserver
+    - agent
+    - single
+  description: |
+    Total number of 'migrate' tasks that were scheduled by the
+    in-memory edge cache subsystem. This metric will be increased
+    whenever the cache subsystem schedules a task to migrate an
+    existing cache hash table to a bigger or smaller size.
+
 - name: rocksdb_cache_peak_allocated
   introducedIn: "3.10.7"
   help: |