2016/11/03 11:59 1/3 7 Itens calculados

7 Itens calculados

7.1 Viso geral

Com os itens calculados voc pode gerar novas informaes a partir de dados coletados por outros
itens.

Assim, itens calculados so uma forma de se criar fontes de dados virtuais. Os dados so
periodicamente calculados baseados em uma expresso aritmtica. Todos os clculos so feitos pelo
Zabbix Server - nada ser calculado pelos agentes ou proxies.

O dado resultante ser armazenado no banco de dados do Zabbix como qualquer outro item - isso
quer dizer que tanto as tabelas de histrico quanto as de mdias sero alimentadas para a rpida
gerao de grficos. Itens calculados podem ser utilizados em expresses de triggers, referenciados
por macros ou outras entidades da mesma forma que qualquer outro item.

Para usar os itens calculados, selecione o Tipo Calculado.

7.2 Campos personalizados

A chave o identificador nico de item por host. Voc pode definir qualquer nome de chave,
contando que use os caracteres suportados.

Dever ser informada a regra de clculo no campo Formula. Virtualmente, no existe conexo entre
uma frmula e sua chave. Os parmetros da chave no sero utilizados na frmula.

A sintaxe de uma simples frmula pode ser definida como:

func(<key>|<hostname:key>,<parameter1>,<parameter2>,...)

Onde:

Argumento Definio
Uma das funes suportadas em uma expresso de trigger: last, min, max, avg,
func
count, etc
A chave de um outro item cujo dado seja necessrio na frmula. Podendo ser
referenciado como key (chave) ou hostname:key.
Nota: Colocar a key entre aspas duplas () recomendvel para evitar erros de
key anlise por conta de espaos ou separadores de valores que podero existir na chave
referenciada.
Se a chave a qual estejamos referenciado utilizar-se de aspas duplas, as mesmas
devero ser escapadas pelo caractere \. Veja o Exemplo 5 a seguir.
parameter(s) Qualquer parmetro adicional que possa ser necessrio.

Todos os itens referenciados por uma frmula de um item calculado devero existir e possuir algum
dado coletado. Outro ponto importante que, ao contrrio do que ocorre nas triggers, os itens
referenciados pela frmula, se tiverem suas chaves alteradas, devero ter suas chamadas na frmula
manualmente alteradas.
Zabbix Documentation 3.0 - https://www.zabbix.com/documentation/3.0/
Last
update:
pt:manual:config:items:itemtypes:calculated https://www.zabbix.com/documentation/3.0/pt/manual/config/items/itemtypes/calculated
2016/02/17
12:46

As Macros de usurio na frmula sero traduzidos se utilizados como referncia para um parmetro
ou constante. Por outro lado, elas no sero traduzidas se tentarem utiliza-las como uma funo,
nome de host, chave ou operador.

Frmulas mais complexas podero utilizar combinao de funes, operadores e colchetes. Voc
pode utilizar todas as funes e operadores suportados pelas expresses de triggers. Observe que a
sintaxe um pouco diferente, mas a lgica e a precedncia ser exatamente a mesma.

De forma diferente das expresses de trigger, o Zabbix processa os itens calculados de acordo com
seu intervalo de atualizao, no considerando o recebimento de novos valores.

Um item calculado passar para o estado de 'no suportado' sob vrias circunstncias:

1. ausncia de item(s) referenciado(s)

2. sem dados suficientes para calcular uma funo
3. diviso por zero
4. sintaxe invlida

O suporte aos itens calculados foi introduzido no Zabbix 1.8.1

7.3 Exemplos de uso

Exemplo 1

Calculando o percentual livre na partio '/'.

Use a funo last:

100*last("vfs.fs.size[/,free]")/last("vfs.fs.size[/,total]")

O Zabbix ir usar o ltimo valor livre coletado para a partio e calcular o percentual conforme a
frmula.

Exemplo 2

Calcular a mdia de 10 minutos de valores processados pelo Zabbix.

Utilize a funo avg:

avg("Zabbix Server:zabbix[wcache,values]",600)

Observe que o uso de itens calculados em longos perodos de anlise de dados poder afetar a
performance do Zabbix server.

https://www.zabbix.com/documentation/3.0/ Printed on 2016/11/03 11:59

2016/11/03 11:59 3/3 7 Itens calculados

Exemplo 3

Calculando o total de banda trafegada em eth0.

Sumarizao de duas funes:

last("net.if.in[eth0,bytes]")+last("net.if.out[eth0,bytes]")

Exemplo 4

Calculando o percentual do trfego de entrada.

Uma frmula um pouco mais complexa:

100*last("net.if.in[eth0,bytes]")/(last("net.if.in[eth0,bytes]")+last("net.i
f.out[eth0,bytes]"))

Exemplo 5

Utilizando itens agregados para calcular.

Especial teno sobre a forma que as aspas duplas das chaves so escapadas na frmula:

last("grpsum[\"video\",\"net.if.out[eth0,bytes]\",\"last\"]") /
last("grpsum[\"video\",\"nginx_stat.sh[active]\",\"last\"]")

From:
https://www.zabbix.com/documentation/3.0/ - Zabbix Documentation 3.0

Permanent link:
https://www.zabbix.com/documentation/3.0/pt/manual/config/items/itemtypes/calculated

Last update: 2016/02/17 12:46

Zabbix Documentation 3.0 - https://www.zabbix.com/documentation/3.0/