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:
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:
- no horário de início, o sistema monta e envia o anúncio pelo mesmo caminho do botão Anunciar;
- 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.
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
| Regra | Detalhe |
|---|---|
| Formato | dd/mm/aaaa hh:mm nos dois campos. |
| Início | Precisa ser no futuro, respeitando a antecedência mínima (60 segundos por padrão). |
| Término | Precisa ser depois do início. |
| Duração mínima | 5 minutos. |
| Duração máxima | 60 dias. |
| Rota unicast | Precisa 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
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.
Acompanhando
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
| Coluna | O que mostra |
|---|---|
| ID | Identificador do agendamento. |
| Tipo | Rota BGP (unicast) ou FlowSpec. |
| Prefixo | A rede que será anunciada. |
| Início / Término | A janela, no seu fuso, com a contagem regressiva embaixo. |
| Duração | O tamanho da janela. |
| Status | O estado atual (tabela abaixo). |
| Anúncio | O #id do anúncio gerado, com link para o histórico já filtrado nele. |
| Criado por | Quem agendou. |
| Ações | Cancelar o agendamento. |
Os status
| Status | Significado |
|---|---|
| Agendada | Reservado, esperando a janela abrir. |
| Anunciada | Janela aberta, rota no roteador. |
| Concluída | Janela encerrada, rota retirada. |
| Falhou | Não anunciou, ou o anúncio falhou. Passe o mouse sobre o badge para ver o motivo. |
| Cancelada | Cancelado por um operador. |
Motivos de falha
Passando o mouse sobre o badge Falhou, o sistema explica o que aconteceu:
| Motivo | O que houve |
|---|---|
| Horário de início passou | A 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 passou | O período todo terminou antes de qualquer execução. |
| Dado deixou de ser válido | Prefixo, grupo de anúncio ou vizinho foi removido entre o agendamento e a execução. |
| Já existia rota ativa idêntica | Anunciar 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 criado | O 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 mais | A 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.
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:
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
- Não existe recorrência. Cada agendamento é uma janela única; para repetir, agende de novo.
- 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.