Documentation
Table of Contents
7 Elements calculats
Visi¨® general
Un element calculat permet crear un c¨¤lcul basat en el valors d'alguns elements existents. Per exemple, ¨¦s possible que vulgueu calcular la mitjana hor¨¤ria d'algun valor d'element o calcular el valor total d'un grup d'elements. Per a aix¨° serveixen els elements calculats.
Els c¨¤lculs poden emprar aquestes dues:
- valors individuals d'elements individuals
- un filtre complex per seleccionar diversos elements per a l'agregaci¨® (per tindre m¨¦s detalls, llegiu els c¨¤lculs afegits)
Els elements calculats s¨®n una manera de crear fonts de dades virtuals. Tots els c¨¤lculs els fa nom¨¦s el servidor Áú»¢¶Ä²©. Els valors s¨®n peri¨°dics i es calculen a partir de l'expressi¨® aritm¨¨tica emprada.
Les dades resultants s'emmagatzemen a la base de dades Áú»¢¶Ä²© com per a qualsevol altra element; s'emmagatzemen tant els valors hist¨°rics com les tend¨¨ncies i es poden emmagatzemar els gr¨¤fics generats.
Si el resultat del c¨¤lcul ¨¦s un valor flotant, ho ser¨¤ retallat a un nombre enter si el tipus d'informaci¨® d'element calculat ¨¦s Num¨¨ric (sense signe).
A m¨¦s, si no hi ha dades recents a la mem¨°ria cau i no hi ha un per¨ªode de consulta definit a la funci¨®, per defecte Áú»¢¶Ä²© anir¨¤ enrere fins a una setmana per consultar a la base de dades els valors hist¨°rics.
Els elements calculats comparteixen la seva sintaxi amb les expressions de trigger. Es permeten les comparacions amb cadenes. Els elements calculats es poden fer refer¨¨ncia per macros o altres entitats iguals a qualsevol altre tipus d'element.
Per emprar elements calculats, trieu el tipus d'element Calculat.
Camps configurables
La clau ¨¦s un identificador d'element ¨²nic (per equip). Podeu crear qualsevol nom de clau emprant s¨ªmbols admesos.
La definici¨® del c¨¤lcul s'ha d'introduir al camp ¹ó¨®°ù³¾³Ü±ô²¹. Gaireb¨¦ no hi ha connexi¨® entre la f¨®rmula i la clau. Els par¨¤metres clau no s'empren a la f¨®rmula de cap manera.
La sintaxi d'una f¨®rmula simple ¨¦s:
O:
| function | Una de les funcions admeses: last, min, max, avg, count, etc |
| host | Equip de l'element emprat per al c¨¤lcul. L'equip actual es pot ometre (com a function(//key,parameter,...)). |
| key | Clau de l'element emprat per al c¨¤lcul. |
| ±è²¹°ù¨¤³¾±ð³Ù°ù±ð(²õ) | Par¨¤metres de funci¨®, si cal. |
Les macros d'usuari de la f¨®rmula s'ampliaran si s'empren per fer refer¨¨ncia a un par¨¤metre de funci¨®, un par¨¤metre de filtre d'element o una constant. Les macros d'usuari NO s'ampliaran pas si fan refer¨¨ncia a una funci¨®, nom d'equip, clau d'element, par¨¤metre de clau d'element o operador.
Una f¨®rmula m¨¦s complexa pot emprar una combinaci¨® de funcions, operadors i par¨¨ntesis. Podeu emprar totes les funcions admeses i operators a les expressions de triggers. La l¨°gica i la preced¨¨ncia de l'operador s¨®n exactament la mateixa.
A difer¨¨ncia dels triggers, Áú»¢¶Ä²© processa els elements calculats en funci¨® de l'interval d'actualitzaci¨® de l'element, no quan es rep un valor nou.
Tots els elements als quals fan refer¨¨ncia les funcions d'hist¨°ric a la f¨®rmula d'elements calculats han d'existir i recopilar dades. A m¨¦s, si canvieu la clau d'element d'un element de refer¨¨ncia, haureu d'actualitzar manualment totes les f¨®rmules amb aquesta clau.
Un element calculat pot quedar sense suport en diversos casos:
- els articles de refer¨¨ncia
- no es troba
- ¨¦s inhabilitat
- pertany a l'equip desactivat
- no ¨¦s compatible (excepte amb la funci¨® nodata() i operadors amb valors desconeguts)
- No hi ha dades per calcular una funci¨®
- Divisi¨® per zero
- S'empra una sintaxi incorrecta
Exemples d'¨²s
Exemple 1
C¨¤lcul del percentatge d'espai lliure de disc a '/'.
?s de la funci¨® last:
Áú»¢¶Ä²© prendr¨¤ els darrers valors per l'espai en disc lliure i el total, i calcular¨¤ el percentatge segons la f¨°rmula donada.
Exemple 2
C¨¤lcul de la mitjana sobre 10 minuts del nombre de valors tractats per Áú»¢¶Ä²©.
?s de la funci¨® avg:
Veieu que un ¨²s intensiu d'elements calculats amb per¨ªodes llargs pot afectar el rendiment del servidor Áú»¢¶Ä²©.
Exemple 3
C¨¤lcul de l'amplada de banda total de l'eth0.
Suma de dues funcions:
Exemple 4
C¨¤lcul del percentatge de tr¨¤fic entrant.
Expressi¨® m¨¦s complexa:
Veieu tamb¨¦: Exemples de c¨¤lculs agregats