Failover
Alta disponibilidade entre servidor RADIUS primário e secundário — estados, circuit breaker e override manual.
Failover
Menu: RADIUS → Cadastros → Bancos de Dados → menu ⋮ da conexão
O failover garante alta disponibilidade: quando o servidor RADIUS primário fica indisponível, o tráfego é redirecionado automaticamente para um servidor secundário. O failover é configurado na própria conexão (ver Conexões RADIUS) e acompanhado por esta tela de status.
Como funciona
O failover usa um padrão de circuit breaker:
- Enquanto o primário responde, todo o tráfego segue para ele (estado fechado).
- Se o primário falha repetidamente, o circuit breaker abre e o tráfego passa para o secundário.
- Após o TTL configurado (5–600 s), o sistema tenta voltar ao primário automaticamente.
Badge de estado
Na lista de conexões, cada conexão com failover exibe um badge:
| Estado | Significado |
|---|---|
none | Sem failover configurado |
healthy | Failover ativo; o primário está respondendo |
degraded | O secundário está ativo (primário indisponível) |
override | Há um override manual em vigor |
outage | O circuit breaker disparou (primário fora) |
Tela de status
Abra o menu ⋮ da conexão → Ver Status. A tela mostra:
- Banner de estado — resumo contextual: primário ativo (verde), secundário ativo (vermelho) ou override manual (âmbar).
- Fluxo de tráfego — diagrama indicando qual nó está ativo: Primário ou Secundário.
- Circuit breaker — estado atual (
fechado/normal ouaberto/disparado). - Override — modo de override atual e, se aplicável, o usuário que o definiu.
- Datas — quando o circuit breaker disparou e quando o override foi aplicado.
Override manual
No menu ⋮ da conexão, você pode forçar manualmente o roteamento:
| Ação | O que faz |
|---|---|
| Forçar secundário | Direciona o tráfego para a conexão secundária |
| Forçar primário | Direciona o tráfego de volta para o primário |
| Limpar override | Remove o override e devolve o controle à detecção automática |
| Testar failover | Valida a configuração de failover e retorna sucesso ou falha |
O override manual sobrepõe a detecção automática. Lembre-se de limpar o override depois de uma manutenção para que o sistema volte a alternar os servidores sozinho.
Permissões necessárias
| Ação | Permissão |
|---|---|
| Ver status de failover | radius.view |
| Forçar / limpar override e testar failover | radius.edit |