RRDTool
rrdtool create ma-base.rrd --step 60 \ DS:ping:GAUGE:120:U:U \ RRA:AVERAGE:0.5:1:60 \ RRA:AVERAGE:0.5:5:288 \ RRA:AVERAGE:0.5:360:28 \ RRA:AVERAGE:0.5:360:124 \
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 : 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 acceptable 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'enregistrement seront utilisés pour calculer un point. Enfin, nous indiquons le nombre de points qui seront conservés dans la base.
Pour mieux comprendre...
Nous avons :
rrdtool create ma-base.rrd --step 60 \ DS:ping:GAUGE:120:U:U \ RRA:AVERAGE:0.5:1:60
Avec : - un cycle de 120 secondes. - une fréquence de lecture de 0.5. - 1 donnée pour établir une valeur par unité de temps (step = 60 secondes). - 60 données conservés soit une archive de donnée s'étalant sur 1 heure.
