Skip to main content

Webinar Nov 19: The Next Gen PBX Alternative. APAC 3 PM AEDT · Americas 11 AM ET

Register
RingQ Customer Centric Communications

Troubleshooting Tools


Introduction

RingQ provides a comprehensive set of built-in troubleshooting tools designed to help partners and customers efficiently identify, diagnose, and resolve issues. This guide provides an overview of the diagnostic tools available within the RingQ platform and how they can assist in troubleshooting.

To access these tools, log in to your RingQ Web App and navigate to Settings > Global.

Call Activity Monitoring

RingQ provides full visibility into both inbound and outbound calls.

  • Inbound Rules: Track how calls are routed into the system, including DID mapping and IVR handling.
  • Outbound Rules: Monitor outbound dialing paths, gateway usage, and prefix rules.
  • Call Logs: Provide timestamps, caller/callee information, status codes, and duration.

Use Case: Check whether a customer’s outbound call is correctly routed through the assigned trunk.

Network & SIP Diagnostics

For advanced troubleshooting, RingQ integrates packet capture and SIP analysis tools:

  • Capture/Wireshark Integration: Record traffic directly from the system interface.
  • SIP Activity: Review full SIP messaging, including INVITE, REGISTER, and BYE transactions.

Use Case: Identify registration failures or one-way audio by analyzing SIP signaling and RTP flow.

Call Flow Reports

The end-of-call report offers unique insights into specific calls:

  • Displays a visual call flow with all legs (inbound, outbound, trunk).
  • Includes trunk information, codec details, and disconnection cause.
  • Provides handshake details for debugging call setup and teardown.

Use Case: Quickly determine why a call dropped (e.g., SIP error 486 Busy Here or 503 Service Unavailable).

Web UI Terminal

RingQ includes a web-based terminal for system-level diagnostics without requiring SSH access. Supported commands include:

Basic Linux Commands

  • clear, ls, cd, ip, ping, traceroute, df, date, ps, nslookup, free, netstat

Package & System Management

  • dpkg-query — check installed packages
  • reboot — restart the system

FreeSWITCH Control Commands

  • fs_cli -x "reloadxml" — reload dialplan and configuration
  • fs_cli -x "sofia profile external restart" — restart external SIP profile
  • fs_cli -x "sofia profile internal restart" — restart internal SIP profile

Use Case: Run ping or traceroute from the Web UI to check connectivity with the SIP provider.

Summary

With these tools, RingQ enables partners and customers to:

  • Monitor and verify call activity.
  • Perform in-depth SIP and network troubleshooting.
  • Review detailed call flow reports for root cause analysis.
  • Execute system commands securely via the Web UI terminal.

This end-to-end troubleshooting suite reduces downtime, minimizes dependency on external tools, and accelerates resolution for all users.