Icinga2 Zones

Icinga2 introduces the concept of Zones, which you may be tempted to think of as "parts of your network" or "regions of your business".

Don't.

Even the documentation for Icinga2's hierarchical monitoring setup gives the misleading example of Zones named Europe, USA and Asia (section 6.9.3).

Unless you have only one machine in each location (Europe, USA and Asia), this naming will get either you, or Icinga (or both) woefully confused :-(

The golden rule for Icinga2 Zones is:

  • each Endpoint exists in exactly one Zone, and each Zone contains exactly one Endpoint

The only exceptions are:

  • when you have a High-Availability Master pair (see sections 6.10.2 and 6.10.3) - then both machines belong in the same Zone.
  • when you are performing the service checks over SSH - then all machines being checked by a single Icinga server belong to the Zone associated with that Icinga server.

Go up
Return to main index.