Áú»¢¶Ä²©

2 Intervalos personalizados

Vis?o geral

? poss¨ªvel criar regras de personaliza??o que afetem quando um item ser¨¢ coletado. S?o duas as formas, a primeira ¨¦ conhecida como Intervalos Flex¨ªveis e permite redefinir o intervalo entre coletas. A segunda forma ¨¦ o Agendamento, nesta forma de coleta ¨¦ poss¨ªvel especificar exatamente quando ocorrer?o as coletas, n?o apenas o intervalo entre elas.

Intervalos flex¨ªveis

Os intervalos flex¨ªveis permitem redefinir o intervalo entre coletas em per¨ªodos espec¨ªficos. Para definir a personaliza??o ¨¦ preciso informar dois valores:

  • ±Ê±ð°ù¨ª´Ç»å´Ç ¨C O per¨ªodo (dia e hora) em que o intervalo flex¨ªvel estar¨¢ ativo (mais detalhes em per¨ªodos de tempo)
  • Intervalo ¨C o intervalo entre coletas que dever¨¢ ser considerado em um determinado per¨ªodo

Podem ser definidos at¨¦ sete intervalos flex¨ªveis por item. Se os per¨ªodos dos intervalos flex¨ªveis se sobrepuser, ser¨¢ considerado o menor intervalo entre coletas. Observe que se o intervalo flex¨ªvel for igual a '0', a monitora??o n?o ocorrer¨¢. Fora dos per¨ªodos definidos nos intervalos flex¨ªveis, o intervalo padr?o ser¨¢ adotado.

Observe que se o intervalo entre coletas for exatamente igual ao tamanho do per¨ªodo em que ele ¨¦ v¨¢lido, a coleta ocorrer¨¢ somente uma vez. Se o intervalo entre coletas for maior do que o per¨ªodo de validade da personaliza??o, a coleta poder¨¢ n?o ocorrer. Se o intervalo entre coletas for menor do que o per¨ªodo de validade do intervalo flex¨ªvel, a coleta poder¨¢ ocorrer mais de uma vez.

Se o intervalo flex¨ªvel for configurado para o valor '0' o item n?o ser¨¢ monitorado durante o per¨ªodo flex¨ªvel, retornando a ser coletado quando o per¨ªodo flex¨ªvel estiver inativo.

Exemplos:

Intervalo ±Ê±ð°ù¨ª´Ç»å´Ç Descri??o
10 1-5,09:00-18:00 O item ser¨¢ verificado a cada 10 segundos durante a per¨ªodo flex¨ªvel.
0 1-7,00:00-7:00 O item n?o ser¨¢ verificado durante a madrugada.
60 1-7,12:00-12:01 O item ser¨¢ verificado as 12:00 todo dia. Observe que este era uma solu??o alternativa enquanto n?o t¨ªnhamos o agendamento de coletas. A partir do Áú»¢¶Ä²© 3.0 n?o ¨¦ recomend¨¢vel utilizar-se do recurso de intervalo flex¨ªvel para a coleta em hor¨¢rio agendado, para isso use o Agendamento.

Agendamento de coletas

O recurso de agendamento de coletas ¨¦ utilizado para garantir a coleta de um item em um momento espec¨ªfico. Enquanto o intervalo flex¨ªvel ¨¦ utilizado para redefinir o intervalo entre coletas, o agendamento ¨¦ utilizado para especificar uma coleta em um momento espec¨ªfico, de forma independente do per¨ªodo padr?o. As coletas ser?o executadas em paralelo.

Um agendamento ¨¦ definido como: md<filtro>wd<filtro>h<filtro>m<filtro>s<filtro> onde:

  • md - dia do m¨ºs
  • wd - dia da semana
  • h - hora
  • m - minuto
  • s ¨C segundo
* 

<filtro> ¨¦ usado para definir o valor para o prefixo (dias, horas, minutos, segundos) e ¨¦ definido como: °Ú&±ô³Ù;»å±ð&²µ³Ù;°Ú-&±ô³Ù;²¹³Ù¨¦&²µ³Ù;±Õ±Õ°Ú/&±ô³Ù;²õ²¹±ô³Ù´Ç&²µ³Ù;±Õ°Ú,&±ô³Ù;´Ú¾±±ô³Ù±ð°ù&²µ³Ù;±Õ onde:

  • <de> e <ate> definem o range de valores poss¨ªveis (incluindo eles pr¨®prios). Se &±ô³Ù;²¹³Ù¨¦&²µ³Ù; for omitido o filtro ir¨¢ considerar que o range ¨¦ <de> - <de>. Se o <de> tamb¨¦m for omitido o filtro ir¨¢ considerar que o range engloba todos os valores poss¨ªveis.
  • <salto> define o valor a saltar dentro do range. Por padr?o o <salto> ¨¦ igual a 1, isso significa que todos os valores poss¨ªveis no range ser?o aceitos.

As defini??es de filtro s?o opcionais, entretanto, cada filtro selecionado dever¨¢ ter um range ou um <salto> definido.

Lista de valores v¨¢lidos para <de> e &±ô³Ù;²¹³Ù¨¦&²µ³Ù; para cada tipo de filtro:

Prefixo Descri??o <de> &±ô³Ù;²¹³Ù¨¦&²µ³Ù;
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 <de> dever¨¢ ser menor ou igual ao valor definido em &±ô³Ù;²¹³Ù¨¦&²µ³Ù;. O valor do <salto> dever¨¢ ser maior ou igual a 1 e menor ou igual ao menor valor dos campos <de> - &±ô³Ù;²¹³Ù¨¦&²µ³Ù;.

O primeiro campo de um filtro, tendo apenas um d¨ªgito, poder¨¢ receber o prefixo '0'. Por exemplo md01-31 e h/02 s?o intervalos v¨¢lidos, mas md01-031 e wd01-07 n?o s?o v¨¢lidos.

M¨²ltiplos agendamentos podem ser utilizados ao se separar pelo caracter ;. Se If a time is matched by several intervals it is executed only once. For example, wd1h9;h9 will be executed only once on Monday at 9am.

Examples:

Intervalo Descri??o
m0-59 Coleta a cada minuto
h9-17/2 Coleta a cada 2 horas, come?ando as 9 e terminando as 17 (9:00, 11:00 ...)
m0,30 or m/30 Coleta em todo o minuto 30 de cada hora
m0,5,10,15,20,25,30,35,40,45,50,55 ou m/5 Coleta a cada cinco minutos
wd1-5h9 Coleta de segunda a sexta, as 9:00
wd1-5h9-18 Coleta de segunda a sexta, de nove as 18, uma vez por hora (9:00,10:00,...,18:00)
h9,10,11 or h9-11 Coleta todo dia as 9:00, 10:00 e 11:00
md1h9m30 Coleta no primeiro dia de cada m¨ºs as 09:30
md1wd1h9m30 Coleta no primeiro dia de cada m¨ºs, mas s¨® se o dia for tamb¨¦m uma segunda feira
h9m/30 ou h9m0-59/30 Coleta as 09:00 e as 09:30
h9,10m/30 Coleta as 9:00, 9:30, 10:00, 10:30
h9-10m30 Coleta as 9:30, 10:30
h9m10-40/30 Coleta as 9:10, 9:40
h9,10m10-40/30 Coleta as 9:10, 9:40, 10:10, 10:40
h9m10-40 ou h9m10-40/1 Coleta as 9:10, 9:11, 9:12, ... 9:40
h9-12,15 Coleta as 9:00, 10:00, 11:00, 12:00, 15:00
h9-12,15m0 ou h9-12,15m0s0 execute at 9:00, 10:00, 11:00, 12:00, 15:00
h9-12s30 Coleta as 9:00:30, 10:00:30, 11:00:30, 12:00:30
h9m/30;h10 Coleta as 9:00, 9:30, 10:00