Sources de données RRD (Expressions RPN)

Les éléments expression des graphiques RRD (Expressions Items) permettent d’effectuer des traitements mathématiques sur les données extraites des bases RRD avant de les afficher. A titre d’exemple si l’on dispose d’une valeur exprimée en Octets par seconde et que l’on souhaite afficher des bits par seconde l’utilisation d’expressions RPN sera incontournable.

Les expressions RPN peuvent être utilisées à de multiples fins. Les expressions RPN doivent respecter la syntaxe RPN (Reverse Polish Notation) couramment utilisée sur les calculatrices HP par exemple. Les expressions RPN doivent utiliser des Data Source Item mais ce n’est pas une obligation.

Pour créer des éléments à partir d’expressions, sélectionnez l’onglet Expression Item lors de la configuration d’un nouveau profil de graphique.

Cliquez sur le bouton Add pour ajouter un élément. L’écran d’édition des expressions RPN s’affiche :

Un expression RPN doit avoir un nom (Virtual Name) et une description.

L’expression se compose directement dans le champ RPN expression si vous êtes habitué à la syntaxe RPN ou grâce au générateur d’expression composée des multiples boutons disponibles.

Une expression RPN utilise la notion de pile (Stack), les données et les opérateurs sont empilés et traité dans l’ordre d’empilement.

L’expression  4,5,+  additionne 4 et 5.

L’expression 4,5,6,+,/    additionne 4 et 5 puis divise ce résultat par 6.

La création de cette expression est réalisée en cliquant successivement sur les boutons suivants :

4 ENTER 5 ENTER 6 ENTER + /

Le résultat obtenu dans la pile est le suivant :

Les expressions RPN les plus variées peuvent être créées à partir de cette interface graphique.

Voici la table de synthèse des opérateurs disponibles.

	Un clavier de saisie de valeur numériques. Entrez les valeurs puis cliquez sur Enter pour valider la ligne de saisie
	Les opérateurs arithmétiques simples : + Addition - Soustraction * Multiplication / Division   pourcentage
	Les opérateurs booléan <  Supérieur <= Supérieur ou égal >  Inférieur >+ Inférieur ou égal + Egal
Fonctions
SIN	Sinus de la valeur
LOG	Logarithme de la valeur
COS	Cosinus de la valeur
EXP	Exponentiel de la valeur
FLOOR
CEIL
Manipulation de la pile
dup	Duplique le dernier élément de la pile
exc	Exchange (swap) les deux dernier élément de la pile
pop	Enlève le dernier élément de la pile
un	Enlève l’élément de la pile si il est de type UNKNOW
unkn	Ajoute l’élément UNKOWN sur la pile
prev	Utilise l’élément qui précède temporellement dans la base ou UNKNWON si il n’y a pas d’élément précédent. Indispensable pour l’exploitation des compteurs SNMP
MIN	Sélection la valeur minimum  parmi deux valeurs (ex : 24,34,MIN retourne 24)
MAX	Sélectionne la valeur maximum parmi deux valeurs (ex :  24,34,MAX retourne 34)
LIMIT	Remplace une valeur par UNKNOW si elle n’est pas situé dans une fourchette de valeurs (ex : DS2,20,30,LIMIT mets la valeur résultante à UNKNOW si DS2 est inférieur à 20 ou supérieur à 30)
INF	Ajoute une valeur infinie positive sur la pile (valeur réservée oo)
NEGINF	Ajoute une valeur infinie négative sur la pile
Curent Time - NOW	Ajoute l’heure sur la pile au format UNIX (nombre de secondes écoulées depuis 1/1/1970)
Sample Time - TIME	Ajoute l’heure associé à une valeur de source de donnée (En secondes écoulées depuis 1/1/1970)
UTC Offset - LTIME	Idem mais en tenant compte du décalage de la zone horaire

Les éléments de la pile peuvent être réorganisé pars les boutons DEL UP DOWN CLEAR

DEL : efface la ligne de la pile sélectionnée

UP : déplace d’un ligne vers le haut la ligne sélectionnée

DOWN : déplace d’une ligne vers le bas la ligne sélectionnée

CLEAR : efface la ligne sélectionnée