Onglet : Général



  • Nom
    • Clé d'import : host_name

      Cette propriété permet de définir le nom utilisé pour identifier le cluster. Il permet de référencer cet élément dans la définition d'autres clusters.

      Les caractères ~!$%^&*"'|<>?,()=/+ sont interdits dans ce champ.

      (moins) Un caractère non autorisé provoquera un compteur d'erreur

      (étoile rouge) Ce champ ne peut pas rester vide

  • Définition

    • Clé d'import : bp_rule

      Cette propriété est utilisée pour configurer en une règle logique une agrégation de plusieurs autres états (hôtes et checks).

      Deux opérateurs de bases sont disponibles pour définir l'agrégation des états: & et |

      Par exemple, il est possible :

      • D'agréger par nom d'hôte :

        "hote_1" & (!"hote_2" | "host_3")


      • D'agréger par nom de check :

        "hote_1","check_1" & "host_2","check_2"


      • D'agréger par expression régulière sur le nom d'hôte :

        r:/^host_/



  • Modèles de cluster hérités

    • Clé d'import : use

      Les modèles de cluster qui sont attachés au cluster pour hériter de leurs propriétés et leurs données.

      • L'ordre des modèles est important.

      • Le premier modèle qui définit une propriété définit la valeur de la propriété pour le cluster.

      • Si une propriété est définie directement sur le cluster, la valeur définie sera utilisée et pas celle du modèle.

        Pour un administrateur de SI, certains modèles ne sont pas "visible" et ne seront pas disponibles dans la liste des choix.


  • Royaume
    • Clé d'import : realm

      Cette propriété permet de définir le royaume où le cluster se trouvera.

      En plaçant un cluster dans un royaume particulier, un des schedulers de ce royaume gérera ce cluster.

  • Impact métier
    • Clé d'import : business_impact

      Cette propriété permet de définir l'importance que l'on donne à un cluster pour le business. ( valeur numérique entre 0 et 5 dans les fichiers d'imports, mais affichée dans l'interface avec des étoiles ou des dollars suivant le niveau ) :
      • du moins important ( 0 => * )
      • ( 1 => ** )
      • ( 2 => *** )
      • ( 3 => $$$$ )
      • ( 4 => $$$$$ )

      • au plus important ( 5 => $$$$$$ )

        La valeur par défaut est 2 ( *** ).


  • URL externe
    • Clé d'import : notes_url

      Cette propriété est utilisée pour définir une URL qui peut être utilisée pour fournir plus d'information sur ce cluster.
      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 le cluster.

      Cela peut être pratique si vous désirez faire une description écrite détaillée du cluster, une procédure de reprise sur panne, ... qui sera visible pour les autres membres de l'équipe.

      Les caractères < > " ' sont interdits.

      (moins) Un caractère non autorisé provoquera un compteur d'erreur

  • Liste des URL externes
    • Clé d'import : notes_multi_url

      Cette propriété est utilisée pour définir plusieurs URL permettant de fournir plus d'informations sur ce cluster (une description écrite détaillée de l'hôte, une procédure de reprise sur panne, etc ...).

      Ces URL seront disponibles dans l'interface de Visualisation (les listes et dans le volet détail présentant le cluster).


      La définition d'une URL est composée de 4 parties :
      • (1) Du nom de l'URL (pour l'affichage dans l'interface de Visualisation l'URL)
      • (2) De l'adresse de l'URL (doit commencer par http:// ou https://)
      • (3) D'une icône (permettant de reconnaître l'URL dans l'interface de Visualisation)
      • (4) Du type d'affichage
        • Caché
        • Ouverture dans un nouvel onglet
        • Ouverture dans un popup interne à Shinken
      • (5) Valeur à copier-coller dans un fichier cfg pour retrouver cette propriété dans l'état

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.

Les caractères < > " ' sont interdits.

(moins) Une URL qui ne commence pas par http:// ou https:// provoquera un compteur erreur

(moins) Un caractère non autorisé provoquera un compteur d'erreur




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



Dans cette propriété, des données ( macro ) de cet hôte peuvent être utilisées dans l'URL.


Les données (macros) qui peuvent être utilisées sont les suivantes:

  • Données globales
  • Données accrochées à l'hôte présente dans l'onglet Données
  • et les propriétés ( données statiques ) suivantes:
    • HOSTUUID
    • HOSTNAME
    • HOSTDISPLAYNAME
    • HOSTALIAS
    • HOSTADDRESS
    • HOSTREALM
    • HOSTADDRESS



  • Activé
    • Clé d'import : enabled

      Permettre que cet élément soit pris en compte lors du passage de Staging en Production.

      Cette propriété n'est pas héritable.

  • Pack
    • Clé d'import : pack

      Cette propriété permet de définir dans quel pack se trouve le cluster.

      Cette propriété n'est pas héritable.

      Les caractères < > & " ' / sont interdits.

      (moins) Un caractère non autorisé provoquera un compteur d'erreur


Onglet : Données

Cet onglet définit des données qui pourront être utilisées en tant que Variable, notamment à l'utilisation de la Commande des checks attachés à ce cluster. Consulter ces pages pour plus d'information.

Si vous donnez un nom de donnée protégée à l'une de vos données, vous ne pourrez plus modifier ce nom par la suite.

  • Vous devrez le supprimer puis le recréer si vous voulez le renommer.

Cette modification est interdite afin d'éviter qu'une donnée protégée devienne visible, en changeant son nom.


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

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.

L'agrandissement manuel du champ n'est pas disponible pour le navigateur Internet Explorer. Mais les champs avec des valeurs longues sont automatiquement agrandis jusqu’à une certaine taille lorsque la valeur du champ dépasse une ligne.




Onglet : Supervision

  • Période de DOWNTIME récurrente
    • Clé d'import : maintenance_period

      Cette propriété permet de définir une période de temps durant laquelle le cluster sera en maintenance, et en sortira dès que la période de temps sera fini.

      En maintenance, les checks du cluster seront toujours exécutés (donc il n'y aura pas de manques dans les métriques ou l'historique du cluster), mais les notifications et les commandes du gestionnaire d’événements ne seront pas lancées.

Onglet : Valeurs par défaut pour les checks

  • Période de vérification
    • Clé d'import : check_period

      Cette propriété permet de choisir la période de supervision pendant laquelle sont faites les vérifications de l'état du cluster par Shinken.

  • Temps maximum d'exécution d'un check
    • Clé d'import : check_period

      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.

      (moins) Un caractère non autorisé provoquera un compteur d'erreur

  • Seuil d'alerte de l'utilisation CPU (sec)
    • Clé d'import : warning_threshold_cpu_usage

      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 Cluster, ou par la valeur par défaut (shinken.cfg:warning_threshold_cpu_usage)

      (moins) Un caractère non autorisé provoquera un compteur d'erreur

Onglet : Droits de l'utilisateur

Il est possible pour chaque hôte de définir qui peut voir, éditer, ou encore recevoir les notifications. Le fonctionnement de ce mécanisme est expliqué dans la page Droits d'accès à un cluster. Ces propriétés gèrent l'Héritage additif (le +).

Ces 6 propriétés se synchronisent les unes avec les autres, pour éviter d'avoir des droits aberrants.

Par exemple : avoir le droit d'éditer l'élément, mais sans avoir droit de le voir.

Onglet : Checks

Cet onglet détaille la liste des checks qui seront appliqués au cluster, et leur provenance (venant de quel modèle de cluster, ou directement appliqué au cluster) :

  • Tout d'abord les checks accrochés directement sur le cluster sont listés.
  • Ensuite sont listés les modèles dans l'ordre de leur apparition dans la liste des modèles hérités.
    • Et pour chacun leurs checks.
    • Seront aussi listé les checks duplication par la fonctionnalité permettant de Dupliquer pour chaque valeur de la Donnée du cluster.
      Ici, dans l'image, un seul check utilise des Duplicate Foreach ( la colonne Duplicate Foreach a une valeur pour ce check ).

  • Sur cet onglet vous pouvez surcharger les valeurs des checks ( voir la surcharge des checks ) et exclure les checks que vous ne voulez pas appliquer sur ce cluster (voir l'exclusion des checks)

Pour chaque check, vous pourrez essayer le check depuis sa configuration actuelle afin de vérifier son résultat.