Esta é uma tradução da página de documentação original em inglês. Ajude-nos a torná-la melhor.

Sidebar

Zabbix Summit 2022
Register for Zabbix Summit 2022

1 Funções agregadas

Exceto onde indicado de outra forma, todas as funções listadas aqui são suportadas dentro:

As funções agregadas podem funcionar com:

  • histórico de itens, por exemplo, min(/host/key,1h)
  • funções foreach como o único parâmetro, por exemplo, min(last_foreach(/*/key))

Algumas notas gerais sobre parâmetros de função:

  • Os parâmetros da função são separados por uma vírgula
  • Parâmetros de função opcionais (ou partes de parâmetros) são indicados por < >
  • Os parâmetros específicos da função são descritos com cada função
  • Os parâmetros /host/key e (sec|#num)<:time shift> nunca devem ser citado
Parâmetros comuns
  • /host/key é um primeiro parâmetro obrigatório comum para as funções referenciando o histórico de itens do host
  • (sec|#num)<:time shift> é um segundo parâmetro comum para o funções que fazem referência ao histórico do item do host, onde:
    • sec - máximo avaliação period em segundos (tempo sufixos podem ser usados), ou
    • #num - máximo avaliação range na última valores coletados (se precedidos por uma marca de hash)
    • time shift (opcional) permite mover o ponto de avaliação volta no tempo. Ver mais detalhes](/manual/config/triggers/expression#time_shift) em especificando a mudança de horário.

Funções agregadas

FUNÇÃO
Descrição Parâmetros específicos da função Comentários
avg (/host/key,(sec|#num)<:time shift>)
Valor médio de um item dentro do período de avaliação definido. Consulte parâmetros comuns. Tipos de valor suportados: float, int

Exemplos:
=> ** avg(/host/key,1h) → valor médio da última hora até agora
=>
avg(/host/ key,1h:now-1d) → valor médio de uma hora de 25 horas atrás a 24 horas atrás de agora
=>
média** (/host/key,#5) → valor médio dos cinco últimos valores
=> avg(/host/key,#5:now-1d) → valor médio dos cinco últimos valores excluindo os valores recebidos nas últimas 24 horas

A mudança de horário é útil quando há necessidade de comparar o valor médio atual com o valor médio há algum tempo.
bucket_percentile (filtro de item, período de tempo, porcentagem)
Calcula o percentil dos intervalos de um histograma. filtro de item - consulte filtro de item
período de tempo - consulte período de tempo
percentage - porcentagem (0-100)
Suportado apenas em itens calculados.

Esta função é um alias para histogram_quantile(percentage/100, bucket_rate_foreach(item filter, time period, 1))
count (func_foreach(filtro de item,<período de tempo>))
Contagem de valores em uma matriz retornada por uma função foreach. func_foreach - função foreach para a qual o número de valores retornados deve ser contado (com argumentos suportados). Consulte funções foreach para obter detalhes. Tipo de valor suportado: int

Exemplo:
=> count(max_foreach(/ */net.if.in[*],1h)) → número de itens net.if.in que receberam dados na última hora até agora<br >
Observe que usar count() com uma função foreach relacionada ao histórico (max_foreach, avg_foreach etc.) pode levar a implicações de desempenho, enquanto usar exists_foreach() , que funciona apenas com dados de configuração, não terá esse efeito.
histogram_quantile (quantil,bucket1,value1,bucket2,value2,...)
Calcula o φ-quantil dos buckets de um histograma. quantil - 0 ≤ φ ≤ 1
bucketN, valueN - pares inseridos manualmente (>=2) de parâmetros ou resposta de bucket_rate_foreach
Suportado apenas em itens calculados.

Funcionalmente corresponde a 'histogram_quantile' do PromQL.

Retorna -1 se os valores do último bucket 'Infinity' ("+inf") forem iguais a 0. < br>
Exemplo:
=> histograma_quantil(0.75,1.0,last(/host/rate_bucket[1.0]),"+Inf",last(/host/rate _bucket[Inf])
=> histograma_quantile(0,5,bucket_rate_foreach(//item_key,30s))
item_count (filtro de item)
Contagem de itens existentes na configuração que correspondem aos critérios de filtro. filtro de item - critério para seleção de item, permite referência por grupo de host, host, chave de item e tags. Caracteres curinga são suportados. Consulte filtro de item para obter mais detalhes. Tipo de valor suportado: int

Funciona como um alias para *count(exists_foreach(item _filter))* função.

Exemplo:
=> item_count(/*/agent.ping?[group="Host group 1"]) → número de hosts com o item agent.ping no "Host group 1"
kurtosis (/host/key,(sec|#num)<:time shift>)
"Tailedness" da distribuição de probabilidade em valores coletados dentro do período de avaliação definido.

Veja também: Curtosis
Consulte common parameters. Tipos de valor suportados: float, int

Exemplo:
=> curtose(/host/key,1h) → curtose para a última hora até agora
Mad (/host/key,(sec|#num)<:time shift>)
Desvio absoluto médio em valores coletados dentro do período de avaliação definido.

Veja também: Desvio absoluto médio
Consulte parâmetros comuns. Tipos de valor suportados: float, int

Exemplo:
=> mad(/host/key,1h) → desvio médio absoluto para a última hora até agora
max (/host/key,(sec|#num)<:time shift>)
Valor mais alto de um item dentro do período de avaliação definido. Consulte parâmetros comuns. Tipos de valor suportados: float, int

Exemplo:
=> ** max(/host/key,1h) - min(/host/key,1h**) → calcular a diferença entre os valores máximo e mínimo na última hora até agora
min (/host/key,(sec|#num)<:time shift>)
Menor valor de um item dentro do período de avaliação definido. Consulte parâmetros comuns. Tipos de valor suportados: float, int

Exemplo:
=> ** max(/host/key,1h) - min(/host/key,1h**) → calcular a diferença entre os valores máximo e mínimo na última hora até agora (delta de valores)
assimetria (/host/key,(sec|#num)<:time shift>)
Assimetria da distribuição de probabilidade em valores coletados dentro do período de avaliação definido.

Veja também: Skewness
Veja parâmetros comuns (#common-parameters). Tipos de valor suportados: float, int

Exemplo:
=> assimetria(/host/key,1h) → assimetria para o último hora até agora
stddevpop (/host/key,(sec|#num)<:time shift>)
Desvio padrão da população em valores coletados dentro do período de avaliação definido.

Veja também: Desvio padrão
Consulte parâmetros comuns. Tipos de valor suportados: float, int

Exemplo:
=> stddevpop(/host/key,1h) → desvio padrão da população para o última hora até agora
stddevsamp (/host/key,(sec|#num)<:time shift>)
Desvio padrão da amostra em valores coletados dentro do período de avaliação definido.

Veja também: Desvio padrão
Consulte parâmetros comuns. Tipos de valor suportados: float, int

Pelo menos dois valores de dados são necessários para que esta função funcione.

Exemplo:
=> **stddevsamp* *(/host/key,1h) → desvio padrão da amostra para a última hora até agora
soma (/host/key,(sec|#num)<:time shift>)
Soma dos valores coletados dentro do período de avaliação definido. Consulte parâmetros comuns. Tipos de valor suportados: float, int

Exemplo:
=> soma (/host/key,1h) → soma dos valores da última hora até agora
sumofsquares (/host/key,(sec|#num)<:time shift>)
A soma dos quadrados em valores coletados dentro do período de avaliação definido. Consulte parâmetros comuns. Tipos de valor suportados: float, int

Exemplo:
=> sumofsquares(/host/key,1h) → soma dos quadrados da última hora até agora
varpop (/host/key,(sec|#num)<:time shift>)
Variação populacional dos valores coletados dentro do período de avaliação definido.

Veja também: Variance
Consulte parâmetros comuns. Tipos de valor suportados: float, int

Exemplo:
=> varpop(/host/key,1h) → variação de população para a última hora até agora
varsamp (/host/key,(sec|#num)<:time shift>)
Variação de amostra de valores coletados dentro do período de avaliação definido.

Veja também: Variance
Consulte parâmetros comuns. Tipos de valor suportados: float, int

Pelo menos dois valores de dados são necessários para que esta função funcione.

Exemplo:
=> varsamp( /host/key,1h) → variação de amostra para a última hora até agora