2025 ~ [Site não Oficial] FreePBX Brasil

Imagem gerada por Inteligência Artificial.

O que é o Sngrep?

O Sngrep é um programa que roda no terminal Linux e serve para acompanhar e analisar o que acontece nas chamadas SIP.

Com ele, você pode:
• Visualizar as chamadas que estão acontecendo na sua central telefônica (PBX);
• Ver detalhes técnicos das ligações, como quem ligou para quem, duração, falhas e outros pontos importantes;
• Identificar e resolver problemas, como chamadas que não completam ou sem áudio.
Você também pode usar o Sngrep para gerar arquivos de registro (logs) e enviar para o suporte técnico quando precisar de ajuda.

Como usar?
Para começar, você precisa acessar sua central telefônica (PBX) via SSH.
Para iniciar o aplicativo, utilize o comando:

sngrep -d eth0

Onde eth0 é o adaptador de rede que você está usando para sua central telefônica (PBX) trafegar voz, mas se caso digitar apenas "SNGREP" ele irá capturar trafego de todas as interfaces.

Visualização do Sngrep

A tela principal do aplicativo mostra uma lista de todos os diálogos SIP detectados:

Use as setas ⇑ e ⇓ para navegar entre os diálogos.

Pressione Enter para visualizar detalhes de um diálogo específico.

Informações do Diálogo

Na visualização detalhada, é possível navegar entre os pacotes SIP usando ⇑ e ⇓.

Pressione [Enter] para ver o conteúdo de um pacote SIP específico.

Pressione [ESC] para voltar à tela anterior.

Use a tecla [Espaço] para selecionar múltiplos diálogos SIP e pressione [Enter] para vê-los em uma única tela.

Na tela de detalhes, use [Espaço] para selecionar dois pacotes SIP e compará-los.

Comparação de Pacotes SIP e Salvando o Dump

Pressione a tecla [Espaço] para selecionar o diálogo SIP desejado (Call).

Pressione "s" para abrir a janela de salvamento do dump em arquivo:

Use as setas ⇑ e ⇓ para navegar entre os campos.

Informe o caminho e nome do arquivo.

Selecione a opção Salvar e pressione [Enter].

Faça o download do arquivo utilizando uma conexão com a PBX via SCP e/ou WinSCP são algumas opções.

Observe: Na imagem como destacado na imagem esse PCAP não vai ter RTP(audio de chamada), porque ao iniciar o sngrep não adicionamos o parametro "-r" ou "--rtp" para capturar RTP junto, a seguir o exemplo.

Agora sim, ao salvar o RTP(audio da ligação) será salvo junto com a sinalização.
O comando utilizado foi o abaixo:

sngrep -r

Filtragem de Diálogos SIP

Pressione [F7] para abrir o menu de filtro.

Use as setas ⇑ e ⇓ para navegar pelos campos.

Pressione [Espaço] para selecionar os métodos SIP que deseja analisar.

Selecione a ação Filter e pressione [Enter].

Você também pode explorar os parametros disponíveis no sngrep, é importante para otimizar e melhorar suas capturas.

[root@ipbx]# sngrep --help
Usage: sngrep [-hVcivNqrD] [-IO pcap_dump] [-d dev] [-l limit] [-LH capture_url] [] []

    -h --help            This usage
    -V --version         Version information
    -d --device          Use this capture device instead of default
    -I --input           Read captured data from pcap file
    -O --output          Write captured data to pcap file
    -c --calls           Only display dialogs starting with INVITE
    -r --rtp             Capture RTP packets payload
    -l --limit           Set capture limit to N dialogs
    -i --icase           Make  case insensitive
    -v --invert          Invert 
    -N --no-interface    Don't display sngrep interface, just capture
    -q --quiet           Don't print captured dialogs in no interface mode
    -D --dump-config     Print active configuration settings and exit
    -f --config          Read configuration from file
    -F --no-config       Do not read configuration from default config file
    -R --rotate          Rotate calls when capture limit have been reached
    -H --eep-send        Homer sipcapture url (udp:X.X.X.X:XXXX)
    -L --eep-listen      Listen for encapsulated packets (udp:X.X.X.X:XXXX)

[root@ipbx]#

Conclusão
O Sngrep é uma ferramenta poderosa para monitorar e analisar as chamadas VoIP em sua central PbxIP, assim como identificar e resolver problemas, além de gerar logs detalhados para facilitar a comunicação com o suporte técnico.

Fonte: Анализ трафика средствами Sngrep https://docs.mikopbx.com/mikopbx/faq/troubleshooting/traffic-analysis-using-sngrep

Links relacionados:
Capturando mensagens SIP/WSS (WebRTC) com SNGREP (HEP)
https://neimaravila.medium.com/asterisk-capturando-mensagens-sip-wss-webrtc-com-sngrep-hep-4032b688ef30

Git SNGREP
https://github.com/irontec/sngrep

Instalação do Sngrep para CentOS 7 (RPM)
https://github.com/janduy/install_sngrep_maroto