Difference between revisions of "Call Info"

From Kolmisoft Wiki
Jump to navigationJump to search
 
(34 intermediate revisions by 7 users not shown)
Line 1: Line 1:
This window gives detailed info about the call.
This window gives detailed info about the call.
__TOC__


It can be accessed from Last Calls page by clicking on the icon [[Image:icon_callinfo.png]] near the call:
It can be accessed from Last Calls page by clicking on the icon [[Image:icon_callinfo.png]] near the call:
Line 8: Line 10:
A new window opens with detailed call info:
A new window opens with detailed call info:


[[Image:callinfo2.png]]
[[Image:call_info_details_4.png]]


<br><br>
<br><br>
= Call Log =
= Call Log =
<!---This functionality is available from MOR 9--->
This feature is useful for troubleshooting Calls. It shows Asterisk Log for specific Call and highlights errors and warnings.<br>
<br><br>
'''Note:''' Asterisk logs are deleted after 14 days so old Calls may not have log available.<br>
[[Image:call_log.png]]
'''Note:''' This functionality is only available for the System Admin and Accountats with a '''Call Tracing Usage''' Read permission (by enabling this permission Accountants are allowed to see financial and Provider information present in Call Log)<br>
<br><br>
[[Image:mor_call_log_2.png]]
 
= PCAP file/data =
= PCAP file/data =


Line 22: Line 25:
Press on the Download PCAP file button and if you have Wireshark installed - it will open the pcap file in the Wireshark.
Press on the Download PCAP file button and if you have Wireshark installed - it will open the pcap file in the Wireshark.


NOTE: pcap file takes up to 10kb of data. By default it is reserved 1Gb of HDD space for pcap files. Approximately it is enough for 100.000 calls. Older files are deleted when space limit is reached. HDD space limit can be increased if necessary.


Limitations:


'''Only SIP calls can be retrieved'''<br>
'''Note:''' pcap file takes up to 10kb of data. By default it is reserved 1Gb of HDD space for pcap files. Approximately it is enough for 100.000 calls. Older files are deleted when space limit is reached. HDD space limit can be increased if necessary.<br>
'''Only UDP protocol is supported'''
'''Note:''' This functionality is only available for the System Admin and Accountats with a '''Call Tracing Usage''' Read permission (by enabling this permission Accountants are allowed to see Provider information present in PCAP files)<br>
 
 
===Limitations:===
 
* '''Only SIP calls can be retrieved'''<br>
* '''Only UDP protocol is supported'''
* Only calls sent/received to/from Providers are captured
* Sometimes PCAP file does not appear - please create Support Ticket (TT) in such case. [http://wiki.kolmisoft.com/index.php/PCAP_file_cannot_be_retrieved  More info]


<br>
<br>
[[File:mor_pcap.png]]
[[File:mor_pcap.png]]
<br><br>


== QUESTION: How pcap files are managed to not fill HDD? ==
== QUESTION: How pcap files are managed to not fill HDD? ==
Line 36: Line 47:
Special script runs at set intervals to delete the oldest files. 1Gb HDD space is reserved by default for pcap files.
Special script runs at set intervals to delete the oldest files. 1Gb HDD space is reserved by default for pcap files.


If you want to change this value, edit /etc/mor/system.conf file.
In file you will see column:
  # pcap settings
  pcap_enabled=1
  # how much MB to reserve for pcap files
  # default 1000
  '''pcap_hdd_reserved_space=1000'''
Change 1000 to your preferred value, for example, 5000 and save file. After this pcap hdd reserved space will become 5gb.
<br><br>
== Implementation details ==
Pcap files are captured using pcapsipdump program and captured files are stored in /var/log/mor directory. Pcapsipdump process in ps output look like this:
  /usr/src/mor/x7/scripts/pcapsipdump -U -i em1 -d /var/log/mor/pcap -v 1 -B 256MiB -R none


<br><br>
<br><br>
Line 41: Line 70:
= See also =
= See also =
* [[SIP debug info]]
* [[SIP debug info]]
* [[Accountant_permissions]]
* [[PCAP does not show LegB of a call]]

Latest revision as of 08:40, 6 December 2022

This window gives detailed info about the call.

It can be accessed from Last Calls page by clicking on the icon Icon callinfo.png near the call:

Callinfo1.png


A new window opens with detailed call info:

Call info details 4.png



Call Log

This feature is useful for troubleshooting Calls. It shows Asterisk Log for specific Call and highlights errors and warnings.
Note: Asterisk logs are deleted after 14 days so old Calls may not have log available.
Note: This functionality is only available for the System Admin and Accountats with a Call Tracing Usage Read permission (by enabling this permission Accountants are allowed to see financial and Provider information present in Call Log)
Mor call log 2.png

PCAP file/data

Background process records pcap files for every call. Later it is very easy to retrieve pcap file for exact call from Call Info page.

Press on the Download PCAP file button and if you have Wireshark installed - it will open the pcap file in the Wireshark.


Note: pcap file takes up to 10kb of data. By default it is reserved 1Gb of HDD space for pcap files. Approximately it is enough for 100.000 calls. Older files are deleted when space limit is reached. HDD space limit can be increased if necessary.
Note: This functionality is only available for the System Admin and Accountats with a Call Tracing Usage Read permission (by enabling this permission Accountants are allowed to see Provider information present in PCAP files)


Limitations:

  • Only SIP calls can be retrieved
  • Only UDP protocol is supported
  • Only calls sent/received to/from Providers are captured
  • Sometimes PCAP file does not appear - please create Support Ticket (TT) in such case. More info


Mor pcap.png



QUESTION: How pcap files are managed to not fill HDD?

Special script runs at set intervals to delete the oldest files. 1Gb HDD space is reserved by default for pcap files.

If you want to change this value, edit /etc/mor/system.conf file. In file you will see column:

 # pcap settings
 pcap_enabled=1
 # how much MB to reserve for pcap files
 # default 1000
 pcap_hdd_reserved_space=1000

Change 1000 to your preferred value, for example, 5000 and save file. After this pcap hdd reserved space will become 5gb.




Implementation details

Pcap files are captured using pcapsipdump program and captured files are stored in /var/log/mor directory. Pcapsipdump process in ps output look like this:

 /usr/src/mor/x7/scripts/pcapsipdump -U -i em1 -d /var/log/mor/pcap -v 1 -B 256MiB -R none



See also