Onglet Général

• Nom du Check
  

  • Cette propriété est utilisée pour définir le nom du check. Les caractères suivants sont interdits : ~!%^&*"'|<>?,()=+
    2 checks associés sur le même hôte ne peuvent pas avoir le même nom.
    Un caractère non autorisé provoquera un compteur erreur
     Ce champ ne peut pas rester vide
    
    

• Modèles de Check hérité
  
  • Les modèles de checks qui sont attachés à l'hôte pour hériter de leurs propriétés et leurs données.
    • L'ordre des modèles est important.
    • Une valeur définie dans 2 modèles prendra la valeur du modèle le plus proche du début de la liste.
    • Si vous définissez une valeur pour une propriété ou une donnée, elle sera prioritaire sur celle héritée de modèles.
      
      
• Attaché sur les groupes d'hôtes
  
  • Cette propriété est utilisée pour attacher ce check sur un ou plusieurs groupes d'hôtes.
    Utilisez la virgule (,) pour spécifier plusieurs hôtes.
    
    
• Attaché sur les hôtes (pour les Checks appliqués à l'hôte)
  
  • Cette propriété est utilisée pour attacher ce check sur un ou plusieurs hôtes.
    Utilisez le menu déroulant pour spécifier un ou plusieurs hôtes.
    
    

• Attaché sur les modèles d'hôtes (pour les Checks appliqués aux modèles d'hôtes)

  
  

  • Cette propriété est utilisée pour attacher ce check sur un ou plusieurs modèles d'hôtes. Utilisez le menu déroulant apparaissant lorsque vous activez ce champ pour sélectionner un ou plusieurs modèles d'hôtes.

  • Le menu déroulant (4) vous proposera les modèles d'hôtes correspondant à l'élément en cours de saisie (1).

  • La saisie en cours est reprise dans l'entête du menu déroulant (2) où sont également indiqués le nombre d'éléments correspondant à la saisie et le nombre total d'éléments (3).

  • Le champ d'édition définit une expression conditionnelle, permettant de déterminer sur quels hôtes le check sera attaché, en fonction des modèles d'hôtes dont il hérite.

    Expression	Description
    modèle	Le check s'attache sur tous les hôtes héritant de modèle
    modèle1 | modèle2	Le check s'attache sur tous les hôtes héritant soit de modèle1, soit de modèle2, soit des deux modèles
    modèle1 & modèle2	Le check s'attache sur tous les hôtes héritant à le fois de modèle1 et de modèle2
    ! modèle	Le check s'attache sur tous les hôtes n'héritant pas de modèle
    ( expression )	Tous ces opérateurs peuvent être combinés et les parenthèses peuvent être utilisées pour former des expressions plus complexes

    Une expression ne respectant pas ces règles provoquera un compteur d'erreur

• URL externe
  
  • Cette propriété est utilisée pour définir une URL qui peut être utilisée pour fournir plus d'informations 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.
     Une url qui ne commence pas par http:// ou https:// provoquera un compteur erreur
    
    
• Liste des URL externes
  • Clé d'import: notes_multi_url

Cette propriété est utilisée pour définir plusieurs URL qui peuvent être utilisées pour fournir plus d'informations sur cet hôte.

• • • (1) Nom de l'URL (label pour l'interface de visualisation), Le nom à afficher est optionnel ( mais son absence montrera toujours un warning dans l'interface )

    • (2) Adresse de l'URL, N'importe quelle URL valide peut être utilisée, commençant par http:// or https://

    • (3) Icône pour l'UI de visualisation

    • (4) Type d'affichage (Nouvelle onglet, pop-up de différente taille, ou ne pas l'afficher)

    • (5) Valeur à copier-coller dans un fichier cfg pour retrouver cette propriété dans l'état

      
      

    Une url externe peut contenir le mot clé ##USER## qui sera remplacer par le nom de l'utilisateur courant dans l'interface de Visualisation

    
    

    Ces URL seront disponibles pour tout module accroché au module ( ex: dans l'interface de Visualisation, elles seront affiché ).
  • 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, ou toute autre information qui sera visible pour les autres membres de l'équipe.
     Une URL qui ne commence pas par http:// ou https:// provoquera un compteur erreur
    

    
    

• Activé
  • Permettre que cet élément soit pris en compte lors du passage de Staging en Production.
    
    
• Pack
  • Cette propriété permet de définir dans quel pack se trouve le check.
    
    

Onglet Données

Cet onglet définit des données qui pourront être utilisées par des Variables, notamment à l'utilisation de la Commande de check. Consultez ces pages pour plus d'info

La valeur de la données pouvant être longue, il est possible d'agrandir le champ de la valeur afin d'améliorer la lisibilité du champs.

Pour agrandir le champ de la valeur, il faut maintenir le clic sur l'icône située en bas à droite du champ et réajuster verticalement . 

Onglet Supervision

• Période de DOWNTIME récurrente
  
  • Cette propriété permet de définir une période de temps pendant laquelle l'hôte sera en maintenance.
    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.
    
    
• Période de vérification
  
  • 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.
    
    
• Commande de vérification
  
  • Cette propriété permet de spécifier la commande qui est employée pour vérifier si le check 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.
    Ce champ ne peut pas rester vide
    
    
• Nombre maximum de tentatives de confirmation du statut du check
  
  • Cette propriété permet de définir le nombre de tentatives où Shinken recommencera la commande de vérification d'un check 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 fasse de vérification de statut de ce check, laissez cette propriété à 1, mais la commande de vérification doit être vide
    Une valeur non numérique provoquera un compteur erreur
    Ce champ ne peut pas rester vide
    
    
• Intervalle entre les vérifications (X minutes)
  
  • Cette propriété permet de définir le temps entre 2 vérifications de l'état du check.
    Une valeur non numérique provoquera un compteur erreur
    Ce champ ne peut pas rester vide
    
    
• Intervalle de nouvelles tentatives de vérification d'état (X minutes)
  
  • Cette propriété permet de définir le temps d'attente avant de relancer la commande de vérification du check 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 revient à la valeur normale, définie dans la propriété Intervalle entre les vérifications
    Une valeur non numérique provoquera un compteur erreur
    Ce champ ne peut pas rester vide
    
    
• Temps maximum d'exécution d'un check
  
  • Cette propriété permet de définir la valeur en secondes du temps maximum permis pour le lancement d'une commande de supervision. Passé ce délai, la commande sera terminée. Si le check ou la commande définit également ce paramètre, leur valeur sera prioritaire par rapport à celle de l'hôte.
    Aucune valeur ou une valeur a -1, indique qu'il n'y a pas de Temps maximum défini.
    Si ni l'hôte, ni le check, ni la commande ne définissent ce paramètre, alors la valeur définie globalement pour Shinken (via le fichier shinken.cfg et le paramètre check_running_timeout) sera utilisée à la place.
    Une valeur non numérique provoquera un compteur erreur
    
    
• Seuil d'alerte de l'utilisation CPU (sec)
  
  • Nombre de secondes que peut consommer une commande avant d'apparaître en Warning dans le check 'Scheduler - Performance'
    La valeur sera récupérée dans l'ordre, par la commande, par l'élément Check, par l'élément Hôte, ou par la valeur par défaut (shinken.cfg:warning_threshold_cpu_usage)
    Une valeur non numérique provoquera un compteur erreur
    
    
• Les commandes de vérifications sont ordonnancées et lancées par Shinken
  
  • Cette propriété permet de définir si Shinken ordonnance et lance la commande de vérification pour déterminer l'état de ce check.
    Ses valeurs peuvent être:
    • True: Shinken va ordonnancer et lancer la commande de vérification
    • False: Shinken ne va pas ordonnancer et lancer la commande de vérification
      
      
• Shinken accepte les états reçus depuis des outils externes pour cet hôte
  
  • 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 démon Receiver de Shinken.
    Les valeurs possibles sont:
    • True: accepte les résultats de commandes de checks externes
    • False: n'accepte pas ces résultats
      
      
• Duplicate for each - Dupliqué pour chaque valeur de la Donnée de l'hôte
  
  • Cette propriété est utilisé pour générer plusieurs checks dans l'arbiter avec une seule définition de check dans le Synchronizer. Shinken comprend cette propriété comme : Crée un check pour chaque Valeur de cette propriété.
    Le nom du check doit contenir un $KEY$.
    En créant un check pour chaque valeur, Shinken remplacera le $KEY$ par cette Valeur.
    $KEY$ est aussi utilisable dans la commande de vérification si nécessaire, pour son exécution.
    Des paramètres peuvent être fournis aux checks (appelés $VALUE$ si il n'y en a qu'un ou $VALUE_x_$, avec x valant de 1 à n).
    Une valeur non valide provoquera un compteur erreur
    
    
• Valeur par défaut des arguments du Duplicate for each
  
  • Vous pouvez fournir plusieurs arguments pour chaque valeur définie dans la donnée de l'hôte utilisé par la fonctionnalité Duplicate for Each.
    Mais si la liste des arguments devient grande et plusieurs fois la même, il est inutile de les répéter.
  • Prenons le cas d'une base de données avec un port par défaut et une connexion sécurisée en SSL:
    • La donnée DATABASE contient DB1, DB2, DB3
    • Si on définit les arguments sur chaque base, on aurait dans la donnée DATABASE : DB1$(1521)$$(ssl)$,DB2$(1521)$$(ssl)$,DB3$(1521)$$(ssl)$
    • Définir un port particulier sur DB2 donnerait DB1$(1521)$$(ssl)$,DB2$(20000)$$(ssl)$,DB3$(1521)$$(ssl)$
    • Mais plus simplement, si vous définissez dans cette propriété de valeur par défaut des arguments $(1521)$$(ssl)$, alors la propriété DATABASE sur l'hôte pourra avoir cette forme simplifiée DB1,DB2$(20000)$$(ssl)$,DB3
    Un format non valide provoquera un compteur erreur
    
    

Onglet Notifications

• Notifications activées
  • 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 check.
  • 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
      
      
• Utilisateurs
  • Cette propriété est utilisée pour définir quels sont les utilisateurs à notifier.
    
    
• Groupes d'utilisateurs
  
  • Cette propriété est utilisée pour définir quels sont les groupes d'utilisateurs à notifier.
    
    
• Intervalle de temps entre les notifications (x minutes)
  
  • 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.
    Une valeur non numérique provoquera un compteur erreur
    
    
• Période de temps de notification
  
  • 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.
    
    
• Options de notification
  
  • Cette propriété permet de définir quels sont états de l'hôte qui provoquent l'envoi 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'envoie aucune notification
      Par défaut, toutes les notifications sont autorisées.
      Une option non autorisée provoquera un compteur erreur
      
      
• Décalage de la première 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.
    Une valeur non numérique provoquera un compteur erreur
    
    

• Escalades
  • Cette propriété permet de lier ce check à une ou plusieurs définitions d'escalade.
    Si, au bout d'un certain temps (défini dans l'escalade), le check n'est toujours pas revenu OK ou pas pris en compte (Contexte ACKNOWLEDGE ou DOWNTIME), la règle d'escalade sera appliquée.

Onglet Expert

• Tag de poller
  
  • Cette propriété permet de définir le poller_tag du check.
    Le check ne sera exécuté que par les Pollers qui ont cette valeur dans leur paramètre poller_tags.
    Par défaut, la valeur de Tag de Poller est non taggué, donc toutes les Pollers n'ayant aucun poller_tag prendront en compte les checks d'un hôte non taggué, car la valeur par défaut pour les Pollers est aussi non taggué
    Veuillez consulter la page Le Poller pour plus d'informations sur les tags de poller.
    
    
• Tag de reactionner
  • Cette propriété permet de définir le reactionner_tag de le hôte.
    Tous les notifications sur l'hôte ne seront exécutées que par les Reactionners qui ont cette valeur dans leur paramètre reactionner_tags.
    Par défaut, la valeur de Tag de Reactionner est non taggué, donc les Reactionners n'ayant aucun reactionner_tag prendront en compte les checks d'un hôte non taggué, car la valeur par défaut pour les Reactionners est aussi non taggué
    
    
• Impact métier
  
  • Cette propriété permet de définir l'importance métier que l'on donne à un check.
    ( valeur entre 0 et 5 ):
    • du moins important ( 0 )
    • au plus important ( 5 )
      La valeur par défaut est 2.
      
      
• Envoyer une notification à chaque retour en erreur du check
  
  • Cette propriété permet de forcer Shinken à envoyer une notification pour chaque retour en erreur d'un check.
    Si non forcé, Shinken va vérifier l'état du check avant de lancer une notification (avec un nombre maximum de confirmation du statut), puis ne va envoyer de notification que tous les intervalle de notifications (typiquement une fois par jour par défaut).
    Mais si cette option est activée, ces vérifications seront désactivées, et une notification sera envoyée pour chaque check retournant un statut en erreur.
    
    
• Vérification que l'état reçu des outils externes ne soit pas expiré
  • 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 antérieure à la période d'expiration, alors Shinken va forcer l'exécution de la commande de check.
    Ses valeurs peuvent être:
    • Activé: Shinken va vérifier l'expiration
    • Désactivé: Shinken ne vérifiera pas l'expiration
      
      

• Seuil d'expiration des états reçus des outils externes ( x secondes )

  • Cette propriété permet de définir quand Shinken doit forcer la commande pour check si le dernier état reçu des outils externes est antérieur à ce seuil.
    Cette valeur est en secondes.
    Une valeur non numérique provoquera un compteur erreur
    
    
• Détection du flapping activée
  
  • 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.
      
      
• Options de la détection du flapping
  
  • Cette propriété permet de définir quel statut d'un check sont pris en compte pour le calcul de pourcentage 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
      Une option non autorisée provoquera un compteur erreur
      
      
• Sortie du Contexte FLAPPING
  
  • 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 check deviendra FLAPPING.
    
    
• Entrée du Contexte FLAPPING
  
  • 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 du check ne sera plus FLAPPING.
    
    
• Lire et stocker les métriques
  
  • Cette propriété permet de définir si Shinken doit lire et stocker les métriques issues de la commande de vérification.
    Les valeurs possibles sont:
    • Vrai: Shinken va lire et stocker les métriques issues de la commande de vérification de l'hôte
    • Faux: Shinken ne va pas lire et stocker les métriques issues de la commande de vérification de l'hôte
      
      
• Gestionnaire d'événements activé
  
  • Cette propriété permet de définir si Shinken va lancer une commande (définie par le paramètre Commande lancée par le gestionnaire d'événements) à 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
      
      
• Commande lancée par le gestionnaire d'événements
  
  • Cette propriété permet de définir la commande que lancera le gestionnaire d’événement pour cet hôte.
    
    
• Modulations d'impact métier
  
  • Cette propriété permet de définir une ou plusieurs modulations d'impact métier. Les modulations ont une période de temps durant laquelle elles sont actives.
    Pendant cette période, la valeur d'impact métier du check sera changée par celle de la modulation.
    Si aucune modulation d'impact métier n'est définie, le check aura le même comportement que son hôte.
    
    
• Modulations de données
  
  • Cette propriété permet de définir une ou plusieurs modulations de données. Les modulations ont une période de temps durant laquelle elles sont actives.
    Pendant cette période, les données du check seront changées par celle de la modulation.
    
    
• Modulations des résultats

  • Cette propriété permet de définir une ou plusieurs modulations de résultats. (maximum 4). Les modulations de résultats redéfinissent le statut de sortie d'un check, en fonction de son statut initial, d'une période de temps, ou de sa sortie.
    
    

• Ordre de définition
  
  • Ordre de définition
    Une valeur non numérique provoquera un compteur erreur