Documentation
Table of Contents
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:
por exemplo:
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:
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:
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'.
Behavior depending on availability
The following table illustrates how each function behaves in cases of limited availability of host/item and history data.
| Function | Disabled host | Unavailable host with data | Unavailable host without data | Disabled item | Unsupported item | Data retrieval error (SQL) |
|---|---|---|---|---|---|---|
| avg_foreach | ignore | return avg | ignore | ignore | ignore | ignore |
| bucket_rate_foreach | ignore | return bucket rate | ignore | ignore | ignore | ignore |
| count_foreach | ignore | return count | 0 | ignore | ignore | ignore |
| exists_foreach | ignore | 1 | 1 | ignore | 1 | n/a |
| last_foreach | ignore | return last | ignore | ignore | ignore | ignore |
| max_foreach | ignore | return max | ignore | ignore | ignore | ignore |
| min_foreach | ignore | return min | ignore | ignore | ignore | ignore |
| sum_foreach | ignore | return sum | ignore | ignore | ignore | ignore |
If the item is ignored, nothing is added to the aggregation.