Table of Contents
2 Intervalos customizados
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 específicos. Um intervalo flexível é definido com Intervalo e Período, onde:
- Intervalo – to intervalo de atualização para o período de tempo especificado
- Period –o período de tempo em que o intervalo flexível está ativo (consulte os time periods para uma descrição detalhada do formato do Período)
Se múltiplos intervalos flexíveis se sobrepuserem, o menor valor de Intervalo é usado para o período de sobreposição. Observe que, se o menor valor dos intervalos flexíveis sobrepostos for '0', nenhuma verificação será realizada. Fora dos intervalos flexíveis, o intervalo de atualização padrão é utilizado.
Note 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 pode ser verificado uma vez ou pode não ser verificado de todo (portanto, tal configuração não é aconselhável). 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á verificado durante o período do intervalo flexível e retomará a verificação de acordo com o Intervalo de atualização padrão uma vez que o período termine. 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 comercial. |
| 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 todos os dias. Note que isso era usado como uma solução alternativa para verificações agendadas e, a partir do Zabbix 3.0, é recomendado usar intervalos de agendamento para tais verificações. |
Intervalos de agendamento
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 de atualização padrão do item, os intervalos de agendamento são usados para especificar uma programação 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 a faixa de valores correspondentes (incluídos). Se<to>for omitido, o filtro corresponderá a uma faixa<from> - <from>. Se<from>também for omitido, o filtro corresponderá a todos os valores possíveis.<step>define os intervalos dos valores numéricos através da faixa. Por padrão,<step>tem o valor de 1, o que significa que todos os valores da faixa definida são correspondidos.
Embora as definições de filtro sejam opcionais, pelo menos um filtro deve ser usado. Um filtro deve ter uma faixa ou o valor <step> definido.
Um filtro vazio corresponde a '0' se nenhum filtro de nível inferior for definido ou a todos os valores possíveis caso contrário. Por exemplo, se o filtro de hora for omitido, apenas a hora '0' será correspondida, 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.
Valores válidos <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>.
Os valores de dias do mês, horas, minutos e segundos com um único dígito podem ser precedidos por 0. Por exemplo, md01-31 e h/02 são intervalos válidos, mas md01-031 e wd01-07 não.
Na interface do Zabbix, vários intervalos de agendamento são inseridos em linhas separadas. Na API do Zabbix, eles são concatenados em uma única string com um ponto e vírgula ; como separador.
Se um horário for correspondido por vários intervalos, ele será executado apenas uma vez. Por exemplo, wd1h9;h9 será executado apenas uma vez na segunda-feira às 9h.
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 | a cada hora às hh:00 e hh:30 |
| m0,5,10,15,20,25,30,35,40,45,50,55 ou m/5 | a cada cinco minutos |
| wd1-5h9 | de segunda a sexta-feira às 9:00 |
| wd1-5h9-18 | de segunda a sexta-feira à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 na interface) |
todos os dias às 9:00, 9:30, 10:00 |
Alinhando fusos horários para proxies e agente 2
Observe que os proxies do Zabbix e o agente 2 usam seus fusos horários locais ao processar intervalos de agendamento.
Por esta razão, quando os intervalos de agendamento são aplicados a itens monitorados pelo proxy do Zabbix ou itens ativos do agente 2, é recomendado definir o fuso horário dos respectivos proxies ou do agente 2 para o mesmo do servidor Zabbix, caso contrário, a queue pode relatar atrasos nos itens incorretamente.
O fuso horário para o proxy do Zabbix ou agente 2 pode ser definido usando a variável de ambiente TZ no arquivo de unidade systemd :