Sommaire

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 démons.

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

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 s'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

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/whisper

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


Important

  • Si le script n'a jamais tourné, graphite fera lui-même la vérification lorsqu'on lui demande le nombre d’hôtes et de métriques
  • Si le script ne fonctionne 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 disque ( 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 l'activation de la récupération des données de VMWare.

#-- VMware management --
# Get the VMware statistics
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 CPU Stolen (%ready + %costop).


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

  • Le démon 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 démon 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