Ir para o conteúdo

Roteiro: Cadastrar e monitorar destinos RTPEngine

Perfil necessário: admin (cadastrar/alterar) | viewer (consulta) Menus usados: Plataforma, Sistema Risco: médio (destino errado/inativo tira a âncora RTP das chamadas novas: sintomas clássicos são áudio unilateral ou mudo) Rollback: voltar o status do destino para o valor anterior e/ou corrigir o socket; se um destino foi criado por engano, excluí-lo pela lixeira da linha. O OpenSIPS lê o socket real de rtpengine_sock no /etc/opensips/opensips.cfg (preservado pelo update_sw.sh), então remover/alterar um registro da tabela não derruba chamadas em curso.

Pré-requisitos

  • [ ] Serviço rtpengine-daemon.service ativo na máquina (systemctl status rtpengine-daemon)
  • [ ] Socket real do RTPEngine conhecido (dev: udp:127.0.0.1:2201)
  • [ ] Perfil admin para criar/editar (viewer só consulta)

Passo a passo

1. Abrir a página RTPEngine

Caminho: Plataforma → Infraestrutura → RTPEngine Clique: [Novo RTPEngine] (somente para cadastrar um destino novo)

Lista de destinos RTPEngine com o botão Novo RTPEngine destacado

A listagem mostra: Socket (endpoint do daemon, ex. udp:127.0.0.1:2201), Set ID (conjunto de balanceamento), Peso, Status e Atualizado (última mutação do registro).

Monitoração (sem clique): esta é a página de triagem quando a chamada tem sinalização OK mas áudio ruim. Confira: - Status = active em todos os destinos de produção (verde). maintenance (amarelo) significa fora do balanceamento intencionalmente; inactive (vermelho) não deve existir em produção. - Atualizado recente indica registro vivo; registro sem atualização + status inconsistente merece inspeção direta no daemon (journalctl -u rtpengine-daemon).

O OpenSIPS ancora o RTP invocando o RTPEngine por rtpengine_sock do CFG — a tabela cataloga/espelha essa topologia; ela não recarrega o módulo OpenSIPS sozinha.

Resultado esperado: destino listado com Status = active.

2. Preencher o dialog Novo RTPEngine

Caminho: Plataforma → Infraestrutura → RTPEngine Clique: [Novo RTPEngine] → botão [Criar] no rodapé do dialog

Dialog Novo RTPEngine aberto

Preencha:

Campo Obrig. Formato/exemplo Efeito
Socket * sim udp:127.0.0.1:2201 Endpoint do daemon RTPEngine no formato proto:host:porta (mesmo valor de rtpengine_sock)
Set ID não (default 1) inteiro ≥ 0 Conjunto de balanceamento usado pela lógica de seleção
Peso não (default 100) inteiro ≥ 0 Peso do destino no balanceamento entre destinos do mesmo set
Status não (default active) active | inactive | maintenance active entra na rotação; maintenance tira da rotação sem apagar; inactive desabilita

Resultado esperado: toast de sucesso e nova linha na tabela com o socket, o set e o status informados; coluna Atualizado mostra a hora corrente.

3. Manutenção de um destino existente

Caminho: Plataforma → Infraestrutura → RTPEngine Clique: ícone Editar (lápis) na linha do destino → ajustar campos → [Salvar]; ou ícone de lixeira para excluir (confirmação Excluir RTPEngine "<socket>"?).

Quando mexer: - RTPEngine instalado/instância nova no host → cadastrar o socket (passo 2). - Daemon em manutenção → status = maintenance (chamadas novas deixam de ancorar nele). - Daemon fora definitivamente → status = inactive ou exclusão do registro. - Sintoma "sem áudio/unilateral" → confira primeiro o status aqui e o daemon no host antes de mexer em qualquer campo.

Resultado esperado: linha atualizada; nenhum destino de produção fora de active sem janela de manutenção.

Validação

  • [ ] Visual: todos os destinos de produção com Tag active (verde) na coluna Status.
  • [ ] Visual: socket listado é exatamente o do serviço (systemctl status rtpengine-daemon + /etc/rtpengine/rtpengine.conf).
  • [ ] Funcional: chamada de teste com áudio bidirecional; no CDR → Fluxo em janela o estágio MEDIA mostra media.offer result=ok e media.answer result=ok (engine=rtpengine).

Erros comuns

Sintoma Causa provável Correção
Chamada conecta sem áudio / 200 OK sem RTP Daemon RTPEngine parado ou socket errado systemctl status rtpengine-daemon; conferir porta 2201; corrigir o campo Socket
Status aparece inactive/maintenance sem janela planejada Alguém tirou o destino da rotação Editar → Status = active → Salvar
RTPEngine sobe mas a chamada não ancora Socket da tabela diferente do rtpengine_sock do CFG instalado Alinhar o campo Socket com o valor real em /etc/opensips/opensips.cfg
Dois destinos no mesmo set com pesos zerados Balanceamento degenerado Definir pesos coerentes (ex. 100/100) ou deixar um único destino
Registro apagado e áudio falha em produção Destino era o único ativo Recriar o registro com o socket correto (passo 2)

Tabela de referência rápida

Tarefa Onde Ação
Ver saúde dos destinos Plataforma → Infraestrutura → RTPEngine ler colunas Status/Atualizado
Cadastrar destino botão [Novo RTPEngine] Socket udp:host:porta, Set ID, Peso, Status
Tirar destino da rotação lápis da linha Status = maintenance
Diagnosticar "sem áudio" esta página + journalctl -u rtpengine-daemon + CDR → Fluxo em janela (estágio MEDIA)