Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Enhance documentation regarding internal icinga config sync check #10101

Open
wants to merge 8 commits into
base: master
Choose a base branch
from
Open

Enhance documentation regarding internal icinga config sync check #10101

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
8 commits
Select commit Hold shift + click to select a range
7a3665b
Update 10-icinga-template-library.md
ChrLau Jul 23, 2024
92a0488
Update 15-troubleshooting.md
ChrLau Jul 23, 2024
bb25ba3
Update 15-troubleshooting.md
ChrLau Jul 23, 2024
71fb1e4
Revert "Update 15-troubleshooting.md"
ChrLau Jul 23, 2024
f609912
Update AUTHORS
ChrLau Jul 24, 2024
44a23a0
Update doc/15-troubleshooting.md
ChrLau Jul 24, 2024
a64104a
Update doc/10-icinga-template-library.md
ChrLau Jul 24, 2024
aad252e
Update doc/15-troubleshooting.md
ChrLau Jul 24, 2024
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
1 change: 1 addition & 0 deletions AUTHORS
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -52,6 +52,7 @@ Christian Gut <[email protected]>
Christian Harke <[email protected]>
Christian Jonak <[email protected]>
Christian Lehmann <[email protected]>
Christian Lauf <[email protected]>
Christian Loos <[email protected]>
Christian Schmidt <[email protected]>
Christopher Peterson <[email protected]>
Expand Down
6 changes: 4 additions & 2 deletions doc/10-icinga-template-library.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -75,8 +75,10 @@ plugin scripts.

### icinga <a id="itl-icinga"></a>

Check command for the built-in `icinga` check. This check returns performance
data for the current Icinga instance, reports as warning if the last reload failed and optionally allows for minimum version checks.
Check command for the built-in `icinga` check. This check returns performance data for the current Icinga instance,
reports as warning if the last reload or config sync failed and optionally allows for minimum version checks.

For the config sync check to work, it must be run on the satellite or agent.

Custom variables passed as [command parameters](03-monitoring-basics.md#command-passing-parameters):

Expand Down
3 changes: 3 additions & 0 deletions doc/15-troubleshooting.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1640,6 +1640,9 @@ Typical errors are:
* The api feature doesn't [accept config](06-distributed-monitoring.md#distributed-monitoring-top-down-config-sync). This is logged into `/var/lib/icinga2/icinga2.log`.
* The received configuration zone is not configured in [zones.conf](04-configuration.md#zones-conf) and Icinga denies it. This is logged into `/var/lib/icinga2/icinga2.log`.
* The satellite/agent has local configuration in `/etc/icinga2/zones.d` and thinks it is authoritive for this zone. It then denies the received update. Purge the content from `/etc/icinga2/zones.d`, `/var/lib/icinga2/api/zones/*` and restart Icinga to fix this.
* Configuration parts stored outside of `/etc/icinga2/zones.d` on the master, for example a constant in `/etc/icinga2/constants.conf`, are then missing on the satellite/agent.

Note that if set up, the [built-in icinga CheckCommand](10-icinga-template-library.md#icinga) will notify you in case the config sync wasn't successful.

#### New configuration does not trigger a reload <a id="troubleshooting-cluster-config-sync-no-reload"></a>

Expand Down