7 Símbolos de unidade

Visão geral

Trabalhar com valores grandes como 86400, 104857600 ou 1000000 pode ser desafiador e levar a erros. Para simplificar a configuração e melhorar a legibilidade, o Zabbix suporta símbolos de unidade (sufixos) que funcionam como multiplicadores de valor.

Expressões de trigger sem sufixos:

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

Expressões de trigger com sufixos:

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

Os sufixos também podem simplificar a configuração de outras entidades, como items, widgets, etc., e ajudar a exibir os valores dos items em um formato legível por humanos.

Sufixos de tempo

O frontend do Zabbix oferece suporte aos seguintes sufixos de tempo na configuração de entidades:
s - segundos (quando usado, funciona da mesma forma que o valor bruto);
m - minutos;
h - horas;
d - dias;
w - semanas;
M - meses (funções de tendência apenas);
y - anos (funções de tendência apenas).

Os sufixos de tempo são suportados apenas com números inteiros. Por exemplo, 1h é suportado, mas 1,5h ou 1.5h não é suportado; use 90m em vez disso.

Sufixos de tamanho de memória

O Zabbix suporta os seguintes sufixos de tamanho de memória:
K - kilobytes
M - megabytes
G - gigabytes
T - terabytes

Sufixos de valor de item

Os sufixos também podem ser usados para exibir valores numéricos de item em um formato legível para humanos.

Para habilitar isso, use um dos seguintes sufixos no campo Units ao configurar um item:
B - bytes;
Bps - bytes por segundo;
s - segundos, exibidos usando até três unidades de tempo não zero maiores;
uptime - tempo decorrido em hh:mm:ss ou N dias, hh:mm:ss;
unixtime - timestamp Unix, formatado como yyyy.mm.dd hh:mm:ss.

As seguintes regras adicionais se aplicam a como esses sufixos são interpretados e exibidos:

• Para B e Bps, o Zabbix usa conversão em base 2 (1K = 1024B), seguindo o padrão JEDEC.
• Para outras unidades (como Hz, W etc.), o Zabbix usa conversão em base 10 (1K = 1000).
• Para s (segundos):
  • O formato inclui yyy mmm ddd hhh mmm sss ms; apenas até três unidades de tempo não zero maiores são exibidas (por exemplo, 1M 10d 4h).
  • Se uma unidade for zero e estiver entre duas unidades não zero, ela é omitida (por exemplo, 10d 56m em vez de 10d 0h 56m).

Quando Units são usados, os seguintes sufixos multiplicadores são aplicados automaticamente aos valores de item:
K, M, G, T - quilo, mega, giga, tera;
P, E, Z, Y - peta, exa, zetta, yotta (esses são aplicados apenas no frontend).

Para impedir a conversão de unidades, use o prefixo ! (por exemplo, !B ou !s).

Os exemplos a seguir mostram como os valores de item recebidos são convertidos com base nas unidades especificadas:

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 !