Tools: Difference between revisions

From VoIPmonitor.org
No edit summary
(Rewrite: konsolidace a vylepšení struktury - zjednodušení IP lookup sekce, přidání tabulek, See Also)
 
(9 intermediate revisions by 3 users not shown)
Line 1: Line 1:
= MTR =
= Tools =
 
MTR shows the trace from VoIPmonitor WEB server to a selected IP address. The output is from the linux mtr tool which runs for 10 seconds and sends 10 packets.
 
[[File:tools-mtr.png]]
 
= IP lookup =
 
An IP lookup table is used to substitute IP addresses in various places, such as CDR view. IP lookup table takes precedence over the DNS. To enable the IP lookup enable database IP reverse lookup is [[Settings]] -> system configuration.
 
[[File:tools-iplookup.png]]
 
= Prefix lookup =
 
The prefix lookup table is used to substitute numbers in various places like CDR view. The prefix lookup table takes precedence over the IP lookup and DNS. To enable IP lookup set ENABLE_SQL_CUSTOMER_PREFIX_LOOKUP to true in config/configuration.php
 
[[File:tools-prefixlookup.png]]
 
= Load pcap =
 
Here you can upload a pcap file captured by any tool using the libpcap format which includes tcpdump, tshark, wireshark, voipmonitor and others. An uploaded pcap file is read by voipmonitor:
voipmonitor --config-file /etc/voipmonitor.conf -r upload.pcap
where /etc/voipmonitor.conf can be changed in Settings -> system configuration -> upload sniffer conf path.
 
= Batch download CDR Wav =
 
This feature allows download WAV files in batch uploading list of calls in CSV file.
 
[[File:tools-batchwav.png]]
 
example CSV file
 
[[File:tools-batchwav-examplecsv.png]]
 
= Concurrent calls stats =
 
this shows maximum (during the whole day) concurrent calls statistics for last 14 days which are averaged by 60 minute window - the algorithm counts the maximum number of concurrent calls (connected) on each minute throughout the whole day and calculates average number of concurrent calls from the last 60 minutes at any given minute. The final number of calls for day is maximum average number of concurrent calls.
This is how the license for GUI is applied. If VoIPmonitor creates CDR for each of CDR leg this graph shows it both. For example if you have 100 calls and each call is seen as carrier -> PBX and PBX -> local phone, here you will see 200 calls. In this case you do not need license for 200 calls but for 100.
 
[[File:tools-concurrentcallsstat.png]]
 
 
 
 
 
 
 
 
 
 


Diagnostic and utility tools available in the VoIPmonitor GUI ('''GUI > Tools''').


== MTR ==


Network path tracing from VoIPmonitor web server to a selected IP address using the Linux <code>mtr</code> tool.


* '''Duration:''' 10 seconds
* '''Packets:''' 10


[[File:tools-mtr.png]]


== IP Lookup ==


Substitutes IP addresses with custom hostnames in CDR views and other displays. Takes precedence over DNS lookups.


'''Enable:''' Settings > System Configuration > "database IP reverse lookup"


{| class="wikitable"
! Mask !! Scope !! Example
|-
| /32 || Single IP only || 192.168.1.100/32 applies to only 192.168.1.100
|-
| /24 || Entire subnet (256 IPs) || 192.168.1.0/24 applies to 192.168.1.0 - 192.168.1.255
|}


{{Note|1=If the same hostname appears for multiple IPs, the entry likely uses a subnet mask (e.g., /24). Change to '''/32''' for per-IP hostnames.}}


[[File:tools-iplookup.png]]


== Prefix Lookup ==


Substitutes phone numbers with custom labels in CDR views. Takes precedence over IP lookup and DNS.


'''Enable:''' Set <code>ENABLE_SQL_CUSTOMER_PREFIX_LOOKUP = true</code> in <code>config/configuration.php</code>


[[File:tools-prefixlookup.png]]


== Load PCAP ==


Upload and process PCAP files (libpcap format from tcpdump, tshark, Wireshark) to create CDRs.


<syntaxhighlight lang="bash">
voipmonitor --config-file /etc/voipmonitor.conf -r upload.pcap
</syntaxhighlight>


'''Config path:''' Settings > System Configuration > "Upload sniffer conf path"


{{Tip|Use this feature for '''pre-deployment verification''' - upload sample traffic (VoLTE, WebRTC, etc.) to confirm VoIPmonitor can parse the protocol before deploying live mirroring.}}


== Batch Download CDR WAV ==


Download multiple audio recordings via CSV upload.


[[File:tools-batchwav.png]]


'''CSV columns:'''
{| class="wikitable"
! Column !! Description
|-
| Telephone || Caller or Called number
|-
| Lead Number || Record identifier (exported with audio/PCAP)
|-
| Start Time || CDR timestamp (second pass uses +/-5 min if no exact match)
|}


[[File:tools-batchwav-examplecsv.png]]


== Generate Debug Log ==


Creates a comprehensive diagnostic package for VoIPmonitor support escalation.


'''Contents:'''
* System info (OS, kernel, CPU, RAM)
* VoIPmonitor configuration
* Performance logs and errors
* Sensor status and capture stats
* Network/storage info


'''How to use:'''
# Navigate to '''Tools > Generate debug log'''
# Enter your email address
# Click '''Generate'''
# Share the received link with support


{{Warning|Use after initial troubleshooting fails. First check [[Settings#Sensor_Health_Monitoring_with_RRD_Charts|Sensor RRD Charts]] and logs.}}


[[File:tools-generatedebuglog.png]]


== Concurrent Calls Stats ==


Displays maximum concurrent connected calls for the last 14 days, averaged over 60-minute windows.


* '''Licensing:''' Counts all CDR legs (100 calls with 2 legs = 200 counted)
* '''Exceeded limit:''' Sniffer continues, but GUI warns/blocks after 14 days


For license details, see [[License]].


[[File:tools-concurrentcallsstat.png]]


== See Also ==


* [[Settings]] - System configuration and sensor management
* [[License]] - Channel licensing and limits
* [[GUI_troubleshooting]] - GUI debug mode and troubleshooting


== AI Summary for RAG ==


'''Summary:''' VoIPmonitor GUI tools documentation covering: MTR (network path tracing from web server), IP Lookup (IP-to-hostname substitution with CIDR masks - /32 for single IP, /24 for subnet), Prefix Lookup (phone number substitution), Load PCAP (upload PCAP files for CDR creation and pre-deployment protocol verification), Batch Download WAV (bulk audio export via CSV), Generate Debug Log (diagnostic package for support), and Concurrent Calls Stats (license monitoring showing max concurrent calls over 14 days).


'''Keywords:''' tools, MTR, IP lookup, network mask, CIDR, /32, /24, hostname substitution, prefix lookup, PCAP upload, pre-deployment verification, batch WAV download, generate debug log, concurrent calls stats, license monitoring, VoLTE, WebRTC


.
'''Key Questions:'''
* What diagnostic tools are available in VoIPmonitor GUI?
* How do I trace network path from VoIPmonitor server?
* How do I substitute IP addresses with hostnames in CDR view?
* Why does the same hostname appear for multiple IPs?
* How do network masks (/32 vs /24) work in IP lookup?
* How do I enable prefix lookup for phone numbers?
* How do I upload PCAP files to VoIPmonitor?
* How can I verify if VoIPmonitor supports a specific protocol before deployment?
* How do I download multiple audio files at once?
* How do I generate a debug log for VoIPmonitor support?
* How do I check concurrent call statistics for licensing?

Latest revision as of 16:47, 8 January 2026

Tools

Diagnostic and utility tools available in the VoIPmonitor GUI (GUI > Tools).

MTR

Network path tracing from VoIPmonitor web server to a selected IP address using the Linux mtr tool.

  • Duration: 10 seconds
  • Packets: 10

IP Lookup

Substitutes IP addresses with custom hostnames in CDR views and other displays. Takes precedence over DNS lookups.

Enable: Settings > System Configuration > "database IP reverse lookup"

Mask Scope Example
/32 Single IP only 192.168.1.100/32 applies to only 192.168.1.100
/24 Entire subnet (256 IPs) 192.168.1.0/24 applies to 192.168.1.0 - 192.168.1.255

ℹ️ Note: If the same hostname appears for multiple IPs, the entry likely uses a subnet mask (e.g., /24). Change to /32 for per-IP hostnames.

Prefix Lookup

Substitutes phone numbers with custom labels in CDR views. Takes precedence over IP lookup and DNS.

Enable: Set ENABLE_SQL_CUSTOMER_PREFIX_LOOKUP = true in config/configuration.php

Load PCAP

Upload and process PCAP files (libpcap format from tcpdump, tshark, Wireshark) to create CDRs. 

voipmonitor --config-file /etc/voipmonitor.conf -r upload.pcap

Config path: Settings > System Configuration > "Upload sniffer conf path"

💡 Tip: Use this feature for pre-deployment verification - upload sample traffic (VoLTE, WebRTC, etc.) to confirm VoIPmonitor can parse the protocol before deploying live mirroring.

Batch Download CDR WAV

Download multiple audio recordings via CSV upload.

CSV columns:

Column Description
Telephone Caller or Called number
Lead Number Record identifier (exported with audio/PCAP)
Start Time CDR timestamp (second pass uses +/-5 min if no exact match)

Generate Debug Log

Creates a comprehensive diagnostic package for VoIPmonitor support escalation.

Contents:

  • System info (OS, kernel, CPU, RAM)
  • VoIPmonitor configuration
  • Performance logs and errors
  • Sensor status and capture stats
  • Network/storage info

How to use:

  1. Navigate to Tools > Generate debug log
  2. Enter your email address
  3. Click Generate
  4. Share the received link with support

⚠️ Warning: Use after initial troubleshooting fails. First check Sensor RRD Charts and logs.

File:Tools-generatedebuglog.png

Concurrent Calls Stats

Displays maximum concurrent connected calls for the last 14 days, averaged over 60-minute windows.

  • Licensing: Counts all CDR legs (100 calls with 2 legs = 200 counted)
  • Exceeded limit: Sniffer continues, but GUI warns/blocks after 14 days

For license details, see License.

See Also

AI Summary for RAG

Summary: VoIPmonitor GUI tools documentation covering: MTR (network path tracing from web server), IP Lookup (IP-to-hostname substitution with CIDR masks - /32 for single IP, /24 for subnet), Prefix Lookup (phone number substitution), Load PCAP (upload PCAP files for CDR creation and pre-deployment protocol verification), Batch Download WAV (bulk audio export via CSV), Generate Debug Log (diagnostic package for support), and Concurrent Calls Stats (license monitoring showing max concurrent calls over 14 days).

Keywords: tools, MTR, IP lookup, network mask, CIDR, /32, /24, hostname substitution, prefix lookup, PCAP upload, pre-deployment verification, batch WAV download, generate debug log, concurrent calls stats, license monitoring, VoLTE, WebRTC

Key Questions:

  • What diagnostic tools are available in VoIPmonitor GUI?
  • How do I trace network path from VoIPmonitor server?
  • How do I substitute IP addresses with hostnames in CDR view?
  • Why does the same hostname appear for multiple IPs?
  • How do network masks (/32 vs /24) work in IP lookup?
  • How do I enable prefix lookup for phone numbers?
  • How do I upload PCAP files to VoIPmonitor?
  • How can I verify if VoIPmonitor supports a specific protocol before deployment?
  • How do I download multiple audio files at once?
  • How do I generate a debug log for VoIPmonitor support?
  • How do I check concurrent call statistics for licensing?
Retrieved from "https://www.voipmonitor.org/doc/index.php?title=Tools&oldid=10018"