Documentation
Table of Contents
1 Fun??es de trigger suportadas
Todas as fun??es de trigger suportadas em suas express?es s?o aqui listadas.
| FUN??O | |||
|---|---|---|---|
| Descri??o | Par?metros | °ä´Ç³¾±ð²Ô³Ù¨¢°ù¾±´Ç²õ | |
| abschange | |||
| A diferen?a absoluta entre o ¨²ltimo valor e seu antecessor. | Tipo de valores suportados: float, int, str, text, log Por exemplo: (pen¨²ltimo valor/¨²ltimo valor=diferen?a) 1/5=4 3/1=2 0/-2.5=2.5 Observe que enquanto a fun??o abschange retorna sempre valores positivos, a fun??o change retornar¨¢ valores positivos ou negativos.Para textos retorna: 0 - valores iguais 1 - valores diferentes |
||
| avg (sec|#num,<time_shift>) | |||
| O valor m¨¦dio de um item em um determinado per¨ªodo analisado. | sec ou #num - o per¨ªodo de an¨¢lise pode ser em segundos ou em quantidade de valores (neste caso o n¨²mero ¨¦ precedido pelo caractere "#"). Ambas as an¨¢lises come?am do mais recente para o mais antigo. time_shift (opcional) - o ponto inicial de an¨¢lise ¨¦ movido uma quantidade de segundos atr¨¢s no tempo. |
Tipos de valores suportados: float, int Exemplos: => avg(#5) ¡ú valor m¨¦dio dos ¨²ltimos cinco valores => avg(1h) ¡ú valor m¨¦dio da ¨²ltima hora => avg(1h,1d) ¡ú valor m¨¦dio da ¨²ltima hora, come?ando a analisar um dia antes. O par?metro time_shift ¨¦ suportado desde o Áú»¢¶Ä²© 1.8.2. ? muito ¨²til quando se precisa comparar a m¨¦dia atual com a m¨¦dia de algum momento no passado. |
|
| band (sec|#num,mask,<time_shift>) | |||
| Valor da "verifica??o AND bit a bit" de um item e ³¾¨¢²õ³¦²¹°ù²¹. | sec (ignorado) ou #num - o eN¨¦simo valor mais recente mask (obrigat¨®rio) - inteiro de 64-bit sem sinal (0 - 18446744073709551615) time_shift (opcional) - consulte avg() |
Tipos de valores suportados: int Observe que #num funciona diferentemente das demais fun??es (consulte last()).Emboara a compara??o seja feita bit a bit, todos os valores devem ser informados e ser?o retornados no formato decimal. Por exemplo, a verifica??o do 3.o. bit ¨¦ feita ao se comparar com o 4.o., n?o 100. Exemplos: => band(,12)=8 ou band(,12)=4 ¡ú 3rd ou 4th bit definido, mas n?o ambos ao mesmo tempo => band(,20)=16 ¡ú 3rd bit n?o definido e 5th bit definido. Esta fun??o ¨¦ suportada desde o Áú»¢¶Ä²© 2.2.0. |
|
| change | |||
| A diferen?a entre o ¨²ltimo valor e seu antecessor. | Tipos de valores suportados: float, int, str, text, log Por exemplo: (pen¨²ltimo valor/¨²ltimo valor=modifica??o) 1/5=+4 3/1=-2 0/-2.5=-2.5 Observe que enquanto a fun??o abschange retorna sempre valores positivos, a fun??o change retornar¨¢ valores positivos ou negativos.Para strings retorna: 0 - valores iguais 1 - valores diferentes. |
||
| count (sec|#num,<pattern>,<operator>,<time_shift>) | |||
| Quantidade de valores em determinado per¨ªodo analisado. | sec ou #num - o per¨ªodo de an¨¢lise pode ser em segundos ou em quantidade de valores (neste caso o n¨²mero ¨¦ precedido pelo caractere "#") pattern (opcional) - padr?o desejado (itens inteiros - valor exato; itens num¨¦ricos (ponto flutuante) - com a margem de erro 0.000001) operator (opcional) Operadores suportados: eq - igual ne - diferente gt - maior ge - maior ou igual lt - menor le - menor ou igual like - confere se contiver o valor (sens¨ªvel ao caso) band - verifica??o bit a bit AND (suportado desde o Áú»¢¶Ä²© 2.2.0). Observe que os operadores: eq (padr?o), ne, gt, ge, lt, le, band s?o suportados para itens inteiros eq (padr?o), ne, gt, ge, lt, le s?o suportados para itens num¨¦ricos like (padr?o), eq, ne s?o suportados para itens string, texto e log time_shift (opcional) - consulte avg() |
Tipos de valores suportados: float, int, str, text, log Com band como o terceiro par?metro, o segundo dever¨¢ possuir dois n¨²meros separados pelo caractere '/': ²Ô¨²³¾±ð°ù´Ç³å²¹³å³¦´Ç³¾±è²¹°ù²¹°ù/³¾¨¢²õ³¦²¹°ù²¹. A fun??o count() calcula a "verifica??o bit a bit AND" do valor com sua ³¾¨¢²õ³¦²¹°ù²¹ e compara o resultado com ²Ô¨²³¾±ð°ù´Ç³å²¹³å³¦´Ç³¾±è²¹°ù²¹°ù. Se o resultado da "verifica??o bit a bit AND" for igual ao ²Ô¨²³¾±ð°ù´Ç³å²¹³å³¦´Ç³¾±è²¹°ù²¹°ù, o valor ¨¦ contado.Se o ²Ô¨²³¾±ð°ù´Ç³å²¹³å³¦´Ç³¾±è²¹°ù²¹°ù e a ³¾¨¢²õ³¦²¹°ù²¹ forem iguais, apenas a ³¾¨¢²õ³¦²¹°ù²¹ precisa ser definida (sem '/'). Exemplos: => count(10m) ¡ú quantidade de valores nos ¨²ltimos 10 minutos => count(10m,12) ¡ú quantidade de valores nos ¨²ltimos 10 minutos que s?o iguais a '12' => count(10m,12,"gt") ¡ú quantidade de valores nos ¨²ltimos 10 minutos que s?o maiores que '12' => count(#10,12,"gt") ¡ú entre os 10 ¨²ltimos valores, a quantidade que ¨¦ maior que '12' => count(10m,12,"gt",1d) ¡ú quantidade de valores nos ¨²ltimos 10 minutos, come?ando a an¨¢lise 24 horas atr¨¢s, que s?o maiores que '12' => count(10m,6/7,"band") ¡ú quantidade de valores nos ¨²ltimos 10 minutos tendo '110' (em bin¨¢rio) nos 3 bits mais significantes. => count(10m,,,1d) ¡ú quantidade de valores nos ¨²ltimos 10 minutos, come?ando a an¨¢lise 24 horas atr¨¢s O par?metro #num ¨¦ suportado desde o Áú»¢¶Ä²© 1.6.1.O par?metro time_shift e os operadores de texto s?o suportados desde o Áú»¢¶Ä²© 1.8.2. |
|
| date | |||
Data atual no formato YYYYMMDD. |
Tipos de valores suportados: qualquer tipo Exemplo de valor retornado: 20150731 |
||
| dayofmonth | |||
| Dia do m¨ºs no intervalo de 1 a 31. | Tipos de valores suportados: qualquer tipo Esta fun??o ¨¦ suportada desde o Áú»¢¶Ä²© 1.8.5. |
||
| dayofweek | |||
| Dia da semana no intervalo de 1 a 7 (Segunda - 1, Domingo - 7). | Tipos de valores suportados: qualquer tipo | ||
| delta (sec|#num,<time_shift>) | |||
| Diferen?a entre o maior e o menor valor no per¨ªodo de an¨¢lise ('max()' menos 'min()'). | sec ou #num - o per¨ªodo de an¨¢lise pode ser em segundos ou em quantidade de valores (neste caso o n¨²mero ¨¦ precedido pelo caractere "#") time_shift (opcional) - consulte avg() |
Tipos de valores suportados: float, int O par?metro time_shift ¨¦ suportado desde o Áú»¢¶Ä²© 1.8.2. |
|
| diff | |||
| Verifica se o valor atual e seu predecessor s?o diferentes. | Tipos de valores suportados: float, int, str, text, log Retorna: 1 - o ¨²ltimo valor e o pen¨²ltimo s?o diferentes 0 - s?o iguais |
||
| forecast (sec|#num,<time_shift>,time,<fit>,<mode>) | |||
| Future value, max, min, delta ou avg of the item. | sec ou #num - o per¨ªodo de an¨¢lise pode ser em segundos ou em quantidade de valores (neste caso o n¨²mero ¨¦ precedido pelo caractere "#") time_shift (opcional) - consulte avg() time - horizonte de previs?o em segundos fit (opcional) - fun??o usada para ajustar com o hist¨®rico de dados Ajustes suportados: linear - fun??o linear polynomialN - polinomial de grau N (1 <= N <= 6) exponential - fun??o expotencial logarithmic - fun??o logar¨ªtmica power - fun??o de for?a Observe que: linear ¨¦ o padr?o, polynomial1 ¨¦ equivalente a linear mode (opcional) - sa¨ªda exigida Modos suportados: value - valor (padr?o) max - m¨¢ximo min - m¨ªnimo delta - max-min avg - m¨¦dia Observe que: value estima o valor do item no momento now + timemax, min, delta e avg investiga o valor do item para estimar no intervalo now e now + time |
Tipos de valores suportados: float, int Se o valor retornado ¨¦ maior que 999999999999.9999 ou menor que -999999999999.9999, o valor ser¨¢ limitado a 999999999999.9999 ou -999999999999.9999 respectivamente. Se tornar¨¢ n?o suportada somente se for usada errada na express?o (tipo errado de item, par?metros inv¨¢lidos), qualquer outra forma retornar¨¢ -1 em caso de erro.Exemplos: => forecast(#10,,1h) ¡ú previs?o do item ap¨®s uma hora, analisando os ¨²ltimos 10 valores => forecast(1h,,30m) ¡ú previs?o do item ap¨®s 30 minutos, analisando os dados da ¨²ltima hora => forecast(1h,1d,12h) ¡ú previs?o do item ap¨®s 12 horas baseado em uma hora de 1 dia atr¨¢s => forecast(1h,,10m,exponential) ¡ú previs?o do valor do item ap¨®s 10 minutos baseado nos dados da ¨²ltima hora em fun??o expotencial => forecast(1h,,2h,polynomial3,max) ¡ú previs?o se o valor m¨¢ximo do item pode ser alcan?ado nas pr¨®ximas 2 horas baseado nos dados da ¨²ltima hora e polin?mio c¨²bico (terceiro grau) Esta fun??o ¨¦ suportada desde o Áú»¢¶Ä²© 3.0.0. Consulte informa??es adicionais em fun??es preditivas de trigger. |
|
| fuzzytime (sec) | |||
| Verifica se o hor¨¢rio local do dispositivo monitorado est¨¢ sincronizado com o hor¨¢rio do Áú»¢¶Ä²© Server. | sec - segundos | Tipos de valores suportados: float, int Retorna: '1' - o hor¨¢rio local do dispositivo n?o difere mais que N segundos, 0 - outro caso. Normalmente utilizado com system.localtime para verificar se o hor¨¢rio local est¨¢ sincronizado com o hor¨¢rio do Áú»¢¶Ä²© Server. |
|
| iregexp (pattern,<sec|#num>) | |||
Esta fun??o ¨¦ uma vers?o an¨¢loga da fun??o regexp(), mas sem ser sens¨ªvel ao caso. |
Consulte regexp() | Tipos de valores suportados: str, log, text | |
| last (sec|#num,<time_shift>) | |||
| O ¨²ltimo valor. | sec (ignorado) ou #num - o eN¨¦simo valor mais recente time_shift (opcional) - consulte avg() |
Tipos de valores suportados: float, int, str, text, log Observe que o par?metro #num funciona diferente das demais fun??es.Por exemplo: last() ¨¦ o mesmo que last(#1)last(#3) - terceiro valor mais recente (n?o os tr¨ºs ¨²ltimos valores)O Áú»¢¶Ä²© n?o garante a ordem exata dos valores se existirem dois ou mais valores com o mesmo segundo no hist¨®rico. O par?metro #num ¨¦ suportado desde o Áú»¢¶Ä²© 1.6.2.O par?metro time_shift ¨¦ suportado desde o Áú»¢¶Ä²© 1.8.2. |
|
| logeventid (padr?o) | |||
| Verifica se o ID de evento da ¨²ltima entrada de log combina com uma express?o regular. | pattern - express?o regular descrevendo o padr?o desejado, seguindo o padr?o . | Tipos de valores suportados: log Retorna: 0 - n?o encontrado 1 - encontrado Esta fun??o ¨¦ suportada desde o Áú»¢¶Ä²© 1.8.5. |
|
| logseverity | |||
| Severidade da ¨²ltima entrada do log. | Tipos de valores suportados: log Retorna: 0 - severidade padr?o N - severidade (inteiro, ¨²til para logs de eventos no Windows: 1 - Informa??o, 2 - Aviso, 4 - Erro, 7 - Falha na auditoria, 8 - Auditoria com sucesso, 9 - Cr¨ªtico, 10 - depura??o). O Áú»¢¶Ä²© recupera a severidade do campo Information no log de eventos do Windows. |
||
| logsource (pattern) | |||
| Verfifica se a fonte do log da ¨²ltima entrada combina com determinado padr?o. | pattern - texto necess¨¢rio | Tipos de valores suportados: log Retorna: 0 - n?o confere 1 - confere Normalmente utilizado para o log de eventos do Windows. Exemplo, logsource("VMware Server"). |
|
| max (sec|#num,<time_shift>) | |||
| Maior valor de um item em determinado per¨ªodo de an¨¢lise. | sec ou #num - o per¨ªodo de an¨¢lise pode ser em segundos ou em quantidade de valores (neste caso o n¨²mero ¨¦ precedido pelo caractere "#") time_shift (opcional) - consulte avg() |
Tipos de valores suportados: float, int O par?metro time_shift ¨¦ suportado desde o Áú»¢¶Ä²© 1.8.2. |
|
| min (sec|#num,<time_shift>) | |||
| Menor valor de um item em determinado per¨ªodo de an¨¢lise. | sec ou #num - o per¨ªodo de an¨¢lise pode ser em segundos ou em quantidade de valores (neste caso o n¨²mero ¨¦ precedido pelo caractere "#") time_shift (opcional) - consulte avg() |
Tipos de valores suportados: float, int O par?metro time_shift ¨¦ suportado desde o Áú»¢¶Ä²© 1.8.2. |
|
| nodata (sec) | |||
| Verifica se n?o foram recebidos dados nos ¨²ltimos N segundos. | sec - per¨ªodo de an¨¢lise em segundos. O per¨ªodo n?o pode ser menor que 30 segundos. | Tipos de valores suportados: qualquer tipo Retorna: 1 - se n?o foi recebido nenhum dado durante o per¨ªodo definido 0 - outro caso Observe que esta fun??o ir¨¢ retornar um erro se, durante o per¨ªodo definido em sec: - n?o tiver dados, mas o servidor Áú»¢¶Ä²© tiver sido reiniciado - n?o tiver dados e um per¨ªodo de manuten??o tiver sido conclu¨ªdo - n?o tiver dados e o item tiver sido adicionado ou reativado |
|
| now | |||
Quantidade de segundos desde Epoch (00:00:00 UTC, 1 de Janeiro de 1970). |
Tipos de valores suportados: qualquer tipo | ||
| percentile (sec|#num,<time_shift>,percentage) | |||
| P-th percentil de um per¨ªodo, onde P (percentual) ¨¦ definido pelo terceiro par?metro. | sec ou #num - o per¨ªodo de an¨¢lise pode ser em segundos ou em quantidade de valores (neste caso o n¨²mero ¨¦ precedido pelo caractere "#") time_shift (opcional) - consulte avg() percentage - um n¨²mero em ponto flutuante entre 0 e 100 (inclusive) com at¨¦ 4 d¨ªgitos na parte decimal |
Tipos de valores suportados: float, int Esta fun??o ¨¦ suportada desde o Áú»¢¶Ä²© 3.0.0. |
|
| prev | |||
| Valor anterior. | Tipos de valores suportados: float, int, str, text, log Retorna o mesmo que last(#2). |
||
| regexp (pattern,<sec|#num>) | |||
| Verifica se o ¨²ltimo (mas recente) valor confere com determinada express?o regular. | pattern - express?o regular, seguindo o padr?o . sec ou #num - o per¨ªodo de an¨¢lise pode ser em segundos ou em quantidade de valores (neste caso o n¨²mero ¨¦ precedido pelo caractere "#"). Nestes casos mais de um valor poder¨¢ ser analisado. |
Tipos de valores suportados: str, text, log Retorna: 1 - encontrado 0 - outro caso Esta fun??o ¨¦ sens¨ªvel ao caso. |
|
| str (pattern,<sec|#num>) | |||
| Procura um texto no ¨²ltimo (mais recente) valor. | pattern - string desejada sec ou #num - o per¨ªodo de an¨¢lise pode ser em segundos ou em quantidade de valores (neste caso o n¨²mero ¨¦ precedido pelo caractere "#"). Nestes casos mais de um valor poder¨¢ ser analisado. |
Tipos de valores suportados: str, text, log Retorna: 1 - encontrado 0 - outro caso Esta fun?]ap ¨¦ sens¨ªvel ao caso. |
|
| strlen (sec|#num,<time_shift>) | |||
| Tamanho do ¨²ltimo valor (mais recente) em caracteres (n?o bytes). | sec (ignorado) ou #num - o eN¨¦simo valor mais recente time_shift (opcional) - consulte avg() |
Tipos de valores suportados: str, text, log Observe que o par?metro #num aqui funciona de forma diferente de outras fun??es.Exemplos: => strlen() ¨¦ o mesmo que strlen(#1) ¡ú tamanho do ¨²ltimo valor=> strlen(#3) ¡ú tamanho do terceiro valor mais recente => strlen(,1d) ¡ú tamanho do valor mais recente de um dia atr¨¢s. Esta fun??o ¨¦ suportada desde o Áú»¢¶Ä²© 1.8.4. |
|
| sum (sec|#num,<time_shift>) | |||
| Total dos valores coletados em determinado per¨ªodo de an¨¢lise. | sec ou #num - o per¨ªodo de an¨¢lise pode ser em segundos ou em quantidade de valores (neste caso o n¨²mero ¨¦ precedido pelo caractere "#") time_shift (opcional) - consulte avg() |
Tipos de valores suportados: float, int O par?metro time_shift ¨¦ suportado desde o Áú»¢¶Ä²© 1.8.2. |
|
| time | |||
Hora atual no formato HHMMSS. |
Tipos de valores suportados: any Exemplo de valor retornado: 123055 |
||
| timeleft (sec|#num,<time_shift>,threshold,<fit>) | |||
| Tempo necess¨¢rio em segundos para um item alcan?ar determinado limite. | sec ou #num - o per¨ªodo de an¨¢lise pode ser em segundos ou em quantidade de valores (neste caso o n¨²mero ¨¦ precedido pelo caractere "#") time_shift (opcional) - consulte avg() threshold - valor a alcan?ar fit (opcional) - veja forecast() |
Tipos de valores suportados: float, int Se o valor retornado for maior que 999999999999.9999, ser¨¢ reduzido a 999999999999.9999. Retorna 999999999999.9999 se o limite n?o puder ser alcan?ado. Passa a ser n?o suportado somente se for mal utilizado na express?o (tipo errado de item, par?metros inv¨¢lidos), qualquer outra situa??o retorna -1 em caso de erros.Exemplos: => timeleft(#10,,0) ¡ú tempo para o item alcan?ar o valor '0' baseado nos ¨²ltimos 10 valores => timeleft(1h,,100) ¡ú tempo at¨¦ o item alcan?ar o valor '100' baseado nos dados da ¨²ltima hora => timeleft(1h,1d,0) ¡ú tempo para o item alcan?ar o valor '0' baseado em 1 hora de 24 horas atr¨¢s => timeleft(1h,,200,polynomial2) ¡ú tempo at¨¦ o item alcan?ar o valor '200' baseado na ¨²ltima hora, assumindo que o item se comporte como um polinomial quadrado (segundo grau) Esta fun??o ¨¦ suportada desde o Áú»¢¶Ä²© 3.0.0. Consulte informa??es adicionais no manual de fun??es preditivas de trigger. |
|
- Todas as fun??es retornam apenas valores num¨¦ricos. A compara??o com textos n?o ¨¦ suportada, por exemplo.
- Algumas das fun??es n?o podem ser utilizadas com par?metros n?o num¨¦ricos!
- Argumentos de texto precisam estar entre aspas duplas, de outra forma poder?o ser mal interpretados.
Footnotes
1 The evaluation period is up to the latest collected value (not the server 'now' time). A function is evaluated as soon as at least one value is received (unless the time_shift parameter is used), i.e. Áú»¢¶Ä²© will not wait for all the values within the defined evaluation period before evaluating the function.
Functions and unsupported items
Since Áú»¢¶Ä²© 3.2, nodata(), date(), dayofmonth(), dayofweek(), now() and time() functions are calculated for unsupported items, too. Other functions require that the referenced item is in a supported state.