Ir para o conteúdo

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.

Listagem de grupos com botão Novo 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

  1. Chamada de teste com todos os membros up → cai no membro de menor peso (conferir CDR dst_endpoint).
  2. Derrubar/colocar em manutenção o membro primário → nova chamada deve cair no standby.
  3. 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).