Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 7 additions & 7 deletions site/data/3.10/arangod.json
Original file line number Diff line number Diff line change
Expand Up @@ -1109,7 +1109,7 @@
"agent",
"single"
],
"default" : 7739683840,
"default" : 7739680768,
"deprecatedIn" : null,
"description" : "The global size limit for all caches (in bytes).",
"dynamic" : true,
Expand Down Expand Up @@ -7273,15 +7273,15 @@
"type" : "boolean"
},
"query.global-memory-limit" : {
"base" : 33106219008,
"base" : 33106206720,
"category" : "option",
"component" : [
"coordinator",
"dbserver",
"agent",
"single"
],
"default" : 26816037397,
"default" : 26816027443,
"deprecatedIn" : null,
"description" : "The memory threshold for all AQL queries combined (in bytes, 0 = no limit).",
"dynamic" : true,
Expand Down Expand Up @@ -7539,15 +7539,15 @@
"type" : "double"
},
"query.memory-limit" : {
"base" : 33106219008,
"base" : 33106206720,
"category" : "option",
"component" : [
"coordinator",
"dbserver",
"agent",
"single"
],
"default" : 19863731405,
"default" : 19863724032,
"deprecatedIn" : null,
"description" : "The memory threshold per AQL query (in bytes, 0 = no limit).",
"dynamic" : true,
Expand Down Expand Up @@ -8659,7 +8659,7 @@
"agent",
"single"
],
"default" : 9287620608,
"default" : 9287616921,
"deprecatedIn" : null,
"description" : "The size of block cache (in bytes).",
"dynamic" : true,
Expand Down Expand Up @@ -11006,7 +11006,7 @@
"agent",
"single"
],
"default" : 12383494144,
"default" : 12383489228,
"deprecatedIn" : null,
"description" : "The maximum total size of in-memory write buffers (0 = unbounded).",
"dynamic" : true,
Expand Down
14 changes: 7 additions & 7 deletions site/data/3.11/arangod.json
Original file line number Diff line number Diff line change
Expand Up @@ -1400,7 +1400,7 @@
"agent",
"single"
],
"default" : 7739683840,
"default" : 7739680768,
"deprecatedIn" : null,
"description" : "The global size limit for all caches (in bytes).",
"dynamic" : true,
Expand Down Expand Up @@ -7548,15 +7548,15 @@
"type" : "boolean"
},
"query.global-memory-limit" : {
"base" : 33106219008,
"base" : 33106206720,
"category" : "option",
"component" : [
"coordinator",
"dbserver",
"agent",
"single"
],
"default" : 26816037397,
"default" : 26816027443,
"deprecatedIn" : null,
"description" : "The memory threshold for all AQL queries combined (in bytes, 0 = no limit).",
"dynamic" : true,
Expand Down Expand Up @@ -7846,15 +7846,15 @@
"type" : "double"
},
"query.memory-limit" : {
"base" : 33106219008,
"base" : 33106206720,
"category" : "option",
"component" : [
"coordinator",
"dbserver",
"agent",
"single"
],
"default" : 19863731405,
"default" : 19863724032,
"deprecatedIn" : null,
"description" : "The memory threshold per AQL query (in bytes, 0 = no limit).",
"dynamic" : true,
Expand Down Expand Up @@ -9089,7 +9089,7 @@
"agent",
"single"
],
"default" : 9287620608,
"default" : 9287616921,
"deprecatedIn" : null,
"description" : "The size of block cache (in bytes).",
"dynamic" : true,
Expand Down Expand Up @@ -11670,7 +11670,7 @@
"agent",
"single"
],
"default" : 12383494144,
"default" : 12383489228,
"deprecatedIn" : null,
"description" : "The maximum total size of in-memory write buffers (0 = unbounded).",
"dynamic" : true,
Expand Down
40 changes: 40 additions & 0 deletions site/data/3.12/allMetrics.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -2299,6 +2299,46 @@
If an error is logged then it should be taken seriously as it may require
user intervention to solve.

- name: arangodb_logger_messages_dropped_total
introducedIn: "3.12.1"
help: |
Total number of dropped log messages.
unit: number
type: counter
category: Statistics
complexity: simple
exposedBy:
- agent
- coordinator
- dbserver
- single
description: |
Total number of log messages that were dropped by the logger.

Log messages that are produced by worker threads are pushed into a log
queue that is owned by a dedicated logger thread. This dedicated log
thread is then responsible for writing the log messages out to disk or
stdout asynchronously.
As there can be many threads that produce log messages, but only one
thread that consumes and logs messages from the log queue, it is possible
that the log queue grows too large, potentially consuming a lot of
memory to buffer all non-consumed log messages in RAM.
In order to prevent the log queue from using too much memory, its size
is bounded. The startup option `--log.max-queued-entries` controls the
maximum size of the log queue.
Whenever the log queue has reached its capacity limit and a log producer
thread tries to push a log message to the log queue, the log message
will be dropped. For every dropped log message this metric will be
increased by one, so it becomes visible that log messages were dropped.
troubleshoot: |
In case this metric is greater than one, there is too much logging
going on for the log thread to keep up with incoming log messages. There
are two ways to counteract this.
Either the log levels needed to be lowered (e.g. from "trace" to "debug"
or from "debug" to "info"), or the maximum capacity of the log queue
needs to be increased. This can be achieved by adjusting the value of
the startup option `--log.max-queued-entries` to a higher value.

- name: arangodb_logger_warnings_total
introducedIn: "3.9.0"
help: |
Expand Down
16 changes: 8 additions & 8 deletions site/data/3.12/arangod.json
Original file line number Diff line number Diff line change
Expand Up @@ -1353,7 +1353,7 @@
"agent",
"single"
],
"default" : 7739683840,
"default" : 7739680768,
"deprecatedIn" : null,
"description" : "The global size limit for all caches (in bytes).",
"dynamic" : true,
Expand Down Expand Up @@ -2764,7 +2764,7 @@
"dbserver",
"single"
],
"default" : 6191747072,
"default" : 6191744614,
"deprecatedIn" : null,
"description" : "Maximum memory usage (in bytes) to be used by all ongoing dumps.",
"dynamic" : true,
Expand Down Expand Up @@ -5473,15 +5473,15 @@
"type" : "boolean"
},
"query.global-memory-limit" : {
"base" : 33106219008,
"base" : 33106206720,
"category" : "option",
"component" : [
"coordinator",
"dbserver",
"agent",
"single"
],
"default" : 26816037397,
"default" : 26816027443,
"deprecatedIn" : null,
"description" : "The memory threshold for all AQL queries combined (in bytes, 0 = no limit).",
"dynamic" : true,
Expand Down Expand Up @@ -5757,15 +5757,15 @@
"type" : "double"
},
"query.memory-limit" : {
"base" : 33106219008,
"base" : 33106206720,
"category" : "option",
"component" : [
"coordinator",
"dbserver",
"agent",
"single"
],
"default" : 19863731405,
"default" : 19863724032,
"deprecatedIn" : null,
"description" : "The memory threshold per AQL query (in bytes, 0 = no limit).",
"dynamic" : true,
Expand Down Expand Up @@ -6876,7 +6876,7 @@
"agent",
"single"
],
"default" : 9287620608,
"default" : 9287616921,
"deprecatedIn" : null,
"description" : "The size of block cache (in bytes).",
"dynamic" : true,
Expand Down Expand Up @@ -9411,7 +9411,7 @@
"agent",
"single"
],
"default" : 12383494144,
"default" : 12383489228,
"deprecatedIn" : null,
"description" : "The maximum total size of in-memory write buffers (0 = unbounded).",
"dynamic" : true,
Expand Down
40 changes: 40 additions & 0 deletions site/data/3.13/allMetrics.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -2299,6 +2299,46 @@
If an error is logged then it should be taken seriously as it may require
user intervention to solve.

- name: arangodb_logger_messages_dropped_total
introducedIn: "3.12.1"
help: |
Total number of dropped log messages.
unit: number
type: counter
category: Statistics
complexity: simple
exposedBy:
- agent
- coordinator
- dbserver
- single
description: |
Total number of log messages that were dropped by the logger.

Log messages that are produced by worker threads are pushed into a log
queue that is owned by a dedicated logger thread. This dedicated log
thread is then responsible for writing the log messages out to disk or
stdout asynchronously.
As there can be many threads that produce log messages, but only one
thread that consumes and logs messages from the log queue, it is possible
that the log queue grows too large, potentially consuming a lot of
memory to buffer all non-consumed log messages in RAM.
In order to prevent the log queue from using too much memory, its size
is bounded. The startup option `--log.max-queued-entries` controls the
maximum size of the log queue.
Whenever the log queue has reached its capacity limit and a log producer
thread tries to push a log message to the log queue, the log message
will be dropped. For every dropped log message this metric will be
increased by one, so it becomes visible that log messages were dropped.
troubleshoot: |
In case this metric is greater than one, there is too much logging
going on for the log thread to keep up with incoming log messages. There
are two ways to counteract this.
Either the log levels needed to be lowered (e.g. from "trace" to "debug"
or from "debug" to "info"), or the maximum capacity of the log queue
needs to be increased. This can be achieved by adjusting the value of
the startup option `--log.max-queued-entries` to a higher value.

- name: arangodb_logger_warnings_total
introducedIn: "3.9.0"
help: |
Expand Down
16 changes: 8 additions & 8 deletions site/data/3.13/arangod.json
Original file line number Diff line number Diff line change
Expand Up @@ -1353,7 +1353,7 @@
"agent",
"single"
],
"default" : 7739683840,
"default" : 7739680768,
"deprecatedIn" : null,
"description" : "The global size limit for all caches (in bytes).",
"dynamic" : true,
Expand Down Expand Up @@ -2764,7 +2764,7 @@
"dbserver",
"single"
],
"default" : 6191747072,
"default" : 6191744614,
"deprecatedIn" : null,
"description" : "Maximum memory usage (in bytes) to be used by all ongoing dumps.",
"dynamic" : true,
Expand Down Expand Up @@ -5473,15 +5473,15 @@
"type" : "boolean"
},
"query.global-memory-limit" : {
"base" : 33106219008,
"base" : 33106206720,
"category" : "option",
"component" : [
"coordinator",
"dbserver",
"agent",
"single"
],
"default" : 26816037397,
"default" : 26816027443,
"deprecatedIn" : null,
"description" : "The memory threshold for all AQL queries combined (in bytes, 0 = no limit).",
"dynamic" : true,
Expand Down Expand Up @@ -5757,15 +5757,15 @@
"type" : "double"
},
"query.memory-limit" : {
"base" : 33106219008,
"base" : 33106206720,
"category" : "option",
"component" : [
"coordinator",
"dbserver",
"agent",
"single"
],
"default" : 19863731405,
"default" : 19863724032,
"deprecatedIn" : null,
"description" : "The memory threshold per AQL query (in bytes, 0 = no limit).",
"dynamic" : true,
Expand Down Expand Up @@ -6876,7 +6876,7 @@
"agent",
"single"
],
"default" : 9287620608,
"default" : 9287616921,
"deprecatedIn" : null,
"description" : "The size of block cache (in bytes).",
"dynamic" : true,
Expand Down Expand Up @@ -9411,7 +9411,7 @@
"agent",
"single"
],
"default" : 12383494144,
"default" : 12383489228,
"deprecatedIn" : null,
"description" : "The maximum total size of in-memory write buffers (0 = unbounded).",
"dynamic" : true,
Expand Down