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