Outils pour utilisateurs

Outils du site


app:rrdtool:start

Ceci est une ancienne révision du document !


RRDtool

Étapes pour la création d'une application basée sur rrdtool:

  • Initialiser la base de données. Création de la base de données et préparer pour accepter les données. Il va falloir préciser la quantité de données à sauvegarder, la fréquence de mise à jour des données (step) et quel type de données est sauvegardé.
  • Collecter les données. Un processus devra périodiquement écrire les données dans la base. C'est probablement l’étape qui prendra le plus de temps de développement.
  • Création du graphique. Relire les données de la base pour faire les calculs et créer les graphiques.

La base de données

RRD pour Round Robin Database (base de données tourniquet). Le nombre d'enregistrements est fixe, la taille de la base ne croit pas indéfiniment. Lorsque le dernier enregistrement est écrit l’écriture reprend sur le premier. Ce type de stockage est particulièrement adapté aux données à durée de vie limitée.

La plage de temps servant de base pour la mesure est également bornée (déterminée et fixée). Si plus d'informations sont envoyé à la base, une valeur moyenne sera determinée sur la tranche de de temps servant d'unité de mesure. Une mesure peut donc arriver avec une fréquence plus élevée sans que cela pose problème.

Terminologie

  • DS pour Data Source, description d'une source de données brutes d'où proviennent les informations à destination du stockage. Identifiée par un nom, valeurs brutes utilisées à intervalle régulier (heartbeat).
  • DST pour Data Source Type, une DS est également caractérisée par son type qui peut être:
    • COUNTER, valeur augmentant en continu, la valeur stockée est le delta entre la précédente et la nouvelle.
    • DERIVE, similaire à COUNTER mais permet de stocker des valeurs négatives et de décroître. Le delta est stocké.
    • ABSOLUTE: stocke un delta mais en considérant que la valeur précédente est 0.
    • GAUGE: stocke une valeur (la mesure), non un delta.
  • RRA pour Round Robin Archive, c'est la base de données round robin. Elle peut être assimilée à la définitions de vues. On peut définir différentes façon de stocker les données.
  • PDP pour Primary Data Point. A chaque intervalle de temps égal a step, une nouvelle valeur provenant d'une DS est une PDP. La PDP est qualifiée de primaire car elle n'est pas directement stockée en base, elle est consolidée avant.
  • CDP pour Consolided Data Point, c'est l'entrée dans la base RRA. Il est possible de le determiné à l'aide d'un seul PDP mais tout l’intérêt consiste à consolider la mesure en utilisant plusieurs PDP et une méthode de consolidation CF.
  • CF pour Consolidation Function Lors de la création d'une RRA, RRDtool utilise un certain nombre de PDP pour determiner le CDP a enregistrer. La manière de traiter est définei par un fonction de consolidation: AVERAGE, MINIMUM, MAXIMUN ou LAST.

A la création du fichier base, on définit notamment un plusieurs objets de type DS et de type RRA :

  • DS (Data Source) définit le type de données et les limites permettant de contrôler la validité de la valeur

Data Source

La déclaration d'un DS utilise la syntaxe suivante:

DS:label:DST:heartbeat:min:max

Le champ DST pour Data Source Type peut prendre les valeurs suivantes:

L' heartbeat s'exprime en secondes, c'est un timeout ou temps limite au bout duquel la valeur est considérée inconnue.

min et max permettent de définir un intervalle de validité pour la valeur. Toute valeurs hors de cet intervalle sera considérée inconnue.

Ci dessous, un exemple de déclaration utilisé pour stocker des relevés de température:

DS:temp-sonde1:GAUGE:600:55:95 \

Dans l'exemple ci dessus, on définit une variable de type mesure dont le nom est temp-sonde1 avec des valeurs pouvant varier dans l'intervalle [55, 95]. La Fenetre de validité d'une mesure est de 600 secondes.

RRA

Définition des Round Robin Archives. Une base RRD peut contenir une ou plusieurs RRA. Chaque RRA est une vue différente stockant indépendamment les données chacune avec un nombre prédéfinit d'enregistrements. Lors de l'insertion d'une valeur( appelée PDP pour Primary Data Point) la valeur enregistrée dans chaque RRA après combinaison avec les valeurs précédentes. Cette opération est effectuée via les fonctions de consolidation ou CF (Consolidation Function)

Syntaxe:

RRA:CF:XFF:nb_PDPs:nb_REC

Le champ CF pour Consolidation function peut prendre l'une des valeurs suivantes:

  • AVERAGE
  • MIN
  • MAX
  • LAST

Le champ XFF XFiles Factor, c'est le pourcentage de PDPs pouvant être inconnus avant de rendre la valeur enregistrée inconnue.

La valeur nb_PDPs correspond au nombre de PDP utilisés pour un enregistrement.

La valeur nb_REC

Exemples

  • Enregistrer le temps moyen de réponse d'un ping sur 1h ping-graph

Références

app/rrdtool/start.1522008621.txt.gz · Dernière modification : 2021/02/01 21:51 (modification externe)