====== 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 [[https://docs.icinga.com/icinga2/latest/doc/module/icinga2/chapter/distributed-monitoring#distributed-monitoring-top-down-config-sync|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 [[https://docs.icinga.com/icinga2/latest/doc/module/icinga2/chapter/distributed-monitoring#distributed-monitoring-scenarios-ha-master-clients|6.10.2]] and [[https://docs.icinga.com/icinga2/latest/doc/module/icinga2/chapter/distributed-monitoring#distributed-monitoring-scenarios-master-satellite-client|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]].