2 Intervalos personalizados
Visão geral
É possível criar regras personalizadas em relação aos horários em que um item é verificado. Os dois métodos para isso são Intervalos flexíveis, que permitem redefinir o intervalo de atualização padrão, e Agendamento, pelo qual uma verificação de item pode ser executada em um horário específico ou sequência de horários.
Intervalos flexíveis
Os intervalos flexíveis permitem redefinir o intervalo de atualização padrão para períodos de tempo específicos. Um intervalo flexível é definido com Intervalo e Período, onde:
- Intervalo - o intervalo de atualização para o período de tempo especificado. Suffixos de tempo são suportados, por exemplo, 30s, 1m, 2h, 1d.
- Período - o período de tempo em que o intervalo flexível está ativo (consulte os períodos de tempo para uma descrição detalhada do formato de Período)
Se vários intervalos flexíveis se sobrepuserem, o menor valor de Intervalo será usado para o período sobreposto. Observe que, se o menor valor dos intervalos flexíveis sobrepostos for '0', nenhuma sondagem será realizada. Fora dos intervalos flexíveis, o intervalo de atualização padrão é usado.
Observe que, se o intervalo flexível for igual à duração do período, o item será verificado exatamente uma vez. Se o intervalo flexível for maior que o período, o item poderá ser verificado uma vez ou poderá não ser verificado de forma alguma (portanto, essa configuração não é recomendada). Se o intervalo flexível for menor que o período, o item será verificado pelo menos uma vez.
Se o intervalo flexível for definido como '0', o item não será consultado durante o período do intervalo flexível e retomará a sondagem de acordo com o Intervalo de atualização padrão assim que o período terminar. Exemplos:
| Interval | Period | 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 noite. |
| 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 às 12:00 todos os dias. Observe que isso era usado como uma solução alternativa para verificações agendadas, e é recomendável usar intervalos de agendamento para esse tipo de verificação. |
Intervalos de agendamento
Os intervalos de agendamento são usados para verificar itens em horários específicos. Enquanto os intervalos flexíveis são projetados para redefinir o intervalo padrão de atualização do item, os intervalos de agendamento são usados para especificar uma agenda de verificação independente, que é executada em paralelo.
Um intervalo de agendamento é definido como: md<filter>wd<filter>h<filter>m<filter>s<filter> onde:
- md - dias do mês
- wd - dias da semana
- h - horas
- m - minutos
- s - segundos
<filter> é usado para especificar valores para seu prefixo (dias, horas, minutos, segundos) e é definido como: [<from>[-<to>]][/<step>][,<filter>] onde:
<from>e<to>definem o intervalo de valores correspondentes (incluídos). Se<to>for omitido, então o filtro corresponderá a um intervalo<from> - <from>. Se<from>também for omitido, então o filtro corresponderá a todos os valores possíveis.<step>define os saltos do valor numérico ao longo do intervalo. Por padrão,<step>tem o valor 1, o que significa que todos os valores do intervalo definido correspondem.
Embora as definições de filtro sejam opcionais, pelo menos um filtro deve ser usado. Um filtro deve ter um intervalo ou o valor de <step> definido.
Um filtro vazio corresponde a '0' se nenhum filtro de nível inferior estiver definido, ou a todos os valores possíveis caso contrário. Por exemplo, se o filtro de hora for omitido, então apenas a hora '0' corresponderá, desde que os filtros de minutos e segundos também sejam omitidos; caso contrário, um filtro de hora vazio corresponderá a todos os valores de hora.
Os valores válidos de <from> e <to> para seus respectivos prefixos de filtro são:
| Prefixo | Descrição | <from> | <to> |
|---|---|---|---|
| md | Dias do mês | 1-31 | 1-31 |
| wd | Dias da semana | 1-7 | 1-7 |
| h | Horas | 0-23 | 0-23 |
| m | Minutos | 0-59 | 0-59 |
| s | Segundos | 0-59 | 0-59 |
O valor <from> deve ser menor ou igual ao valor <to>.
O valor <step> deve ser maior ou igual a 1 e menor ou igual a <to> - <from>.
Valores de um único dígito 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, vários intervalos de agendamento são inseridos em linhas separadas.
Na API do Zabbix, eles são concatenados em uma única string com ponto e vírgula ; como separador.
Se um horário corresponder a vários intervalos, ele será executado apenas uma vez.
Por exemplo, wd1h9;h9 será executado apenas uma vez na segunda-feira às 9:00.
Exemplos:
| Intervalo | Será executado |
|---|---|
| m0-59 | a cada minuto |
| h9-17/2 | a cada 2 horas começando às 9:00 (9:00, 11:00 ...) |
| m0,30 or m/30 | de hora em hora em hh:00 e hh:30 |
| 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 9:00 |
| wd1-5h9-18 | toda segunda a sexta às 9:00,10:00,...,18:00 |
| h9,10,11 or h9-11 | todos os dias às 9:00, 10:00 e 11:00 |
| md1h9m30 | todo dia 1 de cada mês às 9:30 |
| md1wd1h9m30 | todo dia 1 de cada mês às 9:30 se for segunda-feira |
| h9m/30 | todos os dias às 9:00, 9:30 |
| h9m0-59/30 | todos os dias às 9:00, 9:30 |
| h9,10m/30 | todos os dias às 9:00, 9:30, 10:00, 10:30 |
| h9-10m30 | todos os dias às 9:30, 10:30 |
| h9m10-40/30 | todos os dias às 9:10, 9:40 |
| h9,10m10-40/30 | todos os dias às 9:10, 9:40, 10:10, 10:40 |
| h9-10m10-40/30 | todos os dias às 9:10, 9:40, 10:10, 10:40 |
| h9m10-40 | todos os dias às 9:10, 9:11, 9:12, ... 9:40 |
| h9m10-40/1 | todos os dias às 9:10, 9:11, 9:12, ... 9:40 |
| h9-12,15 | todos os dias às 9:00, 10:00, 11:00, 12:00, 15:00 |
| h9-12,15m0 | todos os dias às 9:00, 10:00, 11:00, 12:00, 15:00 |
| h9-12,15m0s30 | todos os dias às 9:00:30, 10:00:30, 11:00:30, 12:00:30, 15:00:30 |
| h9-12s30 | todos os dias às 9:00:30, 9:01:30, 9:02:30 ... 12:58:30, 12:59:30 |
| h9m/30;h10 (sintaxe específica da API) | todos os dias às 9:00, 9:30, 10:00 |
| h9m/30 h10 (adicione isto como outra linha no frontend) |
todos os dias às 9:00, 9:30, 10:00 |
Alinhando fusos horários para proxies e agent
Observe que os proxies e agent do Zabbix usam seus fusos horários locais ao processar intervalos de agendamento.
Por esse motivo, quando intervalos de agendamento são aplicados a items monitorados por proxy do Zabbix ou items ativos de agent, é recomendável definir o fuso horário dos respectivos proxies ou agent igual ao do server do Zabbix, caso contrário a fila pode relatar atrasos de items incorretamente.
O fuso horário para proxy ou agent do Zabbix pode ser definido usando a variável de ambiente TZ no arquivo de unidade systemd:
[Service]
...
Environment="TZ=Europe/Amsterdam"