Principe: Général

La surcharge est un mécanisme permettant de réécrire localement une partie de la configuration d'un check au niveau de chaque hôte ou modèle d'hôte. Cette surcharge s'applique sur les données et les propriétés d'un check.


Ce mécanisme intervient dans la problématique suivante : un hôte avec des checks est proposé à la supervision d'un équipement, mais la configuration des checks ne convient pas à la situation. Au lieu de créer de nouveaux checks et entraîner à la longue une multiplication du nombre de checks, il suffit de surcharger les propriétés ou les données des checks directement sur l'hôte.


Si vous n'êtes pas familier avec le fonctionnement et l'édition d'un check, il vous est vivement conseillé de commencer par lire la documentation ( voir Les Checks ).

Accéder à la surcharge

La surcharge est accessible dans l'onglet Checks de la page d'édition d'un hôte ou d'un modèle d'hôte.

Activer le mode surcharge

Dans l'onglet Checks, il faut activer le mode surcharge ( voir la page Editer un Hôte ) pour pouvoir faire apparaître les boutons d'activation de la surcharge (Activer la surcharge ou Surchargé).


Ouvrir le formulaire de surcharge

Un clic sur un bouton Activer la surcharge ou Surchargé ouvrira le formulaire de surcharge d'un check.




Présentation visuelle

Le formulaire de la surcharge reprend les propriétés proposées lors de l'édition du check et est composé de 4 sections:

  • La barre de navigation reprend les mêmes onglets que l'édition d'un élément.
  • La partie édition est découpée en trois sections:
    • Le nom des propriétés
    • Champs d'édition
    • La valeur originale du check



Surcharger une propriété

Réaliser une surcharge

La surcharge se fait en saisissant ou en sélectionnant une valeur sur une propriété ou une donnée comme vous pourriez le faire sur une édition classique d'un élément.

Une fois faite, la valeur de surcharge apparaîtra en bleu et la valeur originale du check apparaîtra en grisé .

Sans modification, ce sont les valeurs originales du check (en violet) qui seront prises en compte.



Revenir à la valeur initiale du check

Pour supprimer une surcharge uniquement sur une propriété ou une donnée, il faut :

  • Pour un champ texte, supprimer la saisie.
  • Pour un champ sélecteur (simple ou multiple), sélectionner dans la liste des options, l'option "-- Valeur du check --"
  • Pour les autres types de champ, il faut cliquer sur le bouton "Valeur du check"

Attention, l'icône de balai sur le bouton "Surchargé" supprimera toutes les surcharges réalisées sur le check.

Cas spécifiques

Les champs non éditables

Dans le formulaire de la surcharge, certaines propriétés ne sont pas éditables, car cela modifierait l’intégrité du check et ainsi le but de celui-ci. Ces champs sont reconnaissables, car ils apparaissent avec l'icône .

La valeur de ces propriétés apparaît dans la colonne de la Valeur sur le check.


Liste des champs non éditables pour tout le monde :

  • Nom du Check
  • Modèle de Check hérité
  • Commande de vérification
  • Commande lancée par le gestionnaire d'événement

Ces champs ne peuvent être surchargés puisque cela dénaturerait le Check.

Nous vous conseillons de créer un nouveau Check si vous souhaitez vraiment surcharger cette valeur.


Si vous voulez remplacer la command de check par un autre, nous vous suggérons d'exclure le check pour cet hôte, et d'en créer un nouveau, puis d'attacher le nouveau Check à l'hôte ( ou modèle ).



Certains champs ne sont verrouillés que pour les admins SI :

  • Actif activé
  • Passif activé
  • Vérification que l'état reçu des outils externes ne soit pas expiré
  • Lire et stocker les métriques


Ces champs ne peuvent être surchargés car cela dénaturerait le Check.

Nous vous conseillons de créer un nouveau Check si vous souhaitez vraiment surcharger cette valeur.


Si vous voulez remplacer la command de check par un autre, nous vous suggérons d'exclure le check pour cet hôte, et d'en créer un nouveau, puis d'attacher le nouveau Check à l'hôte ( ou modèle ).

Les champs de type commande

Les champs de type commande sont des propriétés partiellement éditables. En effet, seuls les arguments de la commande peuvent être surchargés.


Les données

Les données peuvent être surchargées, mais il n'est pas possible de créer une nouvelle donnée à partir d'une surcharge.


Modèles d'hôte hérités

L'ouverture d'un formulaire de surcharge d'un check empêche la sélection ou la suppression d'un modèle dans le champ "Modèles d'hôte hérités" de l'hôte ou du modèle. En effet, la modification de ce champ peut entraîner une perte des surcharges non sauvegardées.


Les compteurs

Pour la surcharge, plusieurs types de compteurs ont été ajoutés.

Les compteurs de surcharge

Dans la barre de navigation du formulaire de surcharge, un compteur est présent sur chaque onglet afin de faciliter la recherche des surcharges sur le check.


Les compteurs d'avertissement et d'erreur

Ces deux types de compteurs ont pour but d'indiquer qu'une erreur ou un avertissement est présent dans les surcharges d'un check. Ces compteurs ont été placés à plusieurs endroits :

  • Sur la propriété ou donnée à l'origine du problème
  • Dans les onglets de la barre de navigation
  • Sur le bouton "Surchargé"
  • La ligne du check
  • Sur l'onglet "Check" de la barre de navigation du formulaire d'édition de l'hôte
  • Sur le bouton "Sauvegarder"

La surcharge dans les modèles d'hôte

La surcharge des checks est aussi disponible sur les modèles d'hôte, car cela évite de devoir effectuer une surcharge sur tous les hôtes qui héritent de ce modèle d'hôte.

La réalisation de cette surcharge s'effectue de la même manière que pour un hôte.



Affichage dans la surcharge sur l'hôte

Les surcharges effectuées au niveau du modèle d'hôte apparaîtront dans la colonne "Valeur sur le check" dans le formulaire de surcharge au niveau de l'hôte.

Surcharge et héritage additif

  • Pour les champs de sélection multiple où l'héritage additif est activé, les valeurs qui seront prises en compte pour la surcharge sont :

    • La valeur sélectionnée par l'utilisateur (en bleu)
    • La valeur originale du check (en violet)

Lorsque l'héritage additif est actif, la valeur prise en compte sera la valeur originale du check et pas celle définie dans le modèle d'hôte.

La surcharge et l'essai des checks

Même sans avoir sauvegardé l'élément, les surcharges effectuées sur les propriétés du check influencent le résultat de l'essai du check

Voici les propriétés concernées :

  • Les arguments de la commande de vérification
  • Modulation de données
  • Modulation de résultat
  • Les données

Surcharge inactive


Il est possible qu'une surcharge soit rendue inactive à la suite de la "disparition" du check surchargé de la configuration.

Les surcharges inactives sont listées à la fin de l'onglet Checks.

Les surcharges deviennent inactives dans différentes raisons :

  • Suppression ou désactivation d'un check
  • Suppression ou désactivation d'un modèle d'hôte
  • Changer le champ "Modèle d'hôte hérité" de l'hôte
  • Changer le champ "Attaché sur les modèles d'hôte" d'un check appliqué au modèle d'hôte.
  • Modification d'une clé d'un check dupliqué automatiquement.
  • Mauvaise définition d'une surcharge dans l'import d'une source




Rattacher une surcharge inactive 

Pour rattacher une surcharge inactive à un check, il faut faire l'action inverse que ce qui a rendu la surcharge inactive.

C'est-à-dire soit :

  • Recréer un check avec le même nom et l'attacher à l'hôte ou à un de ses modèles 
  • Rajouter un modèle d'hôte avec un check qui possède le même nom.
  • Modifier la source pour attribuer la surcharge au bon check.
  • Modifier la donnée d'un check duplicate for each pour qu'un des checks duplicate for each ait le bon nom.

Une fois ces modifications effectuées, les surcharges inactives se rattachent automatiquement à leur check.

Le fait de rattacher les surcharges inactive à n'importe quel check qui revient avec le même nom permet de ne pas perdre la configuration. 

Exemple :

Une surcharge de check configure le check CPU pour ne pas envoyer de notification

→ On décide de changer le check CPU de cet hôte d'une vérification par SSH en SNMP
→ La surcharge reste sur le nouveau check CPU et les notifications ne sont toujours pas envoyées.

Par contre, les paramètres des checks lié à la commande comme : 

  • Les arguments de la commande de vérification
  • Modulations des résultats
  • Modulation de données
  • Les données utilisées par la commande

Resteront sur la surcharge du nouveau check mais ne seront surement plus utiles, nous conseillons de les modifier ou de les supprimer.

Compteur de surcharge inactive

La présence de surcharges désactivées est indiquée par un compteur d'avertissements sur le nom de l'onglet Checks




Supprimer une surcharge inactive

Si une surcharge inactive n'est plus effective, il est possible de la supprimer à l'aide de l'icône de balai au niveau du nom du check  () situé sur chaque ligne du tableau des surcharges désactivées.

Surcharges au format Cfg

Les surcharges réalisées sur les checks sont affichées au format Cfg sous la liste des checks. Cela peut être utile pour dupliquer la configuration avec des fichiers .cfg.

En survolant à l'aide de la souris, un bouton permettant de copier le texte apparaît.