Contexte

Le check Broker - $KEY$ - Module Metrology Writer vérifie 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 ( voir la page Haute disponibilité de la base de métrologie (Graphite) ).

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 Modèle shinken-graphite ) 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 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 : 

• L'état de fonctionnement du démon,
• la version installée,
• 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

Échec de la connexion aux nœuds

Cette erreur arrive lorsque la configuration n'est pas correcte. Il peut y avoir plusieurs sources à ce problème :

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

Avertissement ou erreur dans un nœud

Lorsqu'un ou plusieurs nœuds remontent un dysfonctionnement, celui-ci apparaît dans le check Broker - $KEY$ - Module Metrology Writer. Un avertissement signifie qu'il y a une erreur non bloquante au fonctionnement normal du cache. Il est tout même conseillé d'essayer de résoudre ce problème. Pour avoir plus d'informations sur le problème remonté par le nœud, veuillez vous référer au check Shinken Graphite Status du nœud correspondant ( voir la page Modèle shinken-graphite ).

Le Broker est en cours d'arrêt

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