From 1f30ba7675c6eef5560b459aa8ca214657b8cc28 Mon Sep 17 00:00:00 2001 From: Alvar Penning Date: Thu, 8 Jan 2026 17:02:10 +0100 Subject: [PATCH] doc: Explain icingadb built-in check Briefly explain what the built-in icingadb check actually checks and what outputs one can expect. This does not contain every possible check output, but touches the different topics the check verifies. References Icinga/icingadb#1009. --- doc/10-icinga-template-library.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/doc/10-icinga-template-library.md b/doc/10-icinga-template-library.md index 1ad4f55b1..ce1411fed 100644 --- a/doc/10-icinga-template-library.md +++ b/doc/10-icinga-template-library.md @@ -108,6 +108,15 @@ cluster\_lag\_critical | **Optional.** Critical threshold for log lag in seconds ### icingadb Check command for the built-in `icingadb` check. +It performs multiple checks, such as verifying that: + +- Whether the `IcingaDB` object has an active Redis connection. +- Whether the Icinga DB daemon is active and has recently sent a heartbeat to Redis. +- Whether exactly one Icinga DB daemon is claiming responsibility in HA mode. +- Whether Icinga 2 does not take too long dumping the configuration to Redis (_full dump_). +- Whether the Icinga DB daemon does not take too long synchronizing the configuration to the relation database (_full sync_). +- The Redis backlog does not accumulate (_redis backlog_). +- The relational database backlog does not accumulate (_database backlog_). Custom variables passed as [command parameters](03-monitoring-basics.md#command-passing-parameters):