RRDTool

De Wiki NCad
Aller à : navigation, rechercher

Présentation

rrdtool create ma-base.rrd --step 60  \
  DS:ping:GAUGE:120:U:U \
  RRA:AVERAGE:0.5:1:60

La création d'une base RRDTool s'articule autour de trois point :

  • le nom de la base et la durée d'un prélèvement de données.
  • la définition de la source de données DS : type de données, l’intervalle de temps minimal entre deux valeurs, valeurs maximales et minimales.
  • Une ou plusieurs archives de données RRA : type de valeur(s) enregistrée(s) (moyenne, maximum, minimum, dernière mesure), fréquence de lecture de la donnée, nombre de valeurs utilisées pour faire une moyenne, nombre d'enregistrements conservés.

Par exemple, en reprenant la base plus haut, à la première ligne nous procédons à la création de la base de données ma-base.rrd pour laquelle après 60 secondes, les données collectés seront traitées et constitueront une première valeur.

La seconde ligne permet de définir une source de données dans la base. La valeur 120 indique la période de temps mesurée pour une valeur (appelé aussi cycle). Si pendant cette période aucune valeur n'est mesurée, alors RRDTool retournera comme résultat NaN (Not a Number). Ensuite, on peut définir une plage de données acceptables avec une valeur minimale et maximale.

La troisième ligne indique comment les données recueillis doivent être archivées. Tous d'abord nous définissons la fréquence de lecture pour un cycle. Pour un cycle de 120 secondes nous aurons deux lectures soit 1 toutes les 60 secondes. Ensuite, nous indiquons combien d'enregistrements seront utilisés pour calculer un point. Enfin, nous indiquons le nombre de points qui seront conservés dans la base.

Pour mieux comprendre...

Objectif : Je souhaite enregistrer toutes les 60 secondes la mesure du ping.

Je crée la base suivante :

rrdtool create ping.rrd --step 60  \
  DS:ping:GAUGE:120:U:U \
  RRA:AVERAGE:0.5:1:60

Avec :

  • Un cycle de 120 secondes maximum entre deux valeurs de ping mesurées.
  • Une fréquence de lecture de 0.5 soit une toutes les 60 seconde (0.5 x 120).
  • J'utilise 1 donnée pour établir une valeur par unité de temps (step = 60 secondes).
  • 60 données conservés soit un relevé du ping s'étalant sur 1 heure.