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 ed11206f64..f64beee28e 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 @@ -1061,6 +1061,16 @@ small requests. Compression for all Agency traffic is disabled regardless of the settings of these options. +### Read-only shards metric + +Introduced in: v3.12.1 + +The following cluster health metric has been added: + +| Label | Description | +|:------|:------------| +| `arangodb_vocbase_shards_read_only_by_write_concern` | Number of shards that are read-only due to an undercut of the write concern. | + ## Client tools ### Protocol aliases for endpoints diff --git a/site/content/3.13/release-notes/version-3.12/whats-new-in-3-12.md b/site/content/3.13/release-notes/version-3.12/whats-new-in-3-12.md index ed11206f64..f64beee28e 100644 --- a/site/content/3.13/release-notes/version-3.12/whats-new-in-3-12.md +++ b/site/content/3.13/release-notes/version-3.12/whats-new-in-3-12.md @@ -1061,6 +1061,16 @@ small requests. Compression for all Agency traffic is disabled regardless of the settings of these options. +### Read-only shards metric + +Introduced in: v3.12.1 + +The following cluster health metric has been added: + +| Label | Description | +|:------|:------------| +| `arangodb_vocbase_shards_read_only_by_write_concern` | Number of shards that are read-only due to an undercut of the write concern. | + ## Client tools ### Protocol aliases for endpoints diff --git a/site/data/3.10/arangod.json b/site/data/3.10/arangod.json index 12942f1c82..19c79ca0a0 100644 --- a/site/data/3.10/arangod.json +++ b/site/data/3.10/arangod.json @@ -1109,7 +1109,7 @@ "agent", "single" ], - "default" : 7739682816, + "default" : 7739681792, "deprecatedIn" : null, "description" : "The global size limit for all caches (in bytes).", "dynamic" : true, @@ -1992,7 +1992,7 @@ "agent", "single" ], - "default" : "/var/lib/arangodb3", + "default" : "", "deprecatedIn" : null, "description" : "The path to the database directory.", "dynamic" : false, @@ -3100,7 +3100,7 @@ "coordinator", "single" ], - "default" : "/var/lib/arangodb3-apps", + "default" : "./js/apps", "deprecatedIn" : null, "description" : "The directory for Foxx applications.", "dynamic" : false, @@ -3398,6 +3398,7 @@ "single" ], "default" : [ + "./enterprise/js" ], "deprecatedIn" : null, "description" : "Additional paths containing JavaScript modules.", @@ -3476,7 +3477,7 @@ "coordinator", "single" ], - "default" : "/usr/share/arangodb3/js", + "default" : "./js", "deprecatedIn" : null, "description" : "A path to the directory containing the JavaScript startup scripts.", "dynamic" : false, @@ -5866,7 +5867,7 @@ "agent", "single" ], - "default" : "-", + "default" : "", "deprecatedIn" : null, "description" : "shortcut for '--log.output file://'", "dynamic" : false, @@ -7273,7 +7274,7 @@ "type" : "boolean" }, "query.global-memory-limit" : { - "base" : 33106214912, + "base" : 33106210816, "category" : "option", "component" : [ "coordinator", @@ -7281,7 +7282,7 @@ "agent", "single" ], - "default" : 26816034078, + "default" : 26816030761, "deprecatedIn" : null, "description" : "The memory threshold for all AQL queries combined (in bytes, 0 = no limit).", "dynamic" : true, @@ -7539,7 +7540,7 @@ "type" : "double" }, "query.memory-limit" : { - "base" : 33106214912, + "base" : 33106210816, "category" : "option", "component" : [ "coordinator", @@ -7547,7 +7548,7 @@ "agent", "single" ], - "default" : 19863728947, + "default" : 19863726489, "deprecatedIn" : null, "description" : "The memory threshold per AQL query (in bytes, 0 = no limit).", "dynamic" : true, @@ -8659,7 +8660,7 @@ "agent", "single" ], - "default" : 9287619379, + "default" : 9287618150, "deprecatedIn" : null, "description" : "The size of block cache (in bytes).", "dynamic" : true, @@ -11006,7 +11007,7 @@ "agent", "single" ], - "default" : 12383492505, + "default" : 12383490867, "deprecatedIn" : null, "description" : "The maximum total size of in-memory write buffers (0 = unbounded).", "dynamic" : true, diff --git a/site/data/3.11/arangod.json b/site/data/3.11/arangod.json index ede2e3f394..e619bac798 100644 --- a/site/data/3.11/arangod.json +++ b/site/data/3.11/arangod.json @@ -1400,7 +1400,7 @@ "agent", "single" ], - "default" : 7739682816, + "default" : 7739683840, "deprecatedIn" : null, "description" : "The global size limit for all caches (in bytes).", "dynamic" : true, @@ -7518,7 +7518,7 @@ "type" : "boolean" }, "query.global-memory-limit" : { - "base" : 33106214912, + "base" : 33106219008, "category" : "option", "component" : [ "coordinator", @@ -7526,7 +7526,7 @@ "agent", "single" ], - "default" : 26816034078, + "default" : 26816037397, "deprecatedIn" : null, "description" : "The memory threshold for all AQL queries combined (in bytes, 0 = no limit).", "dynamic" : true, @@ -7816,7 +7816,7 @@ "type" : "double" }, "query.memory-limit" : { - "base" : 33106214912, + "base" : 33106219008, "category" : "option", "component" : [ "coordinator", @@ -7824,7 +7824,7 @@ "agent", "single" ], - "default" : 19863728947, + "default" : 19863731405, "deprecatedIn" : null, "description" : "The memory threshold per AQL query (in bytes, 0 = no limit).", "dynamic" : true, @@ -9059,7 +9059,7 @@ "agent", "single" ], - "default" : 9287619379, + "default" : 9287620608, "deprecatedIn" : null, "description" : "The size of block cache (in bytes).", "dynamic" : true, @@ -11640,7 +11640,7 @@ "agent", "single" ], - "default" : 12383492505, + "default" : 12383494144, "deprecatedIn" : null, "description" : "The maximum total size of in-memory write buffers (0 = unbounded).", "dynamic" : true, diff --git a/site/data/3.12/allMetrics.yaml b/site/data/3.12/allMetrics.yaml index 35c9900ed2..1e7da743ff 100644 --- a/site/data/3.12/allMetrics.yaml +++ b/site/data/3.12/allMetrics.yaml @@ -5928,6 +5928,29 @@ by a server option. V8 contexts are created and destroyed as needed but there are never fewer than the limit shown in this metric. +- name: arangodb_vocbase_shards_read_only_by_write_concern + introducedIn: "3.12.1" + help: | + Number of shards that are read-only due to an undercut of the write concern. + unit: number + type: gauge + category: Replication + complexity: simple + exposedBy: + - dbserver + description: | + Number of shards that are in read-only mode because there are not at least write concern many in-sync replicas. + troubleshoot: | + If this metrics has a value greater than 0, then some + action is indicated. During an upgrade or when some DB-Server was + restarted, it can happen that shard followers are out of sync and thus + the write concern is undercut. Normally, shards should get in sync on + their own, so observation and waiting is a good measure at first. + However, if the situation persists, something is wrong, potentially + some constant server crash (maybe out of memory crashes?) or another + situation preventing shards to get in sync. + Contact ArangoDB customer support in this case. + - name: rocksdb_actual_delayed_write_rate introducedIn: "3.6.1" help: | diff --git a/site/data/3.12/arangobackup.json b/site/data/3.12/arangobackup.json index 5f4b901ca9..60b95b4d06 100644 --- a/site/data/3.12/arangobackup.json +++ b/site/data/3.12/arangobackup.json @@ -1036,7 +1036,7 @@ }, "server.authentication" : { "category" : "option", - "default" : false, + "default" : true, "deprecatedIn" : null, "description" : "Require authentication credentials when connecting (does not affect the server-side authentication settings).", "dynamic" : false, @@ -1100,7 +1100,7 @@ "server.endpoint" : { "category" : "option", "default" : [ - "http+tcp://127.0.0.1:8529" + "tcp://127.0.0.1:8529" ], "deprecatedIn" : null, "description" : "The endpoint to connect to. Use 'none' to start without a server. Use http+ssl:// as schema to connect to an SSL-secured server endpoint, otherwise http+tcp:// or unix://", diff --git a/site/data/3.12/arangobench.json b/site/data/3.12/arangobench.json index 4dd34fe8a3..3f9cdb1e8d 100644 --- a/site/data/3.12/arangobench.json +++ b/site/data/3.12/arangobench.json @@ -1341,7 +1341,7 @@ }, "server.authentication" : { "category" : "option", - "default" : false, + "default" : true, "deprecatedIn" : null, "description" : "Require authentication credentials when connecting (does not affect the server-side authentication settings).", "dynamic" : false, @@ -1405,7 +1405,7 @@ "server.endpoint" : { "category" : "option", "default" : [ - "http+tcp://127.0.0.1:8529" + "tcp://127.0.0.1:8529" ], "deprecatedIn" : null, "description" : "The endpoint to connect to. Use 'none' to start without a server. Use http+ssl:// as schema to connect to an SSL-secured server endpoint, otherwise http+tcp:// or unix://", diff --git a/site/data/3.12/arangod.json b/site/data/3.12/arangod.json index 2e52fd6e1f..729ffc0ed1 100644 --- a/site/data/3.12/arangod.json +++ b/site/data/3.12/arangod.json @@ -2280,7 +2280,7 @@ "agent", "single" ], - "default" : "", + "default" : "/var/lib/arangodb3", "deprecatedIn" : null, "description" : "The path to the database directory.", "dynamic" : false, @@ -3435,7 +3435,7 @@ "coordinator", "single" ], - "default" : "./js/apps", + "default" : "/var/lib/arangodb3-apps", "deprecatedIn" : null, "description" : "The directory for Foxx applications.", "dynamic" : false, @@ -3710,7 +3710,6 @@ "single" ], "default" : [ - "./enterprise/js" ], "deprecatedIn" : null, "description" : "Additional paths containing JavaScript modules.", @@ -3786,7 +3785,7 @@ "coordinator", "single" ], - "default" : "./js", + "default" : "/usr/share/arangodb3/js", "deprecatedIn" : null, "description" : "A path to the directory containing the JavaScript startup scripts.", "dynamic" : false, @@ -4249,7 +4248,7 @@ "agent", "single" ], - "default" : "", + "default" : "-", "deprecatedIn" : null, "description" : "shortcut for '--log.output file://'", "dynamic" : false, diff --git a/site/data/3.12/arangodump.json b/site/data/3.12/arangodump.json index 993897235c..f83141f14a 100644 --- a/site/data/3.12/arangodump.json +++ b/site/data/3.12/arangodump.json @@ -1390,7 +1390,7 @@ }, "server.authentication" : { "category" : "option", - "default" : false, + "default" : true, "deprecatedIn" : null, "description" : "Require authentication credentials when connecting (does not affect the server-side authentication settings).", "dynamic" : false, @@ -1454,7 +1454,7 @@ "server.endpoint" : { "category" : "option", "default" : [ - "http+tcp://127.0.0.1:8529" + "tcp://127.0.0.1:8529" ], "deprecatedIn" : null, "description" : "The endpoint to connect to. Use 'none' to start without a server. Use http+ssl:// as schema to connect to an SSL-secured server endpoint, otherwise http+tcp:// or unix://", diff --git a/site/data/3.12/arangoexport.json b/site/data/3.12/arangoexport.json index 8d28675404..eb02e7e1bd 100644 --- a/site/data/3.12/arangoexport.json +++ b/site/data/3.12/arangoexport.json @@ -1126,7 +1126,7 @@ }, "server.authentication" : { "category" : "option", - "default" : false, + "default" : true, "deprecatedIn" : null, "description" : "Require authentication credentials when connecting (does not affect the server-side authentication settings).", "dynamic" : false, @@ -1190,7 +1190,7 @@ "server.endpoint" : { "category" : "option", "default" : [ - "http+tcp://127.0.0.1:8529" + "tcp://127.0.0.1:8529" ], "deprecatedIn" : null, "description" : "The endpoint to connect to. Use 'none' to start without a server. Use http+ssl:// as schema to connect to an SSL-secured server endpoint, otherwise http+tcp:// or unix://", diff --git a/site/data/3.12/arangoimport.json b/site/data/3.12/arangoimport.json index 1e80aee864..8bd9f15009 100644 --- a/site/data/3.12/arangoimport.json +++ b/site/data/3.12/arangoimport.json @@ -1325,7 +1325,7 @@ }, "server.authentication" : { "category" : "option", - "default" : false, + "default" : true, "deprecatedIn" : null, "description" : "Require authentication credentials when connecting (does not affect the server-side authentication settings).", "dynamic" : false, @@ -1389,7 +1389,7 @@ "server.endpoint" : { "category" : "option", "default" : [ - "http+tcp://127.0.0.1:8529" + "tcp://127.0.0.1:8529" ], "deprecatedIn" : null, "description" : "The endpoint to connect to. Use 'none' to start without a server. Use http+ssl:// as schema to connect to an SSL-secured server endpoint, otherwise http+tcp:// or unix://", diff --git a/site/data/3.12/arangoinspect.json b/site/data/3.12/arangoinspect.json index e4697603be..35900e000e 100644 --- a/site/data/3.12/arangoinspect.json +++ b/site/data/3.12/arangoinspect.json @@ -768,7 +768,7 @@ }, "javascript.startup-directory" : { "category" : "option", - "default" : "./js", + "default" : "/usr/share/arangodb3/js", "deprecatedIn" : null, "description" : "The startup paths containing the JavaScript files.", "dynamic" : false, @@ -1666,7 +1666,7 @@ "server.endpoint" : { "category" : "option", "default" : [ - "http+tcp://127.0.0.1:8529" + "tcp://127.0.0.1:8529" ], "deprecatedIn" : null, "description" : "The endpoint to connect to. Use 'none' to start without a server. Use http+ssl:// as schema to connect to an SSL-secured server endpoint, otherwise http+tcp:// or unix://", diff --git a/site/data/3.12/arangorestore.json b/site/data/3.12/arangorestore.json index 5ea3162566..955a95df2e 100644 --- a/site/data/3.12/arangorestore.json +++ b/site/data/3.12/arangorestore.json @@ -1373,7 +1373,7 @@ }, "server.authentication" : { "category" : "option", - "default" : false, + "default" : true, "deprecatedIn" : null, "description" : "Require authentication credentials when connecting (does not affect the server-side authentication settings).", "dynamic" : false, @@ -1437,7 +1437,7 @@ "server.endpoint" : { "category" : "option", "default" : [ - "http+tcp://127.0.0.1:8529" + "tcp://127.0.0.1:8529" ], "deprecatedIn" : null, "description" : "The endpoint to connect to. Use 'none' to start without a server. Use http+ssl:// as schema to connect to an SSL-secured server endpoint, otherwise http+tcp:// or unix://", diff --git a/site/data/3.12/arangosh.json b/site/data/3.12/arangosh.json index 759a63a27b..50c70f44db 100644 --- a/site/data/3.12/arangosh.json +++ b/site/data/3.12/arangosh.json @@ -426,7 +426,7 @@ }, "javascript.allow-external-process-control" : { "category" : "option", - "default" : true, + "default" : false, "deprecatedIn" : null, "description" : "Allow the execution and control of external processes from within JavaScript actions.", "dynamic" : false, @@ -446,7 +446,7 @@ }, "javascript.allow-port-testing" : { "category" : "option", - "default" : true, + "default" : false, "deprecatedIn" : null, "description" : "Allow the testing of ports from within JavaScript actions.", "dynamic" : false, @@ -749,7 +749,6 @@ "javascript.module-directory" : { "category" : "option", "default" : [ - "./enterprise/js" ], "deprecatedIn" : null, "description" : "Additional paths containing JavaScript modules.", @@ -769,7 +768,7 @@ }, "javascript.startup-directory" : { "category" : "option", - "default" : "./js", + "default" : "/usr/share/arangodb3/js", "deprecatedIn" : null, "description" : "The startup paths containing the JavaScript files.", "dynamic" : false, @@ -1603,7 +1602,7 @@ }, "server.authentication" : { "category" : "option", - "default" : false, + "default" : true, "deprecatedIn" : null, "description" : "Require authentication credentials when connecting (does not affect the server-side authentication settings).", "dynamic" : false, @@ -1667,7 +1666,7 @@ "server.endpoint" : { "category" : "option", "default" : [ - "http+tcp://127.0.0.1:8529" + "tcp://127.0.0.1:8529" ], "deprecatedIn" : null, "description" : "The endpoint to connect to. Use 'none' to start without a server. Use http+ssl:// as schema to connect to an SSL-secured server endpoint, otherwise http+tcp:// or unix://.",