Agendamento de rotas BGP e FlowSpec

Programe com antecedência quando um anúncio BGP ou FlowSpec entra e quando ele sai.

O agendamento de rotas marca com antecedência quando um anúncio BGP — unicast ou FlowSpec — entra e quando ele sai, sem ninguém precisar estar de plantão. É a forma de cobrir janelas de manutenção, eventos com pico previsto e mitigações programadas.

Disponível a partir da versão 2.12.4.

O card Rotas BGP agendadas fica em BGP Protocol -> BGP Routing, entre os anúncios ativos e o histórico:

Card de rotas BGP agendadas

Como funciona

Um agendamento não é um anúncio. Ele guarda apenas a intenção: os mesmos campos que o anúncio manual enviaria, mais a janela escolhida. O anúncio de verdade só nasce quando a janela abre:

  1. no horário de início, o sistema monta e envia o anúncio pelo mesmo caminho do botão Anunciar;
  2. no horário de término, a rota é retirada automaticamente.

Enquanto a janela está aberta, o anúncio aparece em Anúncios de rotas BGP ativas como qualquer outro. Depois que ela fecha, ele vai para o histórico. É por isso que o card de agendadas mostra, por padrão, apenas o que ainda não foi executado.

Agendando

No card Rotas BGP agendadas, clique em Agendar rota BGP ou Agendar FlowSpec.

Formulário de agendamento de rota BGP

Abre o mesmo formulário do anúncio manual, em modo agendamento. A diferença é que o campo Manter ativo por/Duração some — a janela já responde isso — e entram Início do anúncio e Término do anúncio, cada um com data e hora. A janela vem pré-preenchida com início em cerca de 15 minutos e 1 hora de duração.

Os demais campos são os de sempre: Network (o prefixo), Community, Extended community, Nexthop, AS-PATH, e os Grupos de anúncio ou Sessões BGP adicionais que definem por onde a rota sai.

Os horários seguem o fuso configurado no seu perfil. Internamente tudo é guardado em UTC, então um agendamento criado por um operador aparece no horário local de quem o consulta.

Regras da janela

RegraDetalhe
Formatodd/mm/aaaa hh:mm nos dois campos.
InícioPrecisa ser no futuro, respeitando a antecedência mínima (60 segundos por padrão).
TérminoPrecisa ser depois do início.
Duração mínima5 minutos.
Duração máxima60 dias.
Rota unicastPrecisa de Community ou Extended community — sem nenhuma das duas, a janela abriria sem anunciar nada.

A validação é a mesma do anúncio imediato, incluindo as regras de FlowSpec (origem e destino obrigatórios, gramática de tcp-flags, unidades de rate-limit). Ela roda na hora de agendar, não na hora de anunciar — assim você não descobre dias depois que a regra estava malformada.

Agendando FlowSpec

Formulário de agendamento de FlowSpec

O formulário de FlowSpec agendado tem a janela no topo e, abaixo, os mesmos Filtros e Ações do anúncio manual.

Modelos de FlowSpec não são agendáveis. No modo agendamento a opção Template fica desabilitada e apenas o formulário Manual pode ser reservado. Um modelo resolve suas variáveis no momento do clique; agendar um significaria guardar uma regra ainda não resolvida. Para agendar uma regra que hoje você anuncia por template, monte-a manualmente no formulário.

Repetindo o agendamento

Disponível a partir da versão 2.13.0.

Nos dois formulários — rota BGP e FlowSpec — o bloco Repetir este agendamento fica logo abaixo da janela, desligado. Ligado, ele transforma o agendamento em uma série: a mesma janela volta no intervalo escolhido.

Bloco Repetir este agendamento com recorrência semanal
CampoO que define
Diária / Semanal / MensalA frequência da repetição.
A cadaO intervalo: a cada 1 dia, a cada 2 semanas, a cada 3 meses...
Dias da semanaSó na semanal. Escolha um ou mais dias; o dia do Início do anúncio precisa ser um deles.
Repetir até / Repetir N vezesComo a série termina: em uma data ou depois de um número de ocorrências (no mínimo 2).

Abaixo dos campos, uma frase resume a regra — "Toda terça e quinta às 15:33, até 07/11/2026" —, para você conferir antes de confirmar. O horário de cada repetição é o do Início do anúncio, e a duração de cada janela é a mesma da primeira.

Regras da série:

  • Mensal repete no mesmo dia do mês do início. Em meses mais curtos, a janela cai no último dia do mês (o dia 31 vira 30 em abril e 28 ou 29 em fevereiro) e volta ao dia 31 nos meses que o têm.
  • A janela não pode ser mais longa que o intervalo entre as repetições — duas ocorrências não se sobrepõem.
  • Uma série tem no máximo 365 ocorrências e não pode passar de 730 dias a partir de hoje.
  • O horário é mantido no fuso do seu perfil: "toda terça às 22:00" continua às 22:00 depois de uma mudança de horário de verão.

O card mostra uma ocorrência por vez: a próxima janela só é criada quando a atual sai do estado Agendada. Uma ocorrência que falhar não encerra a série — a seguinte é criada normalmente. As linhas de uma série trazem, na coluna Tipo, um selo com a posição na série (2 de 4) ou Recorrente, quando a série termina por data; passe o mouse sobre ele para ver a regra.

Acompanhando

Filtros e contadores do card de rotas agendadas

Filtros no cabeçalho do card:

  • Aguardando (padrão) — janelas que ainda não abriram;
  • Anunciadas — janelas abertas, com a rota no roteador agora;
  • Concluídas — janelas que já fecharam e tiveram a rota retirada;
  • Falhas — agendamentos que não conseguiram anunciar;
  • Todas.

Os filtros existem porque um agendamento que falhou ou foi cancelado antes de anunciar nunca chegou a criar um anúncio e, portanto, não tem como aparecer no histórico de rotas BGP.

Contadores ao lado do título: o relógio mostra os agendamentos em aberto (aguardando ou já anunciados) e o triângulo mostra as falhas. O de falhas é clicável e leva direto ao filtro Falhas. Ambos contam a tabela inteira, não só a página, e somem quando zerados.

Contagem regressiva: sob o horário de início das agendadas aparece "em 42m"; sob o término das anunciadas, "restam 55m". Os segundos vêm do servidor, então um relógio de navegador desregulado não altera o que é mostrado.

Ordem padrão: janelas em aberto primeiro. Clicando em qualquer cabeçalho de coluna, vale a ordenação escolhida.

As colunas

ColunaO que mostra
IDIdentificador do agendamento.
TipoRota BGP (unicast) ou FlowSpec.
PrefixoA rede que será anunciada.
Início / TérminoA janela, no seu fuso, com a contagem regressiva embaixo.
DuraçãoO tamanho da janela.
StatusO estado atual (tabela abaixo).
AnúncioO #id do anúncio gerado, com link para o histórico já filtrado nele.
Criado porQuem agendou.
AçõesCancelar o agendamento.

Os status

StatusSignificado
AgendadaReservado, esperando a janela abrir.
AnunciadaJanela aberta, rota no roteador.
ConcluídaJanela encerrada, rota retirada.
FalhouNão anunciou, ou o anúncio falhou. Passe o mouse sobre o badge para ver o motivo.
CanceladaCancelado por um operador.

Motivos de falha

Passando o mouse sobre o badge Falhou, o sistema explica o que aconteceu:

MotivoO que houve
Horário de início passouA janela deveria ter aberto, mas a execução atrasou além da tolerância (fila parada, sistema fora do ar). O anúncio nunca é feito atrasado: quem agendou um blackhole para as 22h não quer ele subindo às 3h.
Janela inteira passouO período todo terminou antes de qualquer execução.
Dado deixou de ser válidoPrefixo, grupo de anúncio ou vizinho foi removido entre o agendamento e a execução.
Já existia rota ativa idênticaAnunciar duplicaria o estado, e a retirada no fim da janela derrubaria também o anúncio que já estava lá.
Anúncio falhou depois de criadoO anúncio chegou a ser criado mas falhou no roteador. Os detalhes estão no histórico de anúncios.
Usuário não existe maisA conta que criou o agendamento foi removida.

Uma janela perdida não é recuperada. Isso é uma decisão, não uma limitação: um anúncio de mitigação fora do horário planejado costuma causar mais problema do que resolver.

Cancelando

O botão da lixeira, na coluna Ações, fica disponível enquanto o agendamento não estiver em estado final:

  • Agendada → passa a Cancelada e nada é anunciado;
  • Anunciada → a rota já está no roteador e é retirada na hora, apenas ela;
  • já concluída, falhada ou cancelada → o registro sai da lista.

Em uma ocorrência de série, a confirmação traz a opção Cancelar toda a série. Sem marcar, cancela-se apenas aquela janela e a série continua criando a próxima. Marcando, a série é encerrada e a janela pendente é cancelada junto — com a rota retirada, se ela já estiver anunciada.

Onde o agendamento aparece depois

Como o agendamento anuncia pela mesma cadeia do anúncio manual, ele aparece naturalmente em Anúncios de rotas BGP ativas enquanto a janela está aberta e no Histórico de anúncios de rotas BGP depois que ela fecha.

Para distinguir de um clique humano feito no mesmo horário, essas linhas recebem o badge azul Agendado na coluna Classificação:

Histórico de anúncios com o badge Agendado

O badge continua aparecendo mesmo depois de o agendamento sair da lista de agendadas.

O que não chega ao histórico é o agendamento que morreu antes de anunciar — janela perdida, revalidação reprovada, usuário removido ou cancelamento ainda no estado Agendada. Esse só existe no próprio card, pelos filtros Falhas e Todas.

Limitações

  • Janela perdida não é recuperada, nem em uma série: se o sistema ficou fora do ar, a próxima ocorrência é calculada a partir de agora.
  • Modelos de FlowSpec não são agendáveis (veja acima).
  • Salvar como modelo fica oculto no modo agendamento: um modelo de anúncio guarda uma duração, e um agendamento guarda uma janela.

Precisa de uma rota por tempo indeterminado, ou quer subir o anúncio agora? Use o anúncio manual — o agendamento serve para janelas com hora marcada para começar e terminar.

Nesta página