Documentation
Table of Contents
7 Eléments calculés
Aperçu
Avec les éléments calculés, vous pouvez créer des calculs sur la base d'autres éléments.
Ainsi, les éléments calculés sont un moyen de créer des sources de données virtuelles. Les valeurs seront calculées périodiquement en fonction d'une expression arithmétique. Tous les calculs sont effectués par le serveur Zabbix - aucun élément lié aux éléments calculés n'est effectué sur les agents ou proxys Zabbix.
Les données résultantes seront stockées dans la base de données Zabbix comme pour tout autre élément - cela signifie stocker à la fois l'historique et les valeurs des tendances pour la génération rapide de graphiques. Les éléments calculés peuvent être utilisés dans les expressions de déclencheur, référencés par des macros ou d'autres entités identiques à tout autre type d'élément.
Pour utiliser les éléments calculés, choisissez le type d'élément Calculé.
Champs configurables
La clé est un identifiant d'élément unique (par hôte). Vous pouvez créer un nom de clé à l'aide de symboles pris en charge.
La définition du calcul doit être entrée dans le champ Formule. Il n'y a pratiquement aucun lien entre la formule et la clé. Les paramètres clés ne sont en aucun cas utilisés dans la formule.
La syntaxe correcte d'une formule simple est :
Où :
| ARGUMENT | DEFINITION |
|---|---|
| func | Une des fonctions supportées dans les expressions de déclenchement : last, min, max, avg, count, etc |
| clé | La clé d'un autre élément dont vous voulez utilisé les données. Il peut être défini comme clé ou nom d'hôte:clé. Remarque : Il est fortement recommandé de mettre toute la clé entre guillemets ("...") pour éviter une analyse incorrecte à cause des espaces ou des virgules dans la clé. S'il existe également des paramètres entre guillemets dans la clé, ces guillemets doivent être échappés en utilisant la barre oblique inverse (\). Voir l'exemple 5 ci-dessous. |
| paramètre(s) | Paramètre(s) de fonction, si nécessaire. |
Tous les éléments référencés à partir de la formule d'éléments calculée doivent exister et être en train de collecter des données (exceptions dans les fonctions et les éléments non supportés). En outre, si vous modifiez la clé d'un élément référencé, vous devez mettre à jour manuellement les formules à l'aide de cette clé.
Les macros utilisateur dans la formule seront développées si elles sont utilisées pour référencer un paramètre de fonction ou une constante. Les macros utilisateur NE seront PAS développées si vous référencez une fonction, un nom d'hôte, une clé d'élément, un paramètre de clé d'élément ou un opérateur.
Une formule plus complexe peut utiliser une combinaison de fonctions, d'opérateurs et de crochets. Vous pouvez utiliser toutes les fonctions et tous les opérateurs pris en charge dans les expressions de déclencheur. Notez que la syntaxe est légèrement différente, mais la logique et la priorité des opérateurs sont exactement les mêmes.
Contrairement aux expressions de déclencheur, Zabbix traite les éléments calculés en fonction de l'intervalle d’actualisation de l'élément, et non lors de la réception d'une nouvelle valeur.
Si le résultat du calcul est une valeur flottante, il sera réduit à un entier si le type d'information calculé est Numérique (non signé).
Un élément calculé peut ne plus être pris en charge dans plusieurs cas :
- élément(s) référencé(s)
- n'est pas trouvé
- est désactivé
- appartient à un hôte désactivé
- n'est pas supporté (voir les exceptions dans les fonctions et les éléments non supportés, les expressions avec des éléments non supportés et les valeurs inconnues et les opérateurs)
- pas de donnée pour calculer une fonction
- division par zero
- utilisation d'une syntaxe incorrecte
La prise en charge des éléments calculés a été introduite dans Zabbix 1.8.1.
À partir de Zabbix 3.2, les éléments calculés dans certains cas peuvent impliquer des éléments non supportés comme décrit dans les fonctions et les éléments non supportés, les expressions avec des éléments non supportés et les valeurs inconnues et les opérateurs).
Exemples d'utilisation
Exemple 1
Calcul du pourcentage d'espace disque libre sur '/'.
Utilisation de la fonction last :
Zabbix prendra les dernières valeurs pour les espaces disque libres et totaux et calculera le pourcentage en fonction de la formule donnée.
Exemple 2
Calcul d'une moyenne de 10 minutes du nombre de valeurs traitées par Zabbix.
Utilisation de la fonction avg :
Notez que l'utilisation intensive d'éléments calculés avec de longues périodes de temps peut affecter les performances du serveur Zabbix.
Exemple 3
Calcul de la bande passante totale sur eth0.
Somme de deux fonctions :
Exemple 4
Calcul du pourcentage de trafic entrant.
Expression plus complexe :
Exemple 5
Utilisation correcte d'éléments agrégés dans un élément calculé.
Prenez note de la façon dont les guillemets doubles sont échappés dans la clé entre guillemets :