Versions Compared

Key

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

Onglet : Générique

  • Name
    • Cette propriété permet de définir le nom utilisé pour identifier le template d'hôte.
  • Description
    • Cette propriété permet de définir une description de l'hôte qui pourra être affiché dans les interfaces web.
      Le nom est accessible par l'intermédiaire de la variable de * $HOSTNAME$ *.
      Remarque: Si vous ne spécifiez pas une adresse, la propriété vaudra par défaut le nom du host.
  • Address
    • Cette propriété permet de définir l'adresse de l’hôte. Habituellement, il s'agit de l'adresse IP, bien que cela puisse être n'importe quelle valeur (pour peu qu'elle soit utile pour la détermination du statut de l'hôte).
      Vous pouvez utiliser un FQDN pour l'adresse, mais gardez à l'esprit que si le DNS n'est pas disponible, les vérifications ne pourront pas être faites.
      Le nom est accessible par l'intermédiaire de la variable de * $HOSTNAME$ *.
      Remarque: Si vous ne spécifiez pas une adresse, la propriété vaudra par défaut le nom du host.
      Il y a un risque à utiliser le mécanisme par défaut - Si le DNS n'est pas disponible, la plupart des checks échoueront car les sondes dont ils dépendent ne seront pas capables de résoudre

...

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

...

Image Removed

...

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 :

Nom

    • 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é

...

Adresse

  • 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)

...

Héritage de Templates

  • 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

...

Ajouter dans Groupe d'hôtes

  • 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

...

Royaume

  • royaume from which the host should be monitored
  • only one choice can be made

...

Priority

  • the priority is a feature used to show the criticality level of hosts
    taking value from 1 to 6
  • there is no impact on check method or notifications
  • by default, level of Host Template is used

...

Image Removed

  • Networks parents

    • this field is used to determine hosts located
      between poller and the new Host
    • filling this property helps in problem resolution,
      and in impact calculation
  • Enabled

    • this property determines if the host will be used or not by Shinken
    • a disabled host is still present in configuration, but is not scheduled,
      and is not visible on the WebUI
    • by default, the value is inherited by the template

 

 

 

...

Data

...

Data is used to show and create variables used by Shinken Enterprise to perform checks.

Those values are also called Macros.

As shown on the picture, when creating a new host, no data are available, even if the
new host inherit from Template.

 

 

 

...

To see data that will be applied to host, it is necessary to first validate this host,
and come-back to its configuration.

 

 

 

 

 

 

...

Data are displayed in two sections :

  • Local : data for this host only (custom data)
  • From Templates : data inherited from one or more templates

Data from templates are seperated by template names.

This allow Administrators to see what and where data have been get.

Data are represented by a Key and a Value.

When data are local, both of them can be modified.

When data are inherited, only values can be modified.

...

Monitoring

...

This form is used to configure properties that define monitoring for the host itself.

Monitoring is defined by the following properties :

  • Check Period
    • defines the period on which host will be checked
    • field is a list of values,
      corresponding to timeperiods defined in Time Periods
    • value is taken from templates if any, or default value is filled
  • Check Command
    • defines the short name of the command used to check
      if the host is available
    • field is a list of choices, defined by the Commands configuration
    • value is taken from templates if any, or default value is filled
    • Args:
      • used to pass arguments to the Check Command
      • by default this value is empty
  • Max Check Attemps
    • defines the number of failed check attempt
      before declaring the host as down
    • value is taken from templates if any, or default value is filled
  • Check Interval
    • defines the number of minutes between two check of the host
    • value is taken from templates if any, or default value is filled
  • Retry Interval
    • defines the number of minutes before scheduling a re-check
      if the last one returned a non-UP state.
    • value is taken from templates if any, or default value is filled

...

  • Active Checks Enabled
    • defines if scheduled check will be enabled or not for this host
    • value is taken from templates if any, or default value is filled
  • Passive Checks Enabled

    • defines if passive check will be enabled or not for this host
    • value is taken from templates if any, or default value is filled
  • Maintenance Period

    • defines a reccuring downtime for the host.
      During the selected period, no notifications are sent
    • value is taken from the list of Time Periods
    • value is none per default, which means no downtime for the host

 

 

 

 

 

...

Checks

Checks is a read-only form, used to provide informations about checks
that will be made for the host.

By default, if no template applies on host, no check will be made.

 

 

...

    • .
  • Host Templates to inherit
    • Les modèles de templates qui sont attachés à l'hôte pour hériter de leurs propriétés et leurs données.
      L'ordre des templates est important.
  • Add in host groups
    • Cette propriété permet de lister les groupes d'hôtes auquels cet hôte appartient.
      Ajouter un groupe d'hôte à cet hôte a le même effet que de rajouter cet hôte dans le groupe voulu ( dans la page d'édition du groupe d'hôte ).
      L'ordre dans lequel vous listez les groupes d'hôtes n'a pas d'incidence.
  • Realm
    • Cette propriété permet de définir le royaume où l'hôte se trouvera.
      En plaçant un hôte dans un royaume particulier, un des schedulers de ce royaume gérera cet hôte.
  • Business Impact
    • Cette propriété permet de définir l'importance que l'on donne à un hôte pour le business. ( valeur entre 0 et 5, par défaut 2 ):
      • du moins important ( 0 )
      • au plus important ( 5 )
  • Network dependency
    • Cette propriété permet de définir une liste d'hôtes des quels l'hôte est dépendant.
      C'est une liste séparée par des virgules.
      Ceci signifie que si toutes les dépendances réseaux sont en état CRITICAL, alors les notifications ne seront pas lancées pour cet hôte et ses checks.
      Note: les dépendances réseaux doivent être dans le même royaume que l'hôte.
      L'ordre de définition n'a pas d'impact sur la supervision de cet élément.
  • External URL
    • Cette propriété est utilisée pour définir une URL qui peut être utilisée pour fournir plus d'information sur cet hôte.
      N'importe quelle URL valide peut être mise, commençant par _http://_
      Cette URL sera disponible dans l'interface de visualisation dans le volet détail présentant l'hôte.
      Cela peut être pratique si vous désirez faire une description écrite détaillée de l'hôte, une procédure de reprise sur panne, ... qui sera visible pour les autres membres de l'équipe.
  • Enabled
    • Permettre que cet élément soit pris en compte lors du passage de Staging en Production.

 

Pour les templates uniquement :

 

  • Template is visible for SI Administrator ?
    • Cette propriété permet de cacher ce modèle de check aux Administrateurs de SI.
      Cela peut-être intéressant pour diminuer le nombre de modèle visible pour simplification, ou par sécurité.

Onglet : Data

Cet onglet définit des données qui pourront être utilisées par des Macros, notamment à l'utilisation de la Commande des checks attachés à cet hôte. Consulter ces pages pour plus d'information.

Onglet : Monitoring

  • Monitoring Period
    • Cette propriété permet de choisir la période de supervision où sont faites les vérifications de l'état de l'hôte par Shinken.
  • Check Command Name
    • Cette propriété permet de spécifier la commande qui est employée pour vérifier si l'hôte est dans un statut en OK ou CRITIQUE.
      Si vous laissez vide cette propriété, la commande de contrôle par défaut sera employée.
  • Check Attempts
    • Cette propriété permet de définir le nombre de tentative(s) où Shinken recommencera la commande de vérification d'un hôte si son résultat est autre chose que le statut OK
      Mettre cette valeur à 1 impliquera que Shinken générera une alerte dès qu'il n'est plus en état OK, sans réessayer
      Si vous ne désirez pas que Shinken vérifie le statut de cette hôte, laissez cette propriété à 1, mais laissez vide la commande de vérification.
  • Check Interval
    • Cette propriété permet de définir le temps entre 2 vérifications de l'état de l'hôte.
  • Retry Interval
    • Cette propriété permet de définir le temps d'attente avant de relancer la commande de vérification de l'hôte après un premier état différent de OK.
      Ce nombre est en minutes.
      Une fois que le nombre de relances de commandes de vérifications a atteint la valeur max_check_attempts, le dernier état récupéré est validé et la cadence des vérifications redevient à la valeur normale, définie dans la propriété Intervalle de Check
  • Checks commands are scheduled and launched by Shinken
    • Cette propriété permet de définir si Shinken ordonnance et lances les commandes de vérifications pour déterminer l'état de cet hôte.
      Ses valeurs peuvent être:
      • True: Shinken va ordonnancer et lancer des commandes de vérifications
      • False: Shinken ne va pas ordonnancer et lancer les commandes de vérifications
  • Shinken does accept state received from external tools for this host
    • Cette propriété permet de définir si Shinken accepte les résultats de commandes de checks depuis des outils externes pour cet hôte.
      Les résultats externes seront reçu via le daemon Receiver de Shinken.
      Les valeurs possibles sont:
      • True: accepte les résultats de commandes de checks externes
      • False: n'accepte pas ces résultats
  • Planned maintenance time period
    • Cette propriété permet de définir une période de temps durant laquelle l'hôte sera en maintenance, et en sortira dès que la période de temps sera fini.
      En maintenance, les checks de l'hôte seront toujours exécutés (donc il n'y aura pas de manques dans les métriques ou l'historique de l'hôte), mais les notifications et les commandes du gestionnaire d'évènement ne seront pas lancées.

Onglet : Checks

Cet onglet résume quels sont les Checks qui seront appliqués à l'hôte, et leur provenance (venant de quel template d'hôte, ou directement appliqué à l'hôte).

Les templates sont listés par ordre d'héritage, et ne montrent pas les checks de même nom qui ont été supprimés par résolution d'héritage.

Cet onglet permet également de vérifier la duplication par la fonctionnalité permettant de Dupliquer pour chaque valeur de la Donnée de l'hôte

Enfin, cet onglet permet d'essayer les Checks directement depuis leur configuration actuelle afin de vérifier leur résultat.

Panel
 Image Added

Try check

Les boutons dans la colonne Try check permettent d'essayer directement l'exécution d'un check, avec la résolution de ses données.

 

Le premier bouton permet de simuler la résolution des Macros, et le second permet de simuler son exécution complète sur un Poller.

Info

L'exécution sera en réalité effectuée au niveau du Synchronizer. Pour que celle-ci puisse être réussie, il doit pouvoir exécuter la sonde et, dans le cas d'une vérification distante, doit pouvoir accéder à la machine à superviser d'un point de vue réseau.

Le tableau récapitulatif présente les données récupérées, et le résultat de la commande. Il peut au besoin être caché par le bouton de fermeture de la colonne Try check.

Panel

Image Added

 

 

Onglet : Notifications

  • Notifications Enabled
    • Cette propriété permet de définir si Shinken va envoyer des notifications aux utilisateurs listés comme cibles ( Utilisateurs ou Groupes d'utilisateurs) sur ce hôte.
      Les notifications sont envoyées:
      • Premièrement après la fin de la période de nouvelle tentative, une fois que l'état CRITICAL est confirmé.
      • ensuite après chaque intervalle de notification, exprimé en minutes
      • quand l'hôte redevient OK
        Les valeurs possibles sont:
      • Vrai: Shinken va envoyer les notifications
      • Faux: Shinken n'enverra pas les notifications
  • Contacts
    • Les utilisateurs à notifier
  • Contact groups
    • Les groupes d'utilisateurs à notifier
  • Inverval between notifications
    • Cette propriété permet de définir les intervalles de temps entre les notifications.
      Cette valeur est en minutes.
      Note: la valeur 0 sur cette propriété signifie que seule la première notification sera envoyée.
  • Notification time period
    • Cette propriété permet de définir la période de temps durant laquelle les notifications sont autorisées.
      En dehors de cette période, aucune notification ne sera envoyée.
      Par défaut, il n'y a pas de période de temps, et donc les notifications ne seront jamais bloquées.
  • States that raise notifications
    • Cette propriété permet de définir quels états de l'hôte peuvent envoyer des notifications
      La valeur est une liste d'options séparées par des virgules:
      • d: envoie une notification sur un état CRITIQUE
      • r: envoie une notification lors d'un rétablissement (signifie que l'hôte redevient OK)
      • f: envoie une notification quand l'hôte commence ou sort du contexte FLAPPING
      • s: envoie une notification quand l'hôte entre ou sort d'une période de maintenance
      • n: n'envoyer aucune notification
        Par défaut, toutes les notifications sont autorisées.
  • Delay for the first notification
    • Cette propriété permet de définir combien de minutes Shinken doit attendre avant d'envoyer la première notification.
      Ce temps additionnel peut être mis à profit par les utilisateurs pour prendre en compte l'hôte depuis l'interface de visualisation avant que la notification ne soit envoyée.
      Par défaut la valeur est 0, ceci signifie que la première notification sera envoyée sans attendre.
  • Escalations
    • Cette propriété permet de lier cet hôte à une ou plusieurs définitions d'escalade.
      Si, au bout d'un certain temps, l'hôte n'est toujours pas revenu OK ou pas pris en compte (Contexte ACKNOWLEDGE ou DOWNTIME), la règle d'escalade sera appliquée.

Onglet : Advanced

  • Poller Tag
    • Cette propriété permet de définir le poller_tag de l'hôte.
      Tous les checks de l'hôte seront exécutés que par les Pollers qui ont cette valeur dans leur paramètre poller_tags.
      Par défaut, la valeur de Tag de Poller est None, donc toutes les Pollers n'ayant aucun de poller_tag prendront en compte les checks d'un hôte non taggué, car la valeur par défaut pour les Pollers est aussi None
  • Flap Detection Enabled
    • Cette propriété permet de définir si la détection du Contexte FLAPPING est actif sur cette hôte.
      Peut être:
      • Vrai: active la détection du contexte FLAPPING.
      • Faux: désactive la détection du contexte FLAPPING.
  • Flap Detection Options
    • Cette propriété permet de définir quel statut d'un hôte sont pris en compte pour le calcul du % de FLAPPING.
      C'est une combinaison de l'un ou de plusieurs valeurs:
      • o = statut OK
      • d = statuts CRITICAL
      • u = statuts UNREACHABLE
        Le séparateur est la virgule.
        o est obligatoire.
        Exemple: o,d,u
  • % to entering into FLAPPING Context
    • Sur les 21 derniers statuts, chaque fois qu'un statut est différent du précédent (de OK a Warning par exemple), le % de FLAPPING augmente. Donc pour 10 changements, cela représentera un % de FLAPPING de 50% et pour 20, cela représentera 100%.
      Si ce % calculé est supérieur au % d'entrée dans le Contexte FLAPPING, alors le Contexte de l'hôte deviendra FLAPPING.
      Il sortira de ce Contexte quand ce pourcentage calculé sera inférieur au % de sortie du Contexte FLAPPING.
  • % to exit from Flapping Context
    • Sur les 21 derniers Statuts, chaque fois qu'un statut est différent du précédent (de OK a Warning par exemple), le % de Flapping augmente. Donc 10 changements représentera une % de flapping de 50% et 20 représentera 100%.
      Si ce % calculé est supérieur au % de sortie du Contexte FLAPPING, alors le Contexte de l'hôte ne sera plus FLAPPING.
  • Event Handler Enabled
    • Cette propriété permet de définir si Shinken va lancer une commande (définie par le paramètre commande de gestionnaire d'évènement) à des étapes spécifiques du statut de l'hôte:
      • quand l'hôte passe d'un état OK à un état à problème (CRITICAL ou UNKNOWN)
      • à chaque vérification additionnelle, donc un nombre maximum de confirmation du statut
        Si la propriété est:
      • Vrai: va lancer la commande quand nécessaire
      • Faux: ne va pas lancer cette commande
  • Event Handler command
    • Cette propriété permet de définir la commande que lancera le gestionnaire d'évènement pour cet hôte.
  • Checking that external received state expiration
    • Cette propriété permet de définir si Shinken doit vérifier que la date de réception du dernier état reçu des outils externes ne soit pas expirée (trop vieille). Si la date est plus âgée que le seuil d'expiration, alors Shinken va forcer l'exécution d'une commande de check pour cet élément.
      Ses valeurs peuvent être:
      • Activé: Shinken va vérifier l'expiration
      • Désactivé: Shinken ne vérifiera pas l'expiration
  • External received state expiration threshold ( x secondes )
    • Cette propriété permet de définir quand Shinken doit forcer une commande de vérification pour cet hôte si le dernier état reçu des outils externes est plus âgé que ce seuil.
      Cette valeur est en secondes.
  • Business impact modulations
    • Cette propriété permet de définir une ou plusieurs modulations d'impact métier. Les modulations ont une période temps durant laquelle elles sont actives.
      Pendant cette période, la valeur d'impact métier de l'hôte sera changée par celle de la modulation.
  • Data modulations
    • Cette propriété permet de définir une ou plusieurs modulations de données. Les modulations ont une période temps durant laquelle elles sont actives.
      Pendant cette période, les données de l'hôte seront changées par celle de la modulation.
  • Check to exclude
    • Cette propriété permet d'exclure des checks
      Vous pouvez exclure plusieurs checks à l'aide d'une liste de noms séparés par des virgules.

...

If the host inehrits from a template which has checks attached, checks will be filled
with the description of those services.

In this example, we can see 3 checks, inherited from http template, and https template.
Checks are displayed in tables, showing the following :

  • Name of the Check
  • Contacts Groups for the Check
  • Host templates using the Check
  • Check Command used
  • A "Try this check" action, allowing to try the check before validating

Name of check is a link to the check configuration of the selected object.

...

Notifications

Notification is a form displaying all required fields to configure notifications properties :

  • Notification Enabled
    • used to enable or disable notifications for the host
    • value is taken from templates if any, or enabled by default
  • Contacts
    • multi-value field, used to define contacts to notify
    • values are taken from Contact Configuration, displayed as a list of name
    • value is taken from templates if any, or none by default
  • Contact Groups
    • multi-value field, used to define contact groups to notify
    • values are taken from Contact Group Configuration, displayed as a list of name
    • value is taken from templates if any, or default value is provided
  • Notification Interval
    • used to set the number of minutes before re-notifying contacts
    • value is taken from templates if any, or default value is provided
  • Notification Period
    • directive used to specify the time period during notifications will be sent
    • list of value corresponds to Time Periods defined
    • value is taken from templates if any, or default value is provided
  • Notification Options 
    • list of flags, used to dertmine what state should generate a 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)

...

Image Removed

  • 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

Image Removed

 

  • 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

...

  • 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

...