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.serviceativo 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)

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 = activeem todos os destinos de produção (verde).maintenance(amarelo) significa fora do balanceamento intencionalmente;inactive(vermelho) não deve existir em produção. -Atualizadorecente 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_sockdo 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

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=okemedia.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) |