Ir para o conteúdo

Roteiro: Criar/editar grupo de endpoints e associar membros

Perfil necessário: admin Menus usados: Roteamento, Plataforma Risco: médio (o grupo alimenta o dispatcher do OpenSIPS; peso/prioridade errados mudam para onde as chamadas saem) Rollback: remover o membro ou excluir o grupo; sincronizar e recarregar OpenSIPS

Pré-requisitos

  • [ ] Endpoints já cadastrados (Roteamento → Endpoints) para associação
  • [ ] Definição de carga: quantos endpoints ativos em paralelo, pesos iguais ou diferentes, prioridades

Passo a passo

1. Criar o grupo

Caminho: Roteamento → Grupos Clique: [Novo Grupo] (toolbar da listagem)

Listagem de grupos com botão Novo Grupo destacado

Preencha:

Campo Obrig. Formato/exemplo Efeito
Nome sim clientes-voip-sp identificador do grupo (usado pelo dispatcher)
Descrição não texto livre propósito do grupo
Canais não inteiro ≥ 0 teto de canais do grupo (0 = sem limite)
CPS não inteiro ≥ 0 teto de chamadas por segundo do grupo

Clique: [Criar] (footer do dialog)

Dialog Novo Grupo com botão Criar destacado

Resultado esperado: dialog fecha, toast "Criado", grupo na listagem com Canais/CPS e coluna Membros com botão [Ver].

Para editar um grupo existente: ícone de lápis na linha (tooltip Editar) abre o mesmo dialog com título Editar Grupo; o botão do footer vira [Salvar].

2. Abrir os membros do grupo

Clique: [Ver] na coluna Membros da linha do grupo

Listagem de grupos com botão Ver destacado na coluna Membros

Resultado esperado: dialog Membros: <nome do grupo> com tabela Endpoint / Peso / Prioridade / Atualizado / Ações.

3. Associar endpoints ao grupo

Na barra superior do dialog de membros:

Preencha:

Campo Obrig. Formato/exemplo Efeito
Seletor de endpoints (MultiSelect) sim chips com nome do endpoint endpoints a adicionar; opções marcadas Já no grupo aparecem desabilitadas
Peso não inteiro ≥ 0 (default 100) distribuição de carga entre membros de mesma prioridade
Prio não inteiro ≥ 0 (default 0) menor prioridade é tentado primeiro; seguinte só em failover

Clique: [+] (botão com ícone de adicionar à direita do Prio)

Dialog de membros com MultiSelect, Peso, Prio e botão de adicionar destacados

Resultado esperado: toast "1 membro adicionado" (ou "N membros adicionados"); membro na tabela com peso/prioridade aplicados. Seleção é limpa após adicionar. Endpoints já presentes geram aviso "N endpoint(s) não foram adicionados" sem interromper os demais.

4. Remover um membro (quando necessário)

Clique: ícone de lixeira na linha do membro (tooltip Excluir)

Resultado esperado: toast "Removido"; membro some da tabela e volta a aparecer como Disponível no MultiSelect.

5. Sincronizar e recarregar OpenSIPS

O backend re-sincroniza o dispatcher a cada mudança de membro, mas o reload de memória é explícito:

Caminho: Plataforma → Sistema → OpenSIPS (Reload) Clique: [Recarregar todos os módulos] — cobre dispatcher (ds_reload) e address

Página de reload com botão Recarregar todos os módulos destacado

Resultado esperado: mensagem de sucesso por módulo; ds_list no MI reflete os destinos do grupo.

Validação

  • [ ] Visual: grupo na listagem; dialog Membros lista os endpoints com peso/prioridade corretos
  • [ ] Funcional: opensips-cli -x mi ds_list mostra os destinos do grupo na ordem de prioridade
  • [ ] Falha proposital: derrubar o endpoint de maior prioridade e conferir que o tráfego cai para o próximo (failover)

Erros comuns

Sintoma Causa provável Correção
Opção do endpoint desabilitada no MultiSelect endpoint já é membro do grupo remover o membro antes de re-adicionar
Toast "N endpoints não foram adicionados" parte da seleção já estava no grupo conferir a tabela de membros; os demais foram adicionados
Tráfego não passa pelo novo membro dispatcher não recarregado executar reload (passo 5)
Peso/prioridade não mudam comportamento membros em prioridades diferentes: peso só vale dentro da mesma prioridade ajustar prio/weight coerentes com o desenho de carga
Grupo excluído mas destinos ainda ativos reload pendente após exclusão sincronizar e recarregar dispatcher

Impacto operacional

  • Canais/CPS do grupo são tetos agregados; somam-se aos limites por linha/endpoint — não duplique proteção sem revisar.
  • Prioridade é failover, peso é carga simultânea. Peso igual + prioridades distintas = ativo/passivo.
  • Toda mudança de membros muda o destino das chamadas em produção; mude em janela e confirme com chamada de teste.