É 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.
Zabbix agent 2 supports custom intervals for both passive and active checks, whereas Zabbix agent supports custom intervals only for passive checks. See Zabbix agent vs agent 2 comparison.
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 Período onde:
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 | Período | 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 Zabbix 3.0 é recomendado usar intervalos de agendamento para tais verificações. |
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:
O <filtro>
é usado para especificar valores para seu prefixo (dias, horas, minutos, segundos) e é definido como: [<de>[-<até>]][/<salto>][,<filtro>]
onde:
<de>
e <até>
definem o intervalo de valores considerados (inclusive eles próprios). Se <até>
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 <até>
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 <até>
. O <salto>
deve ser maior ou igual a 1 e menor ou igual a <até>
- <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 Zabbix Frontend, múltiplos intervalos de agendamento são informados em linhas separadas. No Zabbix 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 |
Note that Zabbix 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 Zabbix proxy or agent 2 active items, it is recommended to set the time zone of the respective proxies or agent 2 the same as Zabbix server, otherwise the queue may report item delays incorrectly.
The time zone for Zabbix proxy or agent 2 can be set using the environment variable TZ
in the systemd
unit file: