Contexte

Le check Broker - $KEY$ - Module Metrology Writer vérifie que le bon fonctionnement du module Graphite-Perfdata d'un démon broker ( voir la page Module Graphite-Perfdata )

Paramétrage

Le check utilise la ligne de commande suivante :

$PLUGINSDIR$/check_shinken_module_metrology_writer.py -H "$HOSTADDRESS$" -p "$ARG1$" --shinkenversion "$SHINKENVERSION$" 
-P "$_HOSTSSH_PORT$" -i "$_HOSTSSH_KEY$" -u "$_HOSTSSH_USER$" -r "$_HOSTSSH_KEY_PASSPHRASE$" -d "$_HOSTGRAPHITE_DATA_LOCATION$" 
-U "$_HOSTGRAPHITE_USER$" -D "$_HOSTGRAPHITE_DISKS_LOCATION$" -n "$_HOSTGRAPHITE_PROCESS_NAME$" -w "$_HOSTGRAPHITE_STORAGE_WARNING$" 
-c "$_HOSTGRAPHITE_STORAGE_CRITICAL$" --timeout "$_HOSTCHECK_SHINKEN_TIMEOUT$"

Données utilisées provenant du modèle

Données communes pour les checks du modèle

Données spécifiques pour ce check

Les données DFE ( Duplicate Foreach )

Données utilisées provenant du check

Pas de données spécifiques pour ce check.

Données globales

Propriétés de l'hôte

Mode de fonctionnement du graphite installé

Graphite configuré en mode "Cache"

Les données de métrologie sont stockées seulement dans un carbon-cache.

Il s'agit de la configuration avec laquelle Shinken est livrée.

• Vérifie que le module Graphite-Perfdata peut contacter le serveur hébergeant le service graphite.
• Vérifie que le service est disponible :
  • port réseau ouvert,
  • processus en cours d’exécution,
  • suffisamment d'espace disque,
  • permissions,
  • statistiques d'entrées/sorties disque pour écrire les données de métrologie.
• Renvoie également les statistiques globales et pour chaque worker :
  • Nombre de données reçues,
  • volume et charge du module.

La charge du module est calculée à partir du temps de traitement utilisé par rapport au temps d’exécution que le module dispose pour traiter les données.

Graphite configuré en mode "relais"

Lorsque le service Graphite est configuré comme un relais vers d'autres nœuds de stockage, le check vérifie l'état du relais vers lequel le module Graphite-Perfdata envoie les métriques ; il se connecte également sur les nœuds vers lesquels le relais Graphite relaie les métriques.

Veuillez vous référer à la page Haute disponibilité de la base de métrologie (Graphite) pour la mise en place de cette architecture.

Le check donne :

• du détail sur le relai
• et un aperçu des nœuds carbon-cache.
  Vous devez consulter les checks Shinken Graphite Status ( voir la page shinken-graphite ( Modèle d'hôte ) ) de ces nœuds pour obtenir les détails.

Dans l'exemple ci-contre, le module envoie ses données à un relais ( 192.168.1.58:2013 ), qui transmet les données à deux nœuds "cache" :

• 192.168.1.46:2004
• 192.168.1.49:2004
  
  

Vérifier le détail des carbon-caches

Pour chaque nœud d'un carbon-relay , il est possible d'avoir plus de détails sur son état en allant vérifier le résultat des checks Shinken Graphite Status  pour chaque nœud correspondant. Ces checks sont présents sur des hôtes possédant le modèle d'hôte  shinken-graphite .

• Si le module Module architecture-export de l'Arbiter est activé, les hôtes hébergeant les carbon-cache devraient être automatiquement ajoutés avec le modèle d'hôte shinken-graphite dans le Shinken Entreprise cible de l'architecture-export.
• Sinon, vous devrez les créer manuellement en y accrochant le modèle d'hôte shinken-graphite.
  
  

Envoi des données d'inventaire

Données spécifiques au serveur d'inventaire de métrologie

Exemple d'affichage du check lorsque tout est OK pour les serveurs d'inventaire de métrologie

Différents cas d'erreur

Le serveur d'inventaire de métrologie a reçu des requêtes avec une mauvaise clé d'authentification :

Le serveur d'inventaire de métrologie n'est pas à jour par rapport à la configuration de l'Arbiter :

Résultat

Exemple

Interprétation

Statut

Il peut prendre deux valeurs  OK / CRITIQUE / ATTENTION   /   INCONNU .

• Le statut va dépendre du retour de sonde et de la configuration spécifique du check pour les données suivantes :

  • GRAPHITE_STORAGE_CRITICAL,

  • GRAPHITE_STORAGE_WARNING,
  • CHECK_SHINKEN_TIMEOUT
    
    

• Voici un tableau récapitulatif du statut attendu suivant le retour de sonde :
  
  

Les vérifications communes

Les vérifications spécifiques

Résultat

Renvoi au format texte : 

• Si le démon fonctionne correctement, la version installée et le temps qu'a pris le check pour établir la  communication avec le check.

Résultat Long

Précise le fonctionnement des modules du Broker, leur statut, le nombre de redémarrages lors des 24 dernières heures, la date de dernier redémarrage et les sous-modules

Description des erreurs

• • Une erreur dans la configuration du relai et d'un ( ou plusieurs ) cache. Pensez à bien vérifier les adresses saisies dans les fichiers de configuration de ces éléments ( voir la page Haute disponibilité de la base de métrologie (Graphite) )
  • Une erreur dans les paramètres du check Broker - $KEY$ - Module Metrology Writer. Avec une installation par défaut du relai et des caches, cela ne devrait pas arriver, mais dans le cas où vous avez modifié certains paramètres sur l'hôte ( comme les ports SSH et/ou Graphite ), pensez à répercuter ces changements dans le modèle d'hôte shinken-broker-module-metrology-writer et le check Broker - $KEY$ - Module Metrology Writer.

Lorsque le Broker est en cours d'arrêt, le check le signale, et les informations relatives au module ne sont plus disponibles

Métriques