Documentation
Table of Contents
2 Intervalos customizados
Vis?o geral
? poss¨ªvel criar regras customizadas em rela??o ao tempo em que um item ¨¦ verificado. Os dois m¨¦todos dispon¨ªveis s?o Intervalos flex¨ªveis, que permitem redefinir o intervalo de atualiza??o padr?o, e Agendamento, pelo qual uma verifica??o pode ser executada em um hor¨¢rio espec¨ªfico ou sequ¨ºncia de hor¨¢rios.
Áú»¢¶Ä²© agent 2 supports custom intervals for both passive and active checks, whereas Áú»¢¶Ä²© agent supports custom intervals only for passive checks. See Áú»¢¶Ä²© agent vs agent 2 comparison.
Intervalos flex¨ªveis
Intervalos flex¨ªveis permitem redefinir o intervalo de atualiza??o padr?o para pe¨ªodos de tempo espec¨ªficos. Um intervalo flex¨ªvel ¨¦ definido com Intervalo e ±Ê±ð°ù¨ª´Ç»å´Ç onde:
- Intervalo ¨C o intervalo de atualiza??o para o per¨ªodo de tempo especificado
- ±Ê±ð°ù¨ª´Ç»å´Ç ¨C o per¨ªodo de tempo quando o intervalo flex¨ªvel est¨¢ ativo (consulte per¨ªodos de tempo para uma descri??o detalhada do formato para ±Ê±ð°ù¨ª´Ç»å´Ç)
At¨¦ sete intervalos fl¨¦x¨ªveis podem ser definidos. Se m¨²ltiplos intervalos se sobrep?em, o menor valor de intervalo ¨¦ utilizado para o per¨ªodo de sobreposi??o. Note que se o menor valor de sobreposi??o de intervalos for '0', n?o haver¨¢ verifica??o passiva (polling). Fora dos intervalos flex¨ªveis ¨¦ usado o intervalo de atualiza??o padr?o.
Note que se o intervalo flex¨ªvel se iguala ¨¤ largura do per¨ªodo, o item ser¨¢ verificado exatamente uma vez. Se o intervalo ¨¦ maior que o per¨ªodo, o item pode ser verificado uma vez ou ele pode nem ser verificado (por isso tal configura??o n?o ¨¦ aconselh¨¢vel). Se o intervalo flex¨ªvel ¨¦ menor que o per¨ªodo, o item ser¨¢ verificado ao menos uma vez.
Se o intervalo flex¨ªvel for configurado para '0', o item n?o ¨¦ verificado durante o per¨ªodo do intervalo flex¨ªvel e retorna a verifica??o de acordo com o Intervalo de atualiza??o padr?o assim que o per¨ªodo tiver findado. Exemplos:
| Intervalo | ±Ê±ð°ù¨ª´Ç»å´Ç | Descri??o |
|---|---|---|
| 10 | 1-5,09:00-18:00 | O item ser¨¢ verificado a cada 10 segundos durante o hor¨¢rio de trabalho. |
| 0 | 1-7,00:00-7:00 | O item n?o ser¨¢ verificado durante a madrugada. |
| 0 | 7-7,00:00-24:00 | O item n?o ser¨¢ verificado aos domingos. |
| 60 | 1-7,12:00-12:01 | O item ser¨¢ verificado todos os dias ao meio-dia. Note que isto foi usado como conting¨ºncia para verifica??es agendadas e a partir do Áú»¢¶Ä²© 3.0 ¨¦ recomendado usar intervalos de agendamento para tais verifica??es. |
Intervalos de agendamento
Intevalos de agendamento s?o utilizados para verificar itens em hor¨¢rios espec¨ªficos. Enquanto os intervalos flex¨ªveis s?o projetados para redefinir o intervalo de atualiza??o padr?o do item, os intervalos de agendamento s?o usados para especificar uma agenda de verifica??o independente, que ¨¦ executada de forma paralela.
Um intervalo de agendamento ¨¦ definido como: md<filtro>wd<filtro>h<filtro>m<filtro>s<filtro> onde:
- md - m¨ºs dias
- wd - semana dias
- h - horas
- m - minutos
- s ¨C segundos
O <filtro> ¨¦ usado para especificar valores para seu prefixo (dias, horas, minutos, segundos) e ¨¦ definido como: °Ú&±ô³Ù;»å±ð&²µ³Ù;°Ú-&±ô³Ù;²¹³Ù¨¦&²µ³Ù;±Õ±Õ°Ú/&±ô³Ù;²õ²¹±ô³Ù´Ç&²µ³Ù;±Õ°Ú,&±ô³Ù;´Ú¾±±ô³Ù°ù´Ç&²µ³Ù;±Õ onde:
<de>e&±ô³Ù;²¹³Ù¨¦&²µ³Ù;definem o intervalo de valores considerados (inclusive eles pr¨®prios). Se&±ô³Ù;²¹³Ù¨¦&²µ³Ù;for omitido ent?o o filtro interpreta o intervalo como<de> - <de>Se<de>tamb¨¦m for omitido ent?o o filtro considerar¨¢ como intervalo todos os valores poss¨ªveis.<salto>define o salto dentro do intervalo. Por padr?o<salto>tem o valor 1, o que significa que todos os valores do intervalo definido s?o considerados.
Mesmo sendo as defini??es de filtros opcionais, ao menos um filtro deve ser usado. Um filtro deve definir um intervalo ou um valor de <salto> .
Um filtro vazio corresponde a '0' se n?o houver defini??o de filtros nos n¨ªveis abaixo, caso contr¨¢rio, todos os valores poss¨ªveis ser?o considerados. Por exemplo, se o filtro de hora ¨¦ omitido ent?o apenas a hora '0' ser¨¢ considerada, contanto que os filtros de minutos e segundos tamb¨¦m tenham sido omitidos, caso contr¨¢rio o filtro de hora vazio considerar¨¢ todos os valores de hora poss¨ªveis.
Valores v¨¢lidos para <de> e &±ô³Ù;²¹³Ù¨¦&²µ³Ù; em seus respectivos prefixos s?o:
| Prefixo | Descri??o | <de> | <ate> |
|---|---|---|---|
| md | M¨ºs dias | 1-31 | 1-31 |
| wd | Semana dias | 1-7 | 1-7 |
| h | Horas | 0-23 | 0-23 |
| m | Minutos | 0-59 | 0-59 |
| s | Segundos | 0-59 | 0-59 |
O valor <de> deve ser menor ou igual ao valor de &±ô³Ù;²¹³Ù¨¦&²µ³Ù;. O <salto> deve ser maior ou igual a 1 e menor ou igual a &±ô³Ù;²¹³Ù¨¦&²µ³Ù; - <de>.
Valores simples para dias do m¨ºs, horas, minutos e segundos podem ser prefixados com 0. Por exemplo, md01-31 e h/02 s?o intervalos v¨¢lidos, mas md01-031 e wd01-07 n?o s?o.
No Áú»¢¶Ä²© Frontend, m¨²ltiplos intervalos de agendamento s?o informados em linhas separadas. No Áú»¢¶Ä²© API, eles s?o concatenados em um texto ¨²nico com ponto-e-v¨ªrgula ; como separador.
Se um tempo ¨¦ correspondido por v¨¢rios intervalos ele ¨¦ executado apenas uma vez. Por exemplo, wd1h9;h9 ser¨¢ executado apenas uma vez na segunda ¨¤s 9h.
Exemplos:
| Intervalo | Ser¨¢ executado |
|---|---|
| m0-59 | a cada minuto |
| h9-17/2 | a cada 2 horas come?ando ¨¤s 9h (9h, 11h ...) |
| m0,30 or m/30 | de hora em horas ¨¤s Xh e Xh30 |
| m0,5,10,15,20,25,30,35,40,45,50,55 or m/5 | a cada cinco minutos |
| wd1-5h9 | toda segunda a sexta ¨¤s 9h |
| wd1-5h9-18 | toda segunda a sexta ¨¤s 9h,10h,...,18h |
| h9,10,11 or h9-11 | todo dia ¨¤s 9h, 10h e 11h |
| md1h9m30 | todo 1? dia de cada m¨ºs ¨¤s 9h30 |
| md1wd1h9m30 | todo 1? dia de cada m¨ºs ¨¤s 9h30 se for segunda |
| h9m/30 | todo dia ¨¤s 9h, 9h30 |
| h9m0-59/30 | todo dia ¨¤s 9h, 9h30 |
| h9,10m/30 | todo dia ¨¤s 9h, 9h30, 10h, 10h30 |
| h9-10m30 | todo dia ¨¤s 9h30, 10h30 |
| h9m10-40/30 | todo dia ¨¤s 9h10, 9h40 |
| h9,10m10-40/30 | todo dia ¨¤s 9h10, 9h40, 10h10, 10h40 |
| h9-10m10-40/30 | todo dia ¨¤s 9h10, 9h40, 10h10, 10h40 |
| h9m10-40 | todo dia ¨¤s 9h10, 9h11, 9h12, ... 9h40 |
| h9m10-40/1 | todo dia ¨¤s 9h10, 9h11, 9h12, ... 9h40 |
| h9-12,15 | todo dia ¨¤s 9h, 10h, 11h, 12h, 15h |
| h9-12,15m0 | todo dia ¨¤s 9h, 10h, 11h, 12h, 15h |
| h9-12,15m0s30 | todo dia ¨¤s 9h0m30s, 10h0m30s, 11h0m30s, 12h0m30s, 15h0m30s |
| h9-12s30 | todo dia ¨¤s 9h0m30s, 9h01m30s, 9h02m30s ... 12h58m30s, 12h59m30s |
| h9m/30;h10 (Sintaxe espec¨ªfica da API) | todo dia ¨¤s 9h, 9h30, 10h |
| h9m/30 h10 (adicione este como outra linha no Frontend) |
todo dia ¨¤s 9h, 9h30, 10h |
Aligning time zones for proxies and agent 2
Note that Áú»¢¶Ä²© proxies and agent 2 use their local time zones when processing scheduling intervals.
For this reason, when scheduling intervals are applied to items monitored by Áú»¢¶Ä²© proxy or agent 2 active items, it is recommended to set the time zone of the respective proxies or agent 2 the same as Áú»¢¶Ä²© server, otherwise the queue may report item delays incorrectly.
The time zone for Áú»¢¶Ä²© proxy or agent 2 can be set using the environment variable TZ in the systemd unit file: