Roteiro: Grupos de endpoints no roteamento (failover e peso)¶
Perfil necessário: admin Menus usados: Roteamento (Grupos), Sistema (OpenSIPS Reload) Risco: médio (grupo errado no roteamento desvia tráfego para destino errado) Rollback: remover membro do grupo / restaurar pesos; reload dispatcher
Conceito¶
Grupo de endpoints = conjunto com peso por membro. O peso define prioridade de failover: menor peso = preferido; quando falha, o tráfego cai para o próximo peso.
Passo a passo¶
1. Criar/editar grupo¶
Roteamento → Grupos → [Novo Grupo]: Nome/Descrição, Canais/CPS do grupo.

2. Associar membros com pesos¶
Editar grupo → dialog Membros (MultiSelect). Para cada membro: Peso (default 100) e Prio (default 0).
| Campo | Default | Efeito |
|---|---|---|
| Peso | 100 | menor peso = preferido no failover |
| Prio | 0 | desempate dentro do mesmo peso |
Estratégia típica de SBC: - Membro primário: peso 100 - Membro standby: peso 200 (assume quando o primário falha)
3. Recarregar¶
Sistema → OpenSIPS → [Recarregar todos os módulos] (dispatcher).
4. Validar failover¶
- Chamada de teste com todos os membros up → cai no membro de menor peso (conferir CDR
dst_endpoint). - Derrubar/colocar em manutenção o membro primário → nova chamada deve cair no standby.
- Restaurar primário → tráfego volta ao primário.
Erros comuns¶
| Sintoma | Causa probável | Correção |
|---|---|---|
| Tráfego não cai no standby | peso do standby igual/maior prioridade | ajustar pesos |
| Balanceamento estranho | pesos conflitantes entre membros | revisar peso/prio de todos |
| Alteração não aplica | reload pendente | Recarregar módulos |
Impacto operacional¶
- Peso é contrato de failover: documente a topologia desejada (primário/standby) no runbook da planta.
- Grupo sem membro ativo = blackhole: monitore dispatcher (status/probing).