Versions Compared

Old Version 7

changes.mady.by.user Quentin Soubeyrol

Saved on

compared with

New Version Current

changes.mady.by.user Soubrié Grégoire

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Make by tools (01.00.01) - action=clean_macro_parameter
Scroll Ignore
scroll-pdftrue
scroll-officetrue
scroll-chmtrue
scroll-docbookhtmltruefalse
scroll-eclipsehelpdocbooktrue
scroll-epubeclipsehelptrue
scroll-htmlepubtrue
Panel
titleSommaire

Table of Contents
stylenone

Contexte

Dans une installation où une haute disponibilité a été paramétré paramétrée pour le stockage de la métrologie ( un carbon-relay et 2 carbone-cache ), le modèle shinken-graphite vous permet de superviser les nœuds de stockage ( carbon-cache ).

Info

Avant Pour plus d'aller plus loin, nous vous conseillons de lire les chapitres suivant :informations sur Graphite, voir les pages :

Il permet d'obtenir des informations sur les nœuds d'écriture ( carbon-cache ) grâce au check Shinken Graphite Status qui lui est rattaché ( détaillé plus bas sur cette page ).

Ce modèle est attaché automatiquement aux hôtes grâce au listener Shinken aux hôtes possédant un carbon-cache relié à un carbon-relay.

  • Vous pouvez aussi l'accrocher manuellement.

Sommaire des checks

Nom

Description

Shinken Graphite Status

Affiche le bon fonctionnement et les statistiques de la base de métrologie Graphite ( voir la page Base de métrologie ( Graphite ) )

Les données

Les données communes pour tous les checks

Provenant du modèle shinken

Pas de données communes pour ce check.

Provenant du modèleshinken-

daemon

Pas de données provenant du modèle shinken-daemon pour ce check.

Données spécifiques pour ce check

graphite

Excerpt Include
Mode actif et mode passif
Mode actif et mode passif
nopaneltrue

Les données spécifiques

Pour le check "Shinken Graphite Status"

Excerpt Include
Shinken Graphite Status
Shinken Graphite Status
nopaneltrue

Les données DFE ( Duplicate Foreach )

Pas de données DFE pour ce modèle.

Comment appliquer un modèle d'hôte à un hôte

Excerpt Include
Comment appliquer un modèle d'hôte à un hôte - Pack shinken
Comment appliquer un modèle d'hôte à un hôte - Pack shinken
nopaneltrue

Excerpt
hiddentrue
NomModifiable sur UnitésDéfautValeur par défaut à l'installation de ShinkenDescription
No Format
SSH_KEY

l'Hôte

NomModifiable sur UnitésDéfautValeur par défaut à l'installation de ShinkenDescription
No Format
GRAPHITE_CACHE_NAME

Modèle d'hôte

( Onglet Données )

---carbon-cachecarbon-cache

Le nom du service utilisé pour le cache de Graphite.

No Format
GRAPHITE_RELAY_NAME

Modèle d'hôte

( Onglet Données )

---carbo-relaycarbon-relay

Le nom du service utilisé pour le relai de Graphite.

No Format
GRAPHITE_DATA_LOCATION

Modèle d'hôte

( Onglet Données )

---/opt/graphite/storage/whisper/opt/graphite/storage/whisper

L'endroit où est stocké les métriques reçues.

No Format
GRAPHITE_PORT

Modèle d'hôte

( Onglet Données )

---20032003

Le port de connexion au serveur Graphite.

No Format
GRAPHITE_STORAGE_CRITICAL

Modèle d'hôte

( Onglet Données )

---9595

Le seuil ( en pourcentage ) d'espace disque utilisé pour lequel on veut lever une alerte critique.

No Format
GRAPHITE_STORAGE_WARNING

Modèle d'hôte

( Onglet Données )

---8585

Le seuil ( en pourcentage ) d'espace disque utilisé pour lequel on veut lever un avertissement.

No Format
GRAPHITE_USER

Modèle d'hôte

( Onglet Données )

---apacheapache

Le nom d'utilisateur utilisé pour se connecter à la base Graphite.

No Format
SSH_KEY
Modèle d'hôte

( Onglet Données )

---

$SSH_KEY$$SSH_KEY$
Le chemin vers le dossier où se trouver les clé SSH à utiliser
Clé SSH utilisée pour se connecter au
nœud où se situe le cache Graphite.
serveur Graphite
No Format
SSH_KEY_PASSPHRASE
Modèle d

l'

hôte

Hôte

( Onglet Données )

---

$SSH_KEY_PASSPHRASE$$SSH_
KEY_
PASSPHRASE$Le mot de passe de la clé SSH
privée.
No Format
SSH_PORT
Modèle d

l'

hôte

Hôte

( Onglet Données )

---

$SSH_PORT$$SSH_PORT$
Le port utilisé pour la connexion SSH.
Port SSH des serveurs Graphite
No Format
SSH_USER
Modèle d

l'

hôte

Hôte

( Onglet Données )

---

$SSH_USER$$SSH_USER$

Le nom d'utilisateur avec le quel se connecter pour la connexion SSH.

Les données DFE ( Duplicate Foreach )

Pas de données DFE pour ce check.

Données globales

Pas de données global pour ce check.

Comment appliquer un modèle d'hôte à un hôte

Excerpt IncludeComment appliquer un modèle d'hôte à un hôte - Pack shinkenComment appliquer un modèle d'hôte à un hôte - Pack shinkennopaneltrue

Description des checks

Shinken Graphite Status

Mode du fonctionnement du cache

Une fois les hôtes ajoutés par l'export de l'architecture, les checks Shinken Graphite Status donnent les informations suivantes sur les hôtes :

  • File permission : Si le carbon-cache dispose de droits suffisants pour écrire sur le disque.
  • Metric reception : Des informations sur le service carbon-cache.
  • Storate I/O statistics : Des informations sur l'utilisation du disque (espace disponible, lecture et écriture) par le service carbon-cache.

Remarque: Il est possible de changer le type de cache utilisé, pensez à changer les variables GRAPHITE_CACHE_NAME par le nom du service de votre cache ( ou relay ) dans les hôtes concernés.

Dans le cas du carbon-relay, c'est la variable GRAPHITE_RELAY_NAME qu'il faut changer ( valeurs par défaut respectives : carbon-cache et carbon-relay ).

Panel

Image Removed

Erreur dans un check Shinken Graphite Status

Le check Shinken Graphite Status fait appel à deux services pour récupérer les données à afficher :

  1. carbon-cache : On a besoin de savoir si il peut recevoir les métriques.
  2. shinken-gatherer : Utilisé pour avoir des informations sur l'utilisation ( lecture & écriture ) du disque de l'hôte.

Pour vérifier l'état de ces services

Si un service n'est pas trouvé, une solution peut être de tenter de le relancer sur l'hôte en question à l'aide des commandes suivante :

Relancer le shinken-gatherer :

service shinken-gatherer restart

Relancer le carbon-cache :

service carbon-cache restart

Dans le cas où l'on ne peut pas récupérer les données sur l'utilisation du disque ( typiquement le shinken-gatherer  ne fonctionne pas ), l'erreur remontée est seulement catégorisée comme un avertissement puisque cela ne va pas bloquer le fonctionnement du carbon-cache. On ne peut juste pas être informé des statistiques sur le disque ( lecture et écriture ). Il est tout de même conseillé de résoudre le problème car il peut être important de savoir si le disque de l'hôte est saturé.

Remarque: Le check utilise le nom des services pour vérifier leurs états. Si un service n'est pas trouvé, il est possible que les noms indiqués dans les variables GRAPHITE_CACHE_NAME et GRAPHITE_RELAY_NAME des hôtes ne soient pas ceux des services (en fonction des implémentations utilisées).

Panel

Image Removed

Paramètres du check

Nom de la donnéeDescriptionValeur par défautHérité d'un autre modèle ou localePLUGINSDIRChemin vers le dossier où se situe le script du check./var/lib/shinken/libexecDonnée globaleHOSTADDRESSAdresse de l'hôte où se situe de cache de Graphite.Paramètre du script

Métriques du check

En plus des retours sur l'état des composants liés à graphite, le check Shinken Graphite Status nous renvoie les métriques suivantes

MétriqueDescriptionExemple(adresse_graphite)_graphite_disk_(nom_du_disque)_IOUtilisation du disque ( lecture et écriture ) en pourcentage.192.168.1.123_graphite_disk_sda_IO=25%(adresse_graphite)_graphite_storage_sizeUtilisation du disque ( espace utilisé ) en pourcentage.192.168.1.123_graphite_storage_size=16%(nom_worker)_last_minute_work_timeNombre de secondes où le worker à travailler durant la dernière minute.worker_0_last_minute_work_time=0.0021000(nom_worker)_last_minute_metrics_sent_nbNombre de métriques que le worker a envoyé durant la dernière minute.worker_0_last_minute_metrics_sent_nb=256

Détails de la commande

Nom du checkCommande du checkLigne de commandeShinken Graphite Statuscheck_shinken_graphite$PLUGINSDIR$/check_shinken_graphite.py -H "$HOSTADDRESS$" -u "$_HOSTSSH_USER$" -p "$_HOSTSSH_PORT$" -i "$_HOSTSSH_KEY$" -P "$_HOSTSSH_KEY_PASSPHRASE$" -s "$_HOSTGRAPHITE_PORT$" -d "$_HOSTGRAPHITE_DATA_LOCATION$" -U "$_HOSTGRAPHITE_USER$" -w "$_HOSTGRAPHITE_STORAGE_WARNING$" -c "$_HOSTGRAPHITE_STORAGE_CRITICAL$" -n "$_HOSTGRAPHITE_CACHE_NAME$" -R "$_HOSTGRAPHITE_RELAY_NAME$"
Utilisateur SSH des serveurs Graphite