Realm Definition

The realms is an Alignak optional, despite recommended, feature which is very useful if the administrator wants to group / separate the monitored resources.

The Realm definition is optional. If no realm is defined, Alignak will “create” one for the user and it will be the default one.

Syntax

Bold variables are required, while others are optional.

define realm{  
realm_name realm_name
alias alias
realm_members realm_members
group_members group_members
members members
higher_realms higher_realms
default [0/1]
}  

Example

Define the default realm with its sub-realms:

define realm{
    realm_name     World
    realm_members  Europe,America,Asia
    default        1
}

All the hosts and hosts groups that do not have a realm defined will belong to this default realm.

Variables

realm_name
This variable is used to identify the short name of the realm.
alias
This variable is used to define the friendly name of the realm.
higher_realms
This variable is used to define the parent realms of this realms. It is a comma separated list of realms short names that contain the parents realms of the current realm.
realm_members
This variable is used to define the sub-realms of this realms. It is a comma separated list of realms short names that contain the children realms of the current realm.
group_members
This variable is used to define the sub-realms of this realms. It is a comma separated list of hostgroups short names. You can also define the realm an hostgroup belongs to in the host definition.
members
This variable is used to define the hosts of this realms. It is a comma separated list of hosts short names. You can also define the realm an host belongs to in the host definition.
default
This optional directive is used to define that this realm is the default one (untagged host and daemons will be attached to the default realm). The default value is 0.