commit 4ff749e8809be1fb46240cbb750df0331955383b
parent 326f27dfab220beae53a76f72cfc648830359f39
Author: Christian Grothoff <christian@grothoff.org>
Date: Sun, 2 Feb 2025 23:11:02 +0100
update uptime-kuma manual
Diffstat:
1 file changed, 28 insertions(+), 9 deletions(-)
diff --git a/system-administration/uptime-kuma.rst b/system-administration/uptime-kuma.rst
@@ -95,16 +95,15 @@ Monitoring exchanges
To monitor an exchange, we want to not merely monitor that the REST API is operational,
but also check that the ``/keys`` response is not outdated. This can be done by computing
the minimum expiration time over all of the maxima of the different keys in the response.
-For an exchange with P2P payments enabled, the HTTP(S) - JSON Query method can be
+The HTTP(S) - JSON Query method can be
used using the following query written in https://jsonata.org/:
-
+
.. code-block:: text
- $min($append($append(
- [$max($map(global_fees, function($f) { $f.end_date.t_s}))],
- [$max($map(signkeys, function($f) { $f.stamp_expire.t_s}))]),
+ $min($append(
+ [$max($map(signkeys, function($f) { $f.stamp_expire.t_s}))],
[$max($map(denominations,
- function ($a){
+ function ($a){
$max($map($a.denoms,
function ($d){
$d.stamp_expire_withdraw.t_s
@@ -113,11 +112,31 @@ used using the following query written in https://jsonata.org/:
}
))])) > $millis()/1000
+We setup a separate monitor to check that wire fees are working
+(sure, they can be combined, but this way we can get a more precise alert):
+
+.. code-block:: test
+
+ $max(wire_fees[*].[*].end_date.t_s) > $millis()/1000
+
+To separate-out global fees monitoring (which is not present on all systems),
+we also use (except on GLS, which doesn't support P2P):
+
+.. code-block:: test
+
+ $max(global_fees[*].end_date.t_s) > $millis()/1000
+
Exchanges to monitor include:
- exchange.taler-ops.ch
- exchange.e.netzbon-basel.ch
- exchange.demo.taler.net
-- exchange.head.taler.net
-- exchange.test.taler.net
-
+[- exchange.head.taler.net]
+[- exchange.test.taler.net]
+
+
+Tagging monitors
+================
+
+We tag each monitor with the host that the service
+is running on (e.g. firefly.gnunet.org).