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 Foreach

Visão geral

As funções foreach retornam valores agregados do histórico de vários Itens. As funções foreach são usadas em cálculos agregados.

As seguintes funções foreach são suportadas:

Função Descrição
avg_foreach Retorna valores médios
bucket_rate_foreach Retorna pares (limite superior do bucket, valor da taxa) adequados para uso na função histogram_quantile(), onde "limite superior do bucket " é o valor do parâmetro-chave do item definido pelo <número do parâmetro> parâmetro.
count_foreach Retorna o número de valores
exists_foreach Retorna o número de itens atualmente habilitados
last_foreach Retorna os últimos valores
max_foreach Retorna os valores máximos
min_foreach Retorna valores mínimos
soma_foreach Retorna a soma dos valores

As funções foreach retornam uma matriz de valores - um para cada item. Itens são selecionados usando filtros no primeiro parâmetro.

Veja agregar cálculos para mais detalhes sobre o uso de funções foreach.

Supported functions

Function Description
avg_foreach Returns the average value for each item.
bucket_rate_foreach Returns pairs (bucket upper bound, rate value) suitable for use in the histogram_quantile() function, where "bucket upper bound" is the value of item key parameter defined by the <parameter number> parameter.
count_foreach Returns the number of values for each item..
exists_foreach Returns the number of currently enabled items.
last_foreach Returns the last value for each item.
max_foreach Returns the maximum value for each item.
min_foreach Returns the minimum value for each item.
sum_foreach Returns the sum of values for each item.

Parâmetros

As funções Foreach suportam dois parâmetros comuns - filtro de item e tempo período:

foreach_function (filtro de item, período de tempo)

por exemplo:

avg_foreach(/*/mysql.qps?[group="MySQL Servers"],5m)

Algumas funções suportam parâmetros adicionais.

Filtro de itens

O parâmetro first permite filtrar os itens que nos interessam. Um filtro complexo pode ser usado, referenciando a chave do item, grupo de hosts e tags, conforme ilustrado pelos exemplos:

Exemplo de sintaxe Descrição
/host/key[abc,*] Corresponde a itens semelhantes neste host.
/*/key Corresponde ao mesmo item de qualquer host.
/*/key?[group="ABC" and tag="tagname:value"] Corresponde ao mesmo item de qualquer host do grupo ABC com tags 'tagname:value'.
/*/key[a,*,c]?[(grupo="ABC" e tag="Tag1") ou (grupo="DEF" e (tag="Tag2" ou tag=" Tag3:value"))] Corresponde a itens semelhantes de qualquer host do grupo ABC ou DEF com as respectivas tags.

Todos os itens referenciados devem existir e coletar dados. Apenas itens ativados em hosts habilitados são incluídos nos cálculos.

::: não importante Se a chave de item de um item referenciado for alterada, o filtro deve ser atualizado manualmente. :::

Especificar um grupo de hosts pai inclui o grupo pai e todos os grupos de hosts com seus itens.

Período de tempo

O parâmetro second permite especificar o período de tempo para agregação. O período de tempo só pode ser expresso como tempo, a quantidade de valores (prefixado com #) não é suportado.

Símbolos de unidade suportados podem ser usados neste parâmetro por conveniência, por exemplo '5m' (cinco minutos) em vez de '300s' (300 segundos) ou '1d' (um dia) em vez de '86400' (86400 segundos).

O período de tempo é ignorado pelo servidor se passado com last_foreach função e pode, portanto, ser omitido:

last_foreach(/*/key?[group="host group"])

O período de tempo não é compatível com a função exists_foreach.

Parâmetros adicionais

Um terceiro parâmetro opcional é suportado pelo bucket_rate_foreach função:

bucket_rate_foreach(filtro de item, período de tempo,<número do parâmetro>)

onde <número do parâmetro> é a posição do valor "bucket" em a chave do item. Por exemplo, se o valor "bucket" em myItem[aaa,0.2] for '0.2', então sua posição é 2.

O valor padrão de <número do parâmetro> é '1'.