Comment créer un hôte

Pour créer un nouvel hôte, utilisez le bouton "Add new [Host]" dans le menu Action. Un formulaire vide de création d'hôte apparaît.

Ce formulaire contient différentes catégories sous forme d'onglets :

  • Generic

  • Data

  • Monitoring

  • Checks

  • Notifications

  • Advanced

Le menu gauche permet aux Administrateurs de :

  • Valider le nouvel hôte
  • Annuler l'action
  • Supprimer l'hôte

 

A chaque catégorie un formulaire spécifique est affiché.

  

Onglet : Generic

Contient les propriétés les plus communes d'un hôte :

  • Name

    • le nom de l'hôte

    • ce champ est obligatoire

  • Description

    • description qui sera affiché dans le widget de l'hôte
    • si le champ n'est pas rempli, le nom sera affiché

  • Address

    • adresse de l'hôte dans le réseau
    • cela peut être une adresse IP ou un nom d'hôte resolvable (Short ou FQDN)

  • Host Templates to inherit

    • liste des templates dont le nouvel hôte héritera
    • des noms de templates sont suggérés dès que l'on commence à remplir le champs

  • Add in Hostgroups

    • liste des groupes disponibles dans lesquels le nouvel hôte doit être
    • il est possible de sélectionner plus d'un groupe d'hôtes

  • Realm

    • royaume d'où l'hôte doit être supervisé
    • un seul choix possible

  • Priority

    • cette fonction sert à afficher le niveau de criticité de l'hôte (valeur de 1 à 6)
    • il n'y a pas d'impact sur la méthode de vérification ou les notifications
    • par défaut, le niveau du template d'hôte est utilisé

  • Network parents

    • ce champs sert à déterminer les hôtes situés entre le Poller et ce nouvel hôte
    • l'information dans ce champ aide à la résolution des problèmes et a un impact sur le calcul

  • Enabled

    • cette propriété définie si l'hôte sera activé et donc utilisé par Shinken Enterprise ou non
    • un hôte désactivé existe toujours dans la configuration, mais n'est pas planifié, et n'est pas visible dans l'interface Web.
    • Par défaut, cette valeur est héritée du template

 

 

 

  

Onglet : Data

 

Sert à afficher et créer les variables utilisées par Shinken Enterprise pour effectuer les checks.

Ces valeurs sont aussi appelées Macros.

Comme montré sur l'image, à la création dans nouvel hôte, il n'y a pas de données disponibles, même si ce nouvel hôte hérite d'un template

 

 

 

Pour voir les données qui seront appliquées à l'hôte, il faut d'abord valider cet hôte, et revenir à la configuration

 

 

 

 

 

 

Les données sont affichées en 2 sections :

  • Local to the element : données pour cet hôte uniquement (données custom)
  • From templates : données héritées d'un ou plusieurs templates

Les données des templates sont séparées par noms de template

Cela permet aux administrateurs de voir quelles données et d'où elles ont été récupérées

Les données sont représentées par 2 éléments : une Clé et une Valeur

Quand les données sont de type local, les 2 éléments peuvent être modifiés

Quand les données sont From templates, seules les valeurs peuvent être modifiées

  

Onglet : Monitoring

Permet de configurer les propriétés qui définissent la supervision de l'hôte.

La supervison est définie par les propriétés suivantes :

  • Check Period
    • définit quand l'hôte sera vérifié
    • le champ est une liste de valeurs correspondantes aux périodes de temps définies dans Time Periods
    • la valeur du template (s'il y en a) sera prise, sinon il y aura une valeur par défaut
  • Check Command
    • définit le nom de la commande utilisé pour vérifier si l'hôte est disponible
    • le champ est une liste de choix, définie par la configuration Commands
    • la valeur du template (s'il y en a) sera prise, sinon il y aura une valeur par défaut
    • Args:
      • utilisé pour passer les arguments à la commande de vérification
      • par défaut cette valeur est vide
  • Max Check Attempts
    • définit le nombre de tentatives en cas d'échecs des vérifications, avant de signaler l'hôte comme "down"
    • la valeur du template (s'il y en a ) sera prise, sinon il y aura une valeur par défaut
  • Check Interval
    • définit le nombre de minutes entre 2 vérifications de l'hôte
    • la valeur du template (s'il y en a ) sera prise, sinon il y aura une valeur par défaut
  • Retry Interval
    • définit le nombre de minutes avant de replanifier une nouvelle vérification si la dernière a retourné un status "non-UP"
    • la valeur du template (s'il y en a ) sera prise, sinon il y aura une valeur par défaut



  • Active Checks Enabled
    • définit l'activation des Checks planifiés pour cet hôte
    • la valeur du template (s'il y en a ) sera prise, sinon il y aura une valeur par défaut

  • Passive Checks Enabled

    • définit l'activation des Checks passifs pour cet hôte
    • la valeur du template (s'il y en a ) sera prise, sinon il y aura une valeur par défaut

  • Maintenance Period

    • définit une période de maintenance (donwtime) récurrente pour cet hôte.
      pendant cette période, aucune notification n'est envoyée
    • la valeur est prise dans la liste Time Periods
    • la valeur est nulle par défaut (pas de période de maintenance pour cet hôte)

 

 

 

 

 

  

Checks

Fournit les informations à propos des Checks définis pour cet hôte.

Par défaut, s'il n'y a pas de template appliqué à cet hôte, il n'y aura pas de Checks.

 

 





Si l'hôte hérite d'un template intégrant des Checks, leurs descriptions seront affichées

Dans l'exemple, nous pouvons voir 2 Checks hérités de http template, et de https template.
Ils sont affichés dans un tableau avec les éléments suivants :

  • Nom du Check
  • Groupe de contacts pour le Check
  • Template d'hôte utilisant le Check
  • Commande utilisée
  • "Essayer ce Check" permet d'essayer ce Check avant de valider

Le nom du Check est un lien sur la configuration de ce Check.

  

Notifications

Notification affiche tous les champs nécessaires à la configuration des notifications :

  • Notification Enabled
    • active/désactive les notifications pour cet hôte
    • la valeur du template (s'il y en a) sera prise, sinon "active" sera la valeur par défaut
  • Contacts
    • Champ multi-valeurs définissants les contacts à notifier
    • les valeurs viennent de la configuration de Contact, et sont affichées dans une liste de noms
    • la valeur du template (s'il y en a) sera prise, sinon le champ sera vide par défaut
  • Contacts groups
    • Champ multi-valeur, définissant les groupes de contacts à notifier
    • les valeurs viennent de la configuration de Contact Group, et sont affichées dans une liste de noms
    • la valeur du template (s'il y en a) sera prise, sinon le champ sera vide par défaut
  • Notification Interval
    • permet de paramétrer le nombre de minutes avant de re-notifier les contacts
    • la valeur du template (s'il y en a ) sera prise, sinon il y aura une valeur par défaut
  • Notification Period
    • permet de spécifier les périodes de temps pendant lesquelles envoyer les notifications
    • la liste des valeurs correspond àist of value corresponds to Time Periods defined
    • la valeur du template (s'il y en a ) sera prise, sinon il y aura une valeur par défaut
  • Notification Options 
    • liste des flags, utilisé pour déterminer quel état devrait générer une notification
    • field is a list of values seperated by a comma :
      • d : down
      • u : unreachable
      • r : recovery
      • f : flapping
      • s : scheduled downtime
      • n : none
    • list of value is taken from templates if any, or default value is provided (d,u,r,f)

  • First notification delay
    • number of minutes, used to set the delay before sending a notification
    • if 0 is provided, notifications are sent immediatly for the host
    • value is taken from templates if any, or default value is provided
  • Escalations
    • multi values field, used to set escalations object on the host
    • list of values is taken from Escalation Configuration
    • value is taken from templates if any, or default value is provided

 

 

 

 

 

 

  

Advanced

Advanced form is used to set advanced features of monitoring.

  • Poller Tag
    • this field provides a list of Pollers configured (see Define new pollers)
    • only one value can be provided
    • value is taken from templates if any, or default value is provided
  • Process Perf Data
    • used to enable or disable the Perf Data Process for the host
    • value is taken from templates if any, or default value is provided
  • Flap Detection Enabled
    • used to enable or disable the flap detection for the host
    • value is taken from templates if any, or default value is provided
  • Flapping Options 
    • used to determine what host states should be used to detect flapping
    • value is a list of comma seperated flags, making a combination of following values :
      • o : UP
      • d : DOWN
      • u : UNREACHABLE
    • value is taken from templates if any, or default value is provided
  • Low Flap
    • percentage used to determine the low state threshold for the flap detection calculation
    • value is set using an horizontal cursor
    • if value of 0 is provided, the global threshold will be used
    • default value is 0
  • High Flap
    • percentage used to determine the high state threshold for the flap detection calculation
    • value is set using an horizontal cursor
    • if value of 0 is provided, the global threshold will be used
    • default value is 0
  • Automatic Event Handler 
    • value used to determine if event handler is enabled or disabled
    • value is taken from templates if any, or default value is provided
  • Event Handler command
    • used to set the command that should be run when a change of state is detected
    • field is a list of Commands configured
    • Args can be provided to the selected command
    • value is taken from templates if any, or default value is provided

 

  • Check Freshness
    • used to determine if freshness must be enabled or disabled 
    • value is taken from templates if any, or default value is provided
  • Freshness Threshold
    • used to set the freshness threshold, in seconds
    • if 0 is provide das value, Shinken will try to set it automaticaly
    • value is taken from templates if any, or default value is provided
  • Macro modulations 
    • used to set a modulation of macro values, giving possibility
      to set different threshold based on time period
    • the field is a list of Data Modulation
    • value is taken from templates if any, or default value is provided
  • Checks to exclude
    • used to exclude some automatically generated checks (like on the host templates) for this host
    • the field is a comma separated list of Checks
    • value is taken from templates if any, or default value is provided