7 Symboles des unités

Aperçu

Travailler avec de grandes valeurs telles que 86400, 104857600 ou 1000000 peut être difficile et entraîner des erreurs. Pour simplifier la configuration et améliorer la lisibilité, Zabbix prend en charge les symboles d’unité (suffixes) qui servent de multiplicateurs de valeur.

Expressions de déclencheur sans suffixes :

last(/host/system.uptime)<86400
avg(/host/system.cpu.load,600s)<10
last(/host/vm.memory.size[available])<20971520

Expressions de déclencheur avec suffixes :

last(/host/system.uptime)<1d
avg(/host/system.cpu.load,10m)<10
last(/host/vm.memory.size[available])<20M

Les suffixes peuvent également simplifier la configuration d’autres entités, telles que les éléments, les widgets, etc., et aider à afficher les valeurs des éléments dans un format lisible par l’homme.

Pour savoir si un champ de configuration d’entité prend en charge les suffixes, consultez toujours la page correspondante à l’entité en cours de configuration.

Suffixes de temps

L’interface web de Zabbix prend en charge les suffixes de temps suivants dans la configuration des entités :

  • s - secondes (lorsqu’il est utilisé, fonctionne de la même manière que la valeur brute)
  • m - minutes
  • h - heures
  • d - jours
  • w - semaines
  • M - mois (fonctions de tendances uniquement)
  • y - années (fonctions de tendances uniquement)

Les suffixes de temps ne sont pris en charge qu’avec des nombres entiers. Par exemple, 1h est pris en charge, mais 1,5h ou 1.5h ne le sont pas ; utilisez 90m à la place.

Suffixes de taille de mémoire

Zabbix prend en charge les suffixes de taille de mémoire suivants :

  • K - kilo-octets
  • M - mégaoctets
  • G - gigaoctets
  • T - téraoctets

Suffixes des valeurs d’élément

Les suffixes peuvent également être utilisés pour afficher les valeurs numériques des éléments dans un format lisible par l’humain.

Pour activer cela, utilisez l’un des suffixes suivants dans le champ Units lors de la configuration d’un élément :

  • B - octets
  • Bps - octets par seconde
  • s - secondes, affichées en utilisant jusqu’à trois plus grandes unités de temps non nulles
  • uptime - temps écoulé au format hh:mm:ss ou N jours, hh:mm:ss
  • unixtime - horodatage Unix, formaté comme yyyy.mm.dd hh:mm:ss

Les règles supplémentaires suivantes s’appliquent à la façon dont ces suffixes sont interprétés et affichés :

  • Pour B et Bps, Zabbix utilise une conversion en base 2 (1K = 1024B), conformément à la norme JEDEC.
  • Pour les autres unités (telles que Hz, W, etc.), Zabbix utilise une conversion en base 10 (1K = 1000).
  • Pour s (secondes) :
    • Le format inclut yyy mmm ddd hhh mmm sss ms ; seules jusqu’à trois plus grandes unités de temps non nulles sont affichées (par exemple, 1M 10d 4h).
    • Si une unité vaut zéro et se trouve entre deux unités non nulles, elle est omise (par exemple, 10d 56m au lieu de 10d 0h 56m).

Lorsque Units est utilisé, les suffixes multiplicateurs suivants sont automatiquement appliqués aux valeurs des éléments :

  • K, M, G, T - kilo, méga, giga, téra
  • P, E, Z, Y - péta, exa, zetta, yotta (ceux-ci sont appliqués uniquement dans le frontend)

Pour empêcher la conversion d’unité, utilisez le préfixe ! (par exemple, !B ou !s).

Les exemples suivants montrent comment les valeurs d’élément reçues sont converties en fonction des unités spécifiées :

1 B → 1 B
1024 B → 1 KB
1536 B → 1.5 KB
881764 B → 881.76 KB
881764 !B → 881764 B

0.0000155 s → 0.016ms
3470400 s → 1M 10d 4h
2606400 s → 1M 4h
2592000 s → 1M
2592001 s → 1M
2592001 !s → 2592001 s

17764 uptime → 04:56:04
86400 uptime → 1 day, 00:00:00
881764 uptime → 10 days, 04:56:04
32417764 uptime → 375 days, 04:56:04
32417764 !uptime → 32417764 uptime

881764 unixtime → 1970-01-11 04:56:04 AM

17764 Hz → 17.76 KHz
86400 Hz → 86.4 KHz
881764 Hz → 881.76 KHz
32417764 Hz → 32.42 MHz

0 ! → 0
0 !! → 0 !

Avant Zabbix 4.0, il existait une liste codée en dur d’unités à exclure de la conversion, composée de ms, rpm, RPM, %. Cette liste a été abandonnée ; la méthode correcte pour empêcher la conversion de telles unités est donc !ms, !rpm, !RPM, !%.