Table of Contents
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/keye(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 |
|