But du script de récupération


Le script shinken-gatherer a pour but de collecter des données en tâche de fond des daemons.

  • Pour graphite:
    • Comptage du nombre d'hôtes et métriques présent dans les données de graphite.
    • Récupération de l'activité disque ( ça prend du temps pour avoir des valeurs stables donc trop long pour un check ).

  • Pour VMWare:
    • Récupération des statistiques de disponibilité CPU des VMs.



Utilisation du script

  • /etc/init.d/shinken-gatherer start => vérifie qu'il n'est pas lancé, et le démarre si nécessaire
  • /etc/init.d/shinken-gatherer stop => vérifie qu'il est arrêté, et l'éteint si nécessaire
  • /etc/init.d/shinken-gatherer status => indique si il est démarré ou éteint


Les différents cas de démarrage du script

Le script se lance automatiquement sur les actions suivantes:

  • Quand on lance shinken en entier ou un seul daemon ( /etc/init.d/shinken(*) start )
  • Si on lance carbon-cache ( /etc/init.d/carbon-cache start )
  • Si on le lance/arrête spécifiquement ( /etc/init.d/shinken-gatherer start/stop/status )

Logs du script

Le log du script est disponible sur /var/log/shinken/gathererd.log. Le niveau de log est INFO.


A noter:
  • la rotation normale ( 6 jours ) des logs est active.
  • le script accepte  les niveaux de log suivant : DEBUG, INFO, WARNING, CRITICAL.
  • le niveau de log se change dans /etc/shinken/deamons/gathererd.ini
# accepted log level values= DEBUG, INFO, WARNING, CRITICAL
log_level=INFO


Descriptions des variables


PropriétéDéfautDescription
use_local_log1Cette variable est utilisée pour définir le nom du Poller.
local_log%(logdir)s/gathererd.logCette directive est utilisée pour définir l'adresse permettant de joindre ce Poller. Par défaut "localhost", changez-le par un nom DNS ou une adresse IP.
logdir/var/log/shinkenCette directive est utilisée pour définir le port TCP utilisé par ce démon.
log_levelINFOCette variable est utilisée pour définir si le Poller doit être contacté en HTTPS (*1*) ou HTTP (*0*). La valeur par défaut est *0* (HTTP).
vmware_statistics_compute_enable1Cette variable permet de désactiver la collecte de la charge CPU sur la VM.
Peut-être, pratique dans le cas où les vmware-tools de la VM ne sont pas activés ou ne fournissent pas toutes les informations attendues.


Les données collectées

Récupération du nombre d'hôte et métriques dans Graphite

Le script compte

  • le nombre d'hôtes en comptant les répertoires dans /opt/graphite/storage/whisper
  • le nombre de métriques en comptant les fichiers .wsp dans /opt/graphite/storage/whispe

et mets le résultat dans /opt/graphite/storage/whisper/.nb_metrics


  • Si le script n'a jamais tourné, graphite fera lui-même la vérification lorsqu'on lui demande le compte
  • Si le script ne tourne plus, graphite retournera des données qui ne sont plus à jour.
    • => Le shinken-healthcheck vous indiquera que l'information n'est plus à jour sur ce serveur.
    • => le check "Broker - $KEY$ - Module Visualisation UI - Metrology Reader" vous l'indiquera aussi.


Récupération des données d'activité disque

Il écrit le fichier /dev/shm/__check_graphite_iostats.tmp avec les données des disques (issu de /proc/diskstats) pour le %util de chaque disk ( physique, PAS partition )

Si le script ne fonctionne pas:

  • Le check de graphite writer sera en UNKNOWN en mettant qu'il n'arrive pas à lire le fichier.

Récupération des données de VMWare


  • la variable vmware_statistics_compute_enable dans le fichier /etc/shinken/deamons/gathererd.ini permet de choisir activation de la récupération des données de VMWare.
vmware_statistics_compute_enable=1



Il écrit le fichier /dev/shm/vmware_stats_export.dat si le serveur est une VM VMWare. Il écrit dedans quand il a fait la vérification, si c'est une VM VMWare et la valeur du %ready.


Si le script n'a pas tourné (depuis le redémarrage du serveur):

  • Le daemon a qui on fait la demande va retourner que le serveur n'est pas une VMWare.

Si le script a déjà tourné (depuis le redémarrage du serveur), mais ne tourne plus:

  • Le daemon va retourner les dernières valeurs mesurées:
    • donc pas de soucis si VM/pas VM, ça ne change pas
    • mais les mesures CPU seront fausses