Page History

Contexte

Le check Broker - $KEY$ - Module

Visualisation UI - Metrology Reader affiche des statistiques concernant les métriques disponibles sur chaque serveur de métriques.

Il permet de vérifier que le module WebUI peut contacter les serveurs de métriques pour chacun des royaumes que la WebUI gère.

Pour chacun des serveurs graphite, le check va vérifier les points suivants :

• Est-ce que le module WebUI a accès au serveur graphite ?
• Combien d'hôtes sont hébergés sur le serveur ?
• Combien de métriques dispose le serveur ?
• Est-ce que le processus graphite fonctionne ?
• Est-ce que le serveur dispose d'assez d'espace disque ?
  
  

Paramétrage

Le check utilise la ligne de commande suivante :

$PLUGINSDIR$/check_shinken_broker_module_visualisation_ui_metrology_writerreader.py -H "$HOSTADDRESS$" -p "$ARG1$" 
-w "$ARG2$" --shinkenversion "$SHINKENVERSION$" 
 -P "$_HOSTSSH_PORT$" -i "$_HOSTSSH_KEY$" -u "$_HOSTSSH_USER$" 
-r "$_HOSTSSH_KEY_PASSPHRASE$" -d "$_HOSTGRAPHITE_DATA_LOCATION$" 
-U-timeout "$_HOSTGRAPHITE_USER$" -D "$_HOSTGRAPHITE_DISKS_LOCATION$" -n "$_HOSTGRAPHITE_PROCESS_NAME$" -w "$_HOSTGRAPHITE_STORAGE_WARNING$" 
-c "$_HOSTGRAPHITE_STORAGE_CRITICAL$" --timeout "$_HOSTCHECK_HOSTCHECK_METROLOGY_READER_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"

Graphite configuré en mode "relais"

Paramètre du check

• Vu que le check est exécuté sur un Poller, il faut permettre à ce dernier d'accéder aux serveurs graphite en SSH .
  • D’où la nécessité de paramétrer les données  SSH_KEY, SSH_KEY_PASSPHRASE, SSH_PORT, SSH_USER.
  • REMARQUE : il est obligatoire en l’état du check actuel que cette même clef soit autorisée sur tous les serveurs graphites surveillés.
• Si un autre check Shinken a déjà été paramétré avec une clé SSH pour accéder au serveur graphite, vous pouvez bien sûr reprendre cette même clé.

Données globales

Propriétés de l'hôte

Résultat

Exemple

Vérifier le détail des carbon-caches

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 :
  • GRAPHITECHECK_STORAGE_CRITICAL,GRAPHITE_STORAGE_WARNING,METROLOGY_READER_SHINKEN_TIMEOUT
  • CHECK_SHINKEN_TIMEOUT
    
    

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

Les vérifications

spécifiques

Les vérifications spécifiques

Résultat

Renvoi au format texte : 

• Si le démon serveur graphite 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

Echec de la connexion aux nœud

• et les statistiques des modules

Résultat Long

Rapport détaillé sur : 

• Accès du serveur graphite par le module WebUI
• Nombre d'hôtes sont hébergés sur le serveur
• Nombre de métriques dispose le serveur
• Fonctionnement du processus graphite
• Disponibilité de suffisamment d'espace disque pour le server

Description des erreurs

Le Graphite backend d'un royaume utilise un port non valide

Si dans le graphite_backends d'une WebUI, une adresse utilise un port HTTP non valide, alors une erreur est remontée dans le check.

Par exemple, le graphite_backends suivant va remonter une erreur :

graphite_backends    *:127.0.0.1:80, Italie:192.168.1.26:80, Japon:127.0.0.1:invalid_port

Les métriques ne seront alors pas disponibles pour ce royaume.

Panel
Image Added

Le Graphite backend d'un royaume utilise n'a pas d'adresse

Si dans la définition d'un Graphite backend d'un royaume, l'adresse (  ou l'IP   ) est manquante, alors une erreur est remontée.

Par exemple, le graphite_backends suivant va remonter une erreur :

graphite_backends    *:127.0.0.1:80, Italie::80, Japon:127.0.0.1:80

Les métriques ne seront alors pas disponibles pour ce royaume.

Un ou plusieurs royaumes n'ont pas de Graphite backend

Si dans la définition d'un graphite_backends, un ou plusieurs royaumes n'ont pas d'adresse définie, mais qu'il sont quand même gérés par le Broker, alors une erreur sera remontée dans le check.

Par exemple, un Broker gère les royaumes suivants :  All, France, Italie, Japon

Maintenant, une des WebUI du Broker a le graphite_backends suivant :

graphite_backends    France:192.168.1.23:80

Alors, les royaumes "All, Italie et Japon" n'ont pas de Graphite backend défini par la WebUI, ce qui aura pour conséquence que les éléments de ces royaumes n'auront pas accès à leurs métriques.

Le Graphite backend d'un royaume n'utilise pas un protocole valide

Si la définition d'un Graphite backend utilise un protocole qui n'est pas valide, le check remonte une erreur pour le backend concerné.

Par exemple, le graphite_backends suivant va remonter une erreur :

graphite_backends    *:192.168.1.23:80, France:htt://192.168.1.23:80

Les métriques ne seront alors pas disponibles pour ce royaume.

Un ou plusieurs royaumes n'est pas géré par le Broker

Le check nous averti lorsqu'un royaume est présent dans la définition des graphite_backends de la WebUI et que celui-ci n'est pas géré par le Broker.

Par exemple, un Broker gère les royaumes :  All, France, Italie, Japon

Mais la définition d'une de ses WebUI est la suivante :

graphite_backends    *:127.0.0.1:80, Canada:192.168.1.44

Dans ce cas, le royaume Canada n'est pas géré par le Broker et sera donc ignoré.

Ce problème ne bloque pas le fonctionnement du module, il suffit juste d'enlever ou de corriger l'adresse de ce royaume dans la configuration de la WebUI pour enlever cet avertissement.

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 conseiller 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 shinken-graphite ( Modèle d'hôte ) ).

Panel
Image Removed

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