Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

L'

...

Or almost everyone. Think about an administrator who has a distributed architecture around the world. With the current Shinken Enterprise architecture the administrator can put a couple of scheduler/poller daemons in Europe and another set in Asia, but he cannot "tag" hosts in Asia to be checked by the asian scheduler . Also trying to check an asian server with an european scheduler can be very sub-optimal, read very sloooow. The hosts are dispatched to all schedulers and satellites so the administrator cannot be sure that asian hosts will be checked by the asian monitoring servers.

In the normal Shinken Enterprise Architecture is useful for load balancing with high availability, for single site.

Shinken Enterprise provides a way to manage different geographic or organizational sites.

We will use a generic term for this site management, Realms.

Realms in few words 

A realm is a pool of resources (scheduler, poller, reactionner, receiver and broker) that hosts or hostgroups that can be attached to. A host or hostgroup can be attached to only one realm. All "dependancies" or parents of this hosts must be in the same realm. A realm can be tagged "default"' and realm untagged hosts will be put into it. In a realm, pollers, reactionners and brokers will only get jobs from schedulers of the same realm.

Realms are different than the poller_tags

Make sure to undestand when to use realms and when to use poller_tags.

  • realms are used to segregate schedulers
  • poller_tags are used to segregate pollers

For some cases poller_tag functionality could also be done using Realms. The question you need to ask yourself: Is a poller_tag "enough", or do you need to fully segregate a the scheduler level and use Realms. In realms, schedulers do not communicate with schedulers from other Realms:

  • If you just need a poller in a DMZ network: use poller_tag
  • If you need a scheduler/poller in a customer LAN: use realms

Sub realms 

A realm can contain another realm. It does not change anything for schedulers: they are only responsible for hosts of their realm not the ones of the sub realms. The realm tree is useful for satellites like reactionners or brokers: they can get jobs from the schedulers of their realm, but also from schedulers of sub realms. Pollers can also get jobs from sub realms, but it's less useful so it's disabled by default. Warning: having more than one broker in a scheduler is not a good idea. The jobs for brokers can be taken by only one broker. For the Arbiter it does not change a thing: there is still only one Arbiter and one configuration whatever realms you have.

 

Example of realm usage 

Let's take a look at two distributed environnements. In the first case the administrator wants totally distinct daemons. In the second one he just wants the schedulers/pollers to be distincts, but still have one place to send notifications (reactionners) and one place for database export (broker).

Distincts realms :

Image Removed

 

...

 

...

architecture de Shinken Enterprise permet a un administrateur d'avoir un point central de configuration et ce, indépendamment du nombre de Schedulers, Pollers, Reactionners et Brokers. Les hôtes et leurs checks sont repartis entre les Schedulers et les satellites (Pollers/Reactionners/Brokers) reçoivent des actions à exécuter de ces Schedulers.Tout fonctionne bien...

Ou presque ! En fait, si vous avez une architecture distribuée sur plusieurs continents, vous pouvez avoir des problèmes.  Si l'architecture est commune à plusieurs réseaux, un scheduler d'un client A peut avoir un Poller d'un client B lui demandant des tâches.. Ce n'est pas une bonne idée pour des questions d'efficacité du réseau (même avec un réseau distribué) 

C'est là que devient intéressante la gestion des clients par site. Dans Shinken Enterprise, on le gère à travers les "royaumes"..

Un royaume est un groupe de ressources qui va gérer les hôtes et les groupes d'hôtes. Ce lien doit être unique, un hôte ne peut pas appartenir à plusieurs royaumes. Si vous mettez un groupe d'hôtes dans un royaume, tous les hôtes rattachés feront partie de ce royaume (sauf si vous avez déjà défini un royaume particulier sur un hôte) 

Dans un royaume, tous les pollers vont prendre les tâches de tous les schedulers de ce royaume. 

Les royaumes en quelques mots

Un royaume est un groupe de ressources qui va gérer les hôtes et les groupes d'hôtes. Ce lien doit être unique, un hôte ne peut pas appartenir à plusieurs royaumes. Si vous mettez un groupe d'hôtes dans un royaume, tous les hôtes rattachés feront partie de ce royaume (sauf si vous avez déjà défini un royaume particulier sur un hôte) 

Dans un royaume, tous les pollers vont prendre les tâches de tous les schedulers de ce royaume. 

Les royaumes sont différents des poller_tags

Vérifiez que vous comprenez bien quand utiliser les royaumes et quand utiliser les poller_tags.

  • les royaumes sont faits pour séparer les schedulers
  • les poller_tags sont faits pour séparer les pollers

Dans certains cas, la fonctionnalité de poller_tag peut être faite en utilisant les royaumes. La question à se poser est  : est-ce suffisant ? ou devez-vous séparer totalement au niveau du scheduler en utilisant les royaumes. 

  • si vous avez juste besoin d'un poller dans une DMZ : utiliser le poller_tag
  • si vous avez besoin d'un scheduler/poller dans un LAN client: utiliser les royaumes

Les sous-royaumes 

Un royaume peut avoir des sous-royaumes. Cela ne change rien pour les schedulers., mais peut être utile pour les autres satellites et spare.  Les reactionners et brokers sont liés au même royaume, mais ils peuvent traiter les tâches des sous-royaumes également.De cette façon, vous pouvez avoir moins de reactionners et de brokers.

Cela se fait grâce au paramètre manage_sub_realms . Pour les pollers la valeur par défaut est 0, mais c'est 1 pour reactionners/brokers.

Exemple d'usage de royaumes 

Prenons 2 exemples d'architecture distribuée à travers le monde Dans le 1er cas, l'administrateur ne souhaite pas partager les ressources entre royaumes. Dans le second, les reactionners et brokers sont partagés entre royaumes. (donc toutes les notifications sont envoyées d'un seul endroit, idem pour le stockage des données) .

Royaumes distincts  :

Image Added



 


Usage plus classique : 

Image Added


Les satellites peuvent être utilisés pour leurs royaumes ou sous royaumes. 

Description des variables

 

PropriétéDéfaut

 

Variable Descriptions

 

PropertyDefault
Description
realm_nameN/A
This variable is used to identify the *short name* of the realm
Cette variable est utilisée pour identifier le nom raccourci du royaume.
realm_membersN/A
This directive is used to list realm sub-realms.default0This directive is used to define if the realm is the default one or not. Only one default realm is allowed.

Example Definition

...

Cette directive est utilisée pour lister les sous-royaumes .
broker_complete_links0Si placé à 1, ceci autorise les brokers à être plusieurs à prendre les informations d'un même scheduler. Dans le cas par défaut (0), un broker unique est assigné à un scheduler, ce qui empèche de voir ses données dans un realm de plus haut niveau si un broker est déjà présent dans son royaume.
default0Cette directive est utilisée pour définir si il s'agit du royaume par défaut ou non. Un seul est autorisé comme "par défaut"
Code Block
  define realm{
      realm_name     World
      realm_members  Europe,America,Asia
      default        0
  }