Documentation
Table of Contents
7 ?l¨¦ments calcul¨¦s
Aper?u
Avec les ¨¦l¨¦ments calcul¨¦s, il est possible de cr¨¦er des calculs bas¨¦s sur les valeurs d'autres ¨¦l¨¦ments.
Les calculs peuvent utiliser ¨¤ la fois :
- des valeurs uniques d'¨¦l¨¦ments individuels
- des filtres complexes pour s¨¦lectionner plusieurs ¨¦l¨¦ments pour les agr¨¦gations (voir calculs agr¨¦g¨¦s pour plus de d¨¦tails)
Ainsi, les ¨¦l¨¦ments calcul¨¦s sont un moyen de cr¨¦er des sources de donn¨¦es virtuelles. Tous les calculs sont effectu¨¦s par le serveur Áú»¢¶Ä²© uniquement. Les valeurs sont calcul¨¦es p¨¦riodiquement en fonction de l'expression arithm¨¦tique utilis¨¦e.
Les donn¨¦es r¨¦sultantes sont stock¨¦es dans la base de donn¨¦es Áú»¢¶Ä²© comme pour tout autre ¨¦l¨¦ment ; les valeurs d'historique et de tendance sont stock¨¦es et des graphiques peuvent ¨ºtre g¨¦n¨¦r¨¦s.
Si le r¨¦sultat du calcul est une valeur flottante, il sera r¨¦duit ¨¤ un nombre entier si le type d'information de l'¨¦l¨¦ment calcul¨¦ est Num¨¦rique (non sign¨¦).
Les ¨¦l¨¦ments calcul¨¦s partagent leur syntaxe avec les expressions de d¨¦clencheur. La comparaison avec des cha?nes est autoris¨¦e dans les ¨¦l¨¦ments calcul¨¦s. Les ¨¦l¨¦ments calcul¨¦s peuvent ¨ºtre r¨¦f¨¦renc¨¦s par des macros ou d'autres entit¨¦s identiques ¨¤ tout autre type d'¨¦l¨¦ment.
Pour utiliser des ¨¦l¨¦ments calcul¨¦s, choisissez le type d'¨¦l¨¦ment °ä²¹±ô³¦³Ü±ô¨¦.
Champs configurables
La ³¦±ô¨¦ est un identifiant d'¨¦l¨¦ment unique (par h?te). Vous pouvez cr¨¦er n'importe quel nom de ³¦±ô¨¦ ¨¤ l'aide des symboles pris en charge.
La d¨¦finition du calcul doit ¨ºtre saisie dans le champ Formule. Il n'y a pratiquement aucun lien entre la formule et la ³¦±ô¨¦. Les param¨¨tres ³¦±ô¨¦s ne sont en aucun cas utilis¨¦s dans la formule.
La syntaxe d'une formule simple est :
o¨´ :
| fonction | L'une des fonctions prises en charge: last, min, max, avg, count, etc |
| h?te | H?te de l'¨¦l¨¦ment utilis¨¦ pour le calcul. L'h?te actuel peut ¨ºtre omis (comme dans fonction(//³¦±ô¨¦,param¨¨tre,...)). |
| ³¦±ô¨¦ | Cl¨¦ de l'¨¦l¨¦ment utilis¨¦ pour le calcul. |
| ±è²¹°ù²¹³¾¨¨³Ù°ù±ð(²õ) | Param¨¨tres de la fonction, si n¨¦cessaire. |
Les macros utilisateur de la formule seront d¨¦velopp¨¦es si elles sont utilis¨¦es pour r¨¦f¨¦rencer un param¨¨tre de fonction, un param¨¨tre de filtre d'¨¦l¨¦ment ou une constante. Les macros utilisateur ne seront PAS d¨¦velopp¨¦es si elles font r¨¦f¨¦rence ¨¤ une fonction, un nom d'h?te, une ³¦±ô¨¦ d'¨¦l¨¦ment, un param¨¨tre de ³¦±ô¨¦ d'¨¦l¨¦ment ou un op¨¦rateur.
Une formule plus complexe peut utiliser une combinaison de fonctions, d'´Ç±è¨¦°ù²¹³Ù±ð³Ü°ù²õ et de parenth¨¨ses. Vous pouvez utiliser toutes les fonctions et tous les ´Ç±è¨¦°ù²¹³Ù±ð³Ü°ù²õ pris en charge dans les expressions de d¨¦clencheur. La logique et la priorit¨¦ des ´Ç±è¨¦°ù²¹³Ù±ð³Ü°ù²õ sont exactement les m¨ºmes.
Contrairement aux expressions de d¨¦clencheur, Áú»¢¶Ä²© traite les ¨¦l¨¦ments calcul¨¦s en fonction de l'intervalle de mise ¨¤ jour des ¨¦l¨¦ments, et non lors de la r¨¦ception d'une nouvelle valeur.
Tous les ¨¦l¨¦ments r¨¦f¨¦renc¨¦s par les fonctions d'historique dans la formule d'¨¦l¨¦ment calcul¨¦ doivent exister et collecter des donn¨¦es. De plus, si vous modifiez la ³¦±ô¨¦ d'¨¦l¨¦ment d'un ¨¦l¨¦ment r¨¦f¨¦renc¨¦, vous devez mettre ¨¤ jour manuellement toutes les formules utilisant cette ³¦±ô¨¦.
Un ¨¦l¨¦ment calcul¨¦ peut devenir non pris en charge dans plusieurs cas :
- l'article(s) r¨¦f¨¦renc¨¦(s)
- n'est pas trouv¨¦
- est d¨¦sactiv¨¦
- appartient ¨¤ un h?te d¨¦sactiv¨¦
- n'est pas pris en charge (sauf avec la fonction nodata() et les ´Ç±è¨¦°ù²¹³Ù±ð³Ü°ù²õ avec des valeurs inconnues)
- pas de donn¨¦e pour calculer une fonction
- division par z¨¦ro
- syntaxe incorrecte utilis¨¦e
Exemples d'utilisation
Exemple 1
Calcul du pourcentage d'espace disque libre sur '/'.
Utilisation de la fonction last:
Áú»¢¶Ä²© prendra les derni¨¨res valeurs pour les espaces disque libres et totaux et calculera le pourcentage selon la formule donn¨¦e.
Exemple 2
Calcul d'une moyenne sur 10 minutes du nombre de valeurs trait¨¦es par Áú»¢¶Ä²©.
Utilisation de la fonction avg:
Notez qu'une utilisation intensive d'¨¦l¨¦ments calcul¨¦s avec de longues p¨¦riodes peut affecter les performances du serveur Áú»¢¶Ä²©.
Exemple 3
Calcul de la bande passante totale sur eth0.
Somme de deux fonctions :
Exemple 4
Calcul du pourcentage du trafic entrant.
Expression plus complexe :
Voir ¨¦galement : Exemples de calculs agr¨¦g¨¦s