Difference between revisions of "Support tools"

From help.aarenet.com
Jump to: navigation, search
 
(7 intermediate revisions by 2 users not shown)
Line 1: Line 1:
−
{{DISPLAYTITLE: Aarenet VoIP Switch Support Tools }}
+
{{DISPLAYTITLE: Manual of the Aarenet VoIP Switch Support Tools }}
 
{{PAGE_HEADER}}
 
{{PAGE_HEADER}}
−
{{Page_Help_Links | links=5 | width1=225 | width2=225 | width3=225 | width4=225 | width5=100
+
{{Page_Menu_List_Help_Support}}
−
| link1={{NAMESPACE}}:help_support | descr1=Main Support Help
+
<!-- FOOTER LEFT "© Aarenet AG 2017" --> <!-- PDF Creation Directive ------------------------------>
−
| link2=nolink
 
−
| link3=nolink
 
−
| link4=pdfarticle
 
−
| link5=nolink
 
−
}}
 
−
<!-- Transclusion : Article Begin -----------------------------------------------------------------><section begin=article />
 
  
  
 +
{{Page_Introduction_Title}}
 
<!-- Transclusion : Intro  Begin ------------------------------------------------------------------><section begin=intro />
 
<!-- Transclusion : Intro  Begin ------------------------------------------------------------------><section begin=intro />
 
The VoIP Switch Administrators, Operators, Supporters find here information about the Aarenet VoIP Switch "On Board" tools for analyzing and supporting general VoIP Switch issues and customer problems:
 
The VoIP Switch Administrators, Operators, Supporters find here information about the Aarenet VoIP Switch "On Board" tools for analyzing and supporting general VoIP Switch issues and customer problems:
  
−
:* The ConfigCenter '''Support Log''' displays the VoIP Switch internal activities
+
:* The ConfigCenter "Support Log" displays the VoIP Switch internal activities
−
:* The ConfigCenter '''Traces''' displays the signaling between the VoIP Switch an external devices
+
:* The ConfigCenter "Traces" displays the signaling between the VoIP Switch an external devices
−
:* The ConfigCenter '''Call Data''' lists the CDR of all incoming or outgoing connections or connection attempts
+
:* The ConfigCenter "Call Data" lists the CDR of all incoming or outgoing connections or connection attempts. The "Call Data" provide shortcuts to SIP, SDP trace and RTP statistic information of a single call.
−
:* The ConfigCenter '''Address Registration''' displays if a SIP device or MGCP MTA has registered a telephone number
+
:* The ConfigCenter "Address Registration" displays if a SIP device or MGCP MTA has registered a telephone number
−
:* The ConfigCenter '''System Components''' displays the state and activity of the VoIP Switch components
+
:* The ConfigCenter "System Components" displays the state and activity of the VoIP Switch components
−
:* The ConfigCenter '''Channels''' displays the state of connections
+
:* The ConfigCenter "Channels" displays the state of connections
−
:* The ConfigCenter '''System Utilization''' displays a statistical overview of the VoIP Switch resource utilization
+
:* The ConfigCenter "System Utilization" displays a statistical overview of the VoIP Switch resource utilization
 
<!-- Transclusion : Intro  End --------------------------------------------------------------------><section end=intro />
 
<!-- Transclusion : Intro  End --------------------------------------------------------------------><section end=intro />
  
  
 
__TOC__ <!-- Table of Contents -------------------------------------------------------------------->
 
__TOC__ <!-- Table of Contents -------------------------------------------------------------------->
−
<!-- PAGE BREAK --> <!-- PDF Creation Directive --------------------------------------------------->
 
  
  
 +
<!-- PAGE BREAK --> <!-- PDF Creation Directive --------------------------------------------------->
 +
<!-- Transclusion : Article Begin -----------------------------------------------------------------><section begin=article />
 
{{ToTop | SupportToolConfigCenter }} <!------------------------------------------------------------>
 
{{ToTop | SupportToolConfigCenter }} <!------------------------------------------------------------>
 
= VoIP Switch ConfigCenter Support Tools =
 
= VoIP Switch ConfigCenter Support Tools =
Line 33: Line 29:
  
 
{{ToTop | SupportToolConfigCenterSupportLog }} <!-------------------------------------------------->
 
{{ToTop | SupportToolConfigCenterSupportLog }} <!-------------------------------------------------->
−
== The ConfigCenter '''Support Log''' {{Help_Status |  | &nbsp }} ==
+
== The ConfigCenter '''Support Log''' ==
  
−
The '''Support Log''' provides the supporter with information from the internal processes of the ServiceCenter:
+
The "Support Log" provides the supporter with information from the internal processes of the ServiceCenter:
 
:* Registration
 
:* Registration
 
:* Connection setup, release and exceptions
 
:* Connection setup, release and exceptions
Line 44: Line 40:
  
  
−
The '''Support Log''' provides filters for:
+
The "Support Log" provides filters for:
 
:* Time based selection: From – Until, From – Duration
 
:* Time based selection: From – Until, From – Duration
 
:* Text filter
 
:* Text filter
Line 52: Line 48:
  
  
−
The '''Support Log''' has a limited history. The history may last from a few hours up to some days. The length of the history may be different from VoIP switch to VoIP switch and depends on the length of log files and amount of logging events.
+
The "Support Log" has a limited history. The history may last from a few hours up to some days. The length of the history may be different from VoIP switch to VoIP switch and depends on the length of log files and amount of logging events.
  
  
 
{{Note|
 
{{Note|
−
The '''Support Log''' is tenant sensitive. This means a supporter of tenant A is not able to see events of tenant B!}}
+
The "Support Log" is tenant sensitive. This means a supporter of tenant A is not able to see events of tenant B!
 +
}}
  
  
Line 62: Line 59:
  
 
{{ToTop}} <!--------------------------------------------------------------------------------------->
 
{{ToTop}} <!--------------------------------------------------------------------------------------->
−
=== Navigate to the '''Support Log''' {{Help_Status |  | &nbsp }} ===
+
=== Navigate to the "Support Log" ===
  
 
ConfigCenter:
 
ConfigCenter:
Line 72: Line 69:
  
 
{{ToTop}} <!--------------------------------------------------------------------------------------->
 
{{ToTop}} <!--------------------------------------------------------------------------------------->
−
=== Get a '''Support Log''' {{Help_Status |  | &nbsp }} ===
+
=== Get a "Support Log" ===
  
 
Dialog: "Support Log":
 
Dialog: "Support Log":
−
[[file: support_support_log_dialog.gif |frameless|link=|500px|left| Dialog: "Support Log" ]]
+
[[file:support_support_log_dialog.png |500px|left|frameless|link=| Dialog: Support Log ]]
−
<br style="clear:both">
+
<br clear=all>
  
  
Line 87: Line 84:
 
:# Insert the in "From" the desired start date/time
 
:# Insert the in "From" the desired start date/time
 
:# Insert in "Duration" the needed length
 
:# Insert in "Duration" the needed length
−
:# Press on the keyboard the[ Enter ] key: The "Until" date/time will be computed
+
:# Press on the PC keyboard the 'Enter' key : The "Until" date/time will be computed
 
:# Click the {{Dialog_Button | Download}}
 
:# Click the {{Dialog_Button | Download}}
  
Line 94: Line 91:
 
:# Insert the in "From" the desired start date/time
 
:# Insert the in "From" the desired start date/time
 
:# Insert the in "Until" the desired stop date/time
 
:# Insert the in "Until" the desired stop date/time
−
:# Press on the keyboard the[ Enter ] key: The "Duration" will be computed
+
:# Press on the PC keyboard the 'Enter' key: The "Duration" will be computed
 
:# Click the {{Dialog_Button | Download}}
 
:# Click the {{Dialog_Button | Download}}
  
Line 116: Line 113:
  
 
{{ToTop}} <!--------------------------------------------------------------------------------------->
 
{{ToTop}} <!--------------------------------------------------------------------------------------->
−
=== Interpretation of a '''Support Log''' {{Help_Status |  | &nbsp }} ===
+
=== Interpretation of a "Support Log" ===
  
−
The interpretation of a "Support Log" is quite easy and straight forward. With a little experience one will be fast familiar with the interpretation.
+
The interpretation of a "Support Log" is quite easy and straight forward. With a little experience one will be soon familiar with the interpretation.
  
 
Interpretation and example of a call setup and release:
 
Interpretation and example of a call setup and release:
−
[[file: support_support_log_example.gif |frameless|link=|700px|left| Example "Support Log"]]
+
[[file:support_support_log_example.png |700px|left|frameless|link=| Example Support Log]]
−
<br style="clear:both">
+
<br clear=all>
  
  
Line 128: Line 125:
  
 
{{ToTop | SupportToolConfigCenterTrace }} <!------------------------------------------------------->
 
{{ToTop | SupportToolConfigCenterTrace }} <!------------------------------------------------------->
−
== ConfigCenter '''Trace''' {{Help_Status |  | &nbsp }} ==
+
== ConfigCenter '''Trace''' ==
  
−
The '''Trace''' provides the supporter with information from the message traffic between the VoIP switch and external VoIP devices, such as PSTN gateway, SIP CPE, SIP or MGCP telephones.
+
The "Trace" provides the supporter with information from the message traffic between the VoIP switch and external VoIP devices, such as PSTN gateway, SIP CPE, SIP or MGCP telephones.
  
−
The '''Trace''' contains:
+
The "Trace" contains:
 
:* Session Initiation Protocol SIP registration and connection signaling messages
 
:* Session Initiation Protocol SIP registration and connection signaling messages
 
:* Media Gateway Control Protocol MGCP audit and endpoint control messages
 
:* Media Gateway Control Protocol MGCP audit and endpoint control messages
Line 138: Line 135:
  
  
−
The '''Trace''' provides filters for:
+
The "Trace" provides filters for:
 
:* Time based selection: From – Until, From – Duration
 
:* Time based selection: From – Until, From – Duration
 
:* Text filter
 
:* Text filter
  
  
−
The '''Trace''' has a limited history. The history may last from a few hours up to some days. The length of the history may be different from VoIP switch to VoIP switch and depends on the length of log files and amount of logging events.
+
The "Trace" has a limited history. The history may last from a few hours up to some days. The length of the history may be different from VoIP switch to VoIP switch and depends on the length of log files and amount of logging events.
  
  
−
The interpretation of a '''Trace''' (PCAP formatted file) has to be done in an external application like [http://www.wireshark.org Wireshark network protocol analyzer]. Wireshark offers deep and rich VoIP analysis.
+
The interpretation of a "Trace" (PCAP formatted file) has to be done in an external application like [http://www.wireshark.org Wireshark network protocol analyzer]. Wireshark offers deep and rich [[{{NAMESPACE}}:support_voip_protocol | VoIP analysis ]].
  
  
 
{{Note|
 
{{Note|
−
The '''Trace''' is '''not''' tenant sensitive. This means a supporter of tenant A is able to see signaling messages of tenant B!
+
The "Trace" is '''not''' tenant sensitive. This means a supporter of tenant A is able to see signaling messages of tenant B!
  
−
&rarr; Due to this open display of information it may be possible that the '''Trace''' is not available for the supporters on a multi tenant VoIP Switch.}}
+
Due to this open display of information it may be possible that the "Trace" is not available for the supporters and operators on a multi tenant VoIP Switch.
 +
}}
  
  
Line 158: Line 156:
  
 
{{ToTop}} <!--------------------------------------------------------------------------------------->
 
{{ToTop}} <!--------------------------------------------------------------------------------------->
−
=== Navigate to the '''Trace''' ===
+
=== Navigate to the "Trace" ===
  
 
ConfigCenter:
 
ConfigCenter:
Line 168: Line 166:
  
 
{{ToTop}} <!--------------------------------------------------------------------------------------->
 
{{ToTop}} <!--------------------------------------------------------------------------------------->
−
=== Get a '''Trace''' ===
+
=== Get a "Trace" ===
  
 
Dialog: "Trace":
 
Dialog: "Trace":
−
[[file: support_trace_dialog.gif |frameless|link=|500px|left| Dialog: "Trace" ]]
+
[[file:support_trace_dialog.png |500px|left|frameless|link=| Dialog: Trace ]]
−
<br style="clear:both">
+
<br clear=all>
  
  
Line 183: Line 181:
 
:# Insert the in "From" the desired start date/time
 
:# Insert the in "From" the desired start date/time
 
:# Insert in "Duration" the needed length
 
:# Insert in "Duration" the needed length
−
:# Press on the keyboard the[ Enter ] key: The "Until" date/time will be computed
+
:# Press on the PC keyboard the 'Enter' key: The "Until" date/time will be computed
 
:# Click the {{Dialog_Button | Download}}
 
:# Click the {{Dialog_Button | Download}}
  
Line 190: Line 188:
 
:# Insert the in "From" the desired start date/time
 
:# Insert the in "From" the desired start date/time
 
:# Insert the in "Until" the desired stop date/time
 
:# Insert the in "Until" the desired stop date/time
−
:# Press on the keyboard the[ Enter ] key: The "Duration" will be computed
+
:# Press on the PC keyboard the 'Enter' key: The "Duration" will be computed
 
:# Click the {{Dialog_Button | Download}}
 
:# Click the {{Dialog_Button | Download}}
  
Line 210: Line 208:
  
 
{{ToTop}} <!--------------------------------------------------------------------------------------->
 
{{ToTop}} <!--------------------------------------------------------------------------------------->
−
=== Interpretation of a '''Trace''' ===
+
=== Interpretation of a "Trace" ===
  
 
The interpretation of a "Trace" needs experience!
 
The interpretation of a "Trace" needs experience!
  
 
For more information:
 
For more information:
−
:* See [[{{NAMESPACE}}:support_voip_protocol#SupportSipKnowhow | SIP Knowhow ]]
+
:* See also article [[{{NAMESPACE}}:support_voip_protocol#SupportSipKnowhow | "Brief Tutorial of the SIP Signaling and SDP Media Protocols" ]]
 
:* Get a [http://www.wireshark.org/#learnWS Wireshark training]
 
:* Get a [http://www.wireshark.org/#learnWS Wireshark training]
  
  
 
Example of a Wireshark call capture, SIP setup and release:
 
Example of a Wireshark call capture, SIP setup and release:
−
[[file: support_trace_example.gif |frameless|link=|700px|left| Example "Trace" ]]
+
[[file:support_trace_example.png |700px|left|frameless|link=| Example "Trace" ]]
−
<br style="clear:both">
+
<br clear=all>
  
  
 
Example of a Wireshark call list:<br>
 
Example of a Wireshark call list:<br>
 +
 
Navigate in Wireshark:
 
Navigate in Wireshark:
 
{{Navigation_List | 1 | Menu "Statistics" }}
 
{{Navigation_List | 1 | Menu "Statistics" }}
 
{{Navigation_List | 2 | Menu "VoIP Calls" }}
 
{{Navigation_List | 2 | Menu "VoIP Calls" }}
−
[[file:support_trace_voip_call_list.gif |frameless|link=|700px|left| Example Trace VoIP Call List ]]
+
 
−
<br style="clear:both">
+
 
 +
Wireshark dialog where all calls are listed of the actual trace:
 +
[[file:support_trace_voip_call_list.png |700px|left|frameless|link=| Example Trace VoIP Call List ]]
 +
<br clear=all>
  
  
 
Example of a Wireshark call flow:<br>
 
Example of a Wireshark call flow:<br>
 +
 +
 
Navigate in Wireshark:
 
Navigate in Wireshark:
 
{{Navigation_List | 1 | Menu "Statistics" }}
 
{{Navigation_List | 1 | Menu "Statistics" }}
 
{{Navigation_List | 2 | Menu "VoIP Calls" }}
 
{{Navigation_List | 2 | Menu "VoIP Calls" }}
 
{{Navigation_List | 3 | Select the call of interest }}
 
{{Navigation_List | 3 | Select the call of interest }}
−
{{Navigation_List | 4 | Click button [ Graph ] }}
+
{{Navigation_List | 4 | Click {{Dialog_Button | Graph }} }}
−
[[file:support_trace_voip_call_flow.gif |frameless|link=|575px|left| Example Trace VoIP Call Flow ]]
+
 
−
<br style="clear:both">
+
 
 +
Wireshark dialog where the message flow is shown of the selected call:
 +
[[file:support_trace_voip_call_flow.png |575px|left|frameless|link=| Example Trace VoIP Call Flow ]]
 +
<br clear=all>
  
  
Line 245: Line 252:
  
 
{{ToTop | SupportToolConfigCenterCallData }} <!---------------------------------------------------->
 
{{ToTop | SupportToolConfigCenterCallData }} <!---------------------------------------------------->
−
== The ConfigCenter '''Call Data''' {{Help_Status |  | inwork }} ==
+
== The ConfigCenter '''Call Data''' ==
  
−
The "Call Data" lists the CDR of all incoming or outgoing connections or connection attempts. Extended filters enable the supporter to search for specific calls.
+
The "Call Data" lists the CDR of all incoming or outgoing connections or connection attempts. Extended filters enable the supporter to search for specific calls. The filters can be combined with logical AND.<br>
  
 +
Filter CDRs according:
 +
:* Call start and end date/time
 +
:* Call duration
 +
:* Call charges
 +
:* Telephone number of caller and/or  callee.
 +
:* Tenants & account
 +
:* Price list attributes "Destination Type" & "Destination"
  
 
The "Call Data" has a limited history. The length of the history may be different from VoIP switch to VoIP switch and depends on the CDR storage length in the date base.
 
The "Call Data" has a limited history. The length of the history may be different from VoIP switch to VoIP switch and depends on the CDR storage length in the date base.
 +
 +
 +
Selected CDR details allow direct access to the information of:
 +
:* SIP Trace:
 +
:: The SIP message contents of this specific connection or call attempt is shown. For the interpretation of the trace consult the article  [[{{NAMESPACE}}:support_voip_protocol#SupportSipKnowhow | "Brief Tutorial of the SIP Signaling and SDP Media Protocols", chapter "Knowhow SIP Signaling" ]].
 +
:
 +
:* RTP/RTCP Media:
 +
:: The RTP/RTCP information and statistics of this specific connection or call attempt is shown. For the interpretation of the media information consult the article [[{{NAMESPACE}}:support_voip_protocol#SupportSdpKnowhow | "Brief Tutorial of the SIP Signaling and SDP Media Protocols", chapter "Knowhow Media Stream" ]].
  
  
 
{{Note|
 
{{Note|
−
The "Call Data" is tenant sensitive. This means a supporter of tenant A is not able to see events of tenant B!}}
+
* The "Call Data" has a limited history. The length of the history may be different from VoIP switch to VoIP switch and depends on the CDR storage length in the date base.
 +
 
 +
* Not all filter options may be available on the VoIP Switch.
 +
 
 +
* The "Call Data" is tenant sensitive. This means a supporter/operator of tenant A is not able to see events of tenant B!
 +
}}
 +
 
 +
 
 +
{{Note| type=warning |
 +
Depending an the settings of a VoIP system it may be possible to change values in CDR.
 +
 
 +
'''Changing a CDR's contents may be a legal violation in the country of operation of the VoIP Switch!'''
 +
}}
  
  
Line 270: Line 304:
  
 
{{ToTop}} <!--------------------------------------------------------------------------------------->
 
{{ToTop}} <!--------------------------------------------------------------------------------------->
−
=== Get a "Call Data" ===
+
=== Get the "Call Data" ===
  
 
Dialog: "Call Data":
 
Dialog: "Call Data":
−
[[file: support_tool_call_data_dialog.gif |frameless|link=|500px|left| Dialog: "Call Data" ]]
+
[[file:support_configcenter_call_data_general_e.png |750px|left|frameless|link=| Dialog: "Call Data" ]]
−
<br style="clear:both">
+
<br clear=all>
 +
 
 +
 
 +
By clicking on the line of a CDR a dialog pops up, which provides a) more details of the connection and b) one click access to the call's SIP trace and media RTP/RTCP information and statistics:
 +
[[file:support_configcenter_call_data_detail_e.png |750px|left|frameless|link=| Dialog: "Call Data Details" ]]
 +
<br clear=all>
 +
 
 +
 
 +
<gallery mode="packed" widths=200px>
 +
File:support_trace_example.png | For the interpretation of the trace consult the article:<br>  "Brief Tutorial of the SIP Signaling and SDP Media Protocols", [[{{NAMESPACE}}:support_voip_protocol#SupportSipKnowhow |  chapter "Knowhow SIP Signaling" ]]
 +
File:support_connection_rtp_rtcp_statistics_details_e.png | For the interpretation of the media information consult the article:<br> "Brief Tutorial of the SIP Signaling and SDP Media Protocols", [[{{NAMESPACE}}:support_voip_protocol#SupportSdpKnowhow |  chapter "Knowhow Media Stream" ]]
 +
</gallery>
  
  
  
−
{{#ifeq: {{An_Wiki_Site}} | test_wiki |
 
  
 
{{ToTop | SupportToolConfigCenterRegistration }} <!------------------------------------------------>
 
{{ToTop | SupportToolConfigCenterRegistration }} <!------------------------------------------------>
−
== The ConfigCenter '''Address Registration''' {{Help_Status |  | ComingSoon }} ==
+
== The ConfigCenter '''Address Registration''' ==
 +
 
 +
The ConfigCenter "Address Registration" displays if a SIP device or MGCP MTA has registered the telephone number.
 +
The supporter finds the following information of the registering devices:
 +
:* Type of registration, SIP, notifications, presence, etc
 +
:* IP address
 +
:* SIP user agent
 +
:* Registration time left.
  
−
The ConfigCenter "Address Registration" displays if a SIP device or MGCP MTA has registered the telephone number. The supporter finds information about IP address, SIP User Agent, registration time left.
+
Registrations can be de-registrated on the VoIP Switch by force.
 +
 
 +
Hint:<br>
 +
The device cannot be informed that it was de-registerd on the VoIP Switch. That means you have to wait until it re-registers automatically or force the device manually to re-register.
 +
 
 +
 
 +
 
 +
 
 +
{{ToTop}} <!--------------------------------------------------------------------------------------->
 +
=== Navigate to "Registrations" ===
 +
 
 +
ConfigCenter:
 +
{{Navigation_List | 1 | Menu "Addresses" }}
 +
 
 +
or
 +
{{Navigation_List | 1 | Menu "Accounts" }}
 +
{{Navigation_List | 2 | Click on the line of the desired account }}
 +
{{Navigation_List | 3 | Click on the right arrow at "Addresses" }}
 +
 
 +
 
 +
For details:
 +
{{Navigation_List | 2 | Click on the line of the desired address }}
 +
{{Navigation_List | 3 | Click on the right arrow at "Registration" }}
 +
 
 +
 
 +
 
 +
 
 +
{{ToTop}} <!--------------------------------------------------------------------------------------->
 +
=== Interpretation of "Registrations" Information ===
 +
 
 +
Display of "Addresses" and registration overview:
 +
[[file:support_configcenter_registration_e.png |750px|left|frameless|link=| Dialog: "Addresses & Registration" ]]
 +
<br clear=all>
 +
 
 +
 
 +
By clicking on the line of an address and then the right arrow at "Registration" a dialog pops up, which provides informations of all registrations of the address:
 +
[[file:support_configcenter_registration_details_e.png |750px|left|frameless|link=| Dialog: "Registration Details" ]]
 +
<br clear=all>
  
  
Line 289: Line 377:
  
 
{{ToTop | SupportToolConfigCenterComponent }} <!--------------------------------------------------->
 
{{ToTop | SupportToolConfigCenterComponent }} <!--------------------------------------------------->
−
== The ConfigCenter '''System Components''' {{Help_Status |  | ComingSoon }} ==
+
== The ConfigCenter '''Components''' ==
  
−
The "System Components" displays the state and activity of the VoIP Switch components.
+
The "Components" displays the state and activity of the VoIP Switch components. The components are the entities of the VoIP Switch that provide all functionality and features.
 +
The display is automatically updated every few seconds and shows the actual state and load of every component.
 +
 
 +
{{Note|
 +
On most VoIP Switches the "Components" display is not available for the supporters and operators.
 +
}}
 +
 
 +
 
 +
 
 +
 
 +
{{ToTop}} <!--------------------------------------------------------------------------------------->
 +
=== Navigate to "Components" ===
 +
 
 +
ConfigCenter:
 +
{{Navigation_List | 1 | Menu "System" }}
 +
{{Navigation_List | 2 | Menu "Components" }}
 +
 
 +
 
 +
 
 +
 
 +
{{ToTop}} <!--------------------------------------------------------------------------------------->
 +
=== Interpretation of "Components" Information ===
 +
 
 +
Display of "Components":
 +
[[file:support_configcenter_components_general_e.png |500px|left|frameless|link=| Dialog: "Components" ]]
 +
<br clear=all>
 +
 
 +
 
 +
By clicking on the line of a component a dialog pops up, which provides more informations or enables to send messages or handle the work load of the component:
 +
[[file:support_configcenter_components_component_detail_e.png |750px|left|frameless|link=| Dialog: "Component Details" ]]
 +
<br clear=all>
  
  
Line 297: Line 415:
  
 
{{ToTop | SupportToolConfigCenterChannel }} <!----------------------------------------------------->
 
{{ToTop | SupportToolConfigCenterChannel }} <!----------------------------------------------------->
−
== The ConfigCenter '''Channels''' {{Help_Status | | ComingSoon }} ==
+
== The ConfigCenter '''Channels''' ==
 +
 
 +
The ConfigCenter "Channels" is a live display of the current active connections and connection build-up. The administrator can filter an search the connections. If needed a connection can be forced to be released.
 +
 
 +
{{Note|
 +
On most VoIP Switches the "Channels" display is not available for the supporters and operators.
 +
}}
 +
 
 +
 
  
−
The ConfigCenter "Channels" displays the state of connections.
+
 
 +
{{ToTop}} <!--------------------------------------------------------------------------------------->
 +
=== Navigate to "Channels" ===
 +
 
 +
ConfigCenter:
 +
{{Navigation_List | 1 | Menu "Channels" }}
 +
 
 +
 
 +
 
 +
 
 +
{{ToTop}} <!--------------------------------------------------------------------------------------->
 +
=== Interpretation of "Channels" Information ===
 +
 
 +
Display of "Channels":
 +
[[file:support_configcenter_channels_e.png |750px|left|frameless|link=| Dialog: "Channles" ]]
 +
<br clear=all>
  
  
Line 305: Line 446:
  
 
{{ToTop | SupportToolConfigCenterUtilization }} <!------------------------------------------------->
 
{{ToTop | SupportToolConfigCenterUtilization }} <!------------------------------------------------->
−
== The ConfigCenter '''System Utilization''' {{Help_Status | | ComingSoon }} ==
+
== The ConfigCenter '''System Utilization'''  ==
 +
 
 +
The "System Utilization" gives a statistical overview of the VoIP Switch resource utilization:
 +
:* Number of accounts
 +
:* Number of addresses (telephone numbers)
 +
:* Number of registrations
 +
:* etc
 +
 
  
−
The "System Utilization" gives a statistical overview of the VoIP Switch resource utilization.
+
{{Note|
 +
On most VoIP Switches the "System Utilization" display is not available for the supporters and operators.
 
}}
 
}}
  
  
−
{{ToTop | }}
+
 
 +
 
 +
{{ToTop}} <!--------------------------------------------------------------------------------------->
 +
=== Navigate to "System Utilization" ===
 +
 
 +
ConfigCenter:
 +
{{Navigation_List | 1 | Menu "System" }}
 +
{{Navigation_List | 2 | Menu "Utilization" }}
 +
 
 +
 
 +
 
 +
 
 +
{{ToTop}} <!--------------------------------------------------------------------------------------->
 +
=== Interpretation of the "System Utilization" Information ===
 +
 
 +
The "System Utilization" provides the numbers of used resources:
 +
[[file:support_configcenter_system_utilization_e.png |500px|left|frameless|link=| Dialog: "System Utilization" ]]
 +
<br clear=all>
 +
 
 +
 
 
<!-- Transclusion : Article End -------------------------------------------------------------------><section end=article />
 
<!-- Transclusion : Article End -------------------------------------------------------------------><section end=article />
 +
{{ToTop}}
 
{{PAGE_FOOTER}}
 
{{PAGE_FOOTER}}
 
{{Page_Version |version=3.0 |author=Aarenet |date=May 2017}}
 
{{Page_Version |version=3.0 |author=Aarenet |date=May 2017}}

Latest revision as of 14:16, 5 September 2017


Note The features and/or parameters listed in this article may not be available from your telephone service provider.



Home Support

 

 

Download PDF

 



Introduction

The VoIP Switch Administrators, Operators, Supporters find here information about the Aarenet VoIP Switch "On Board" tools for analyzing and supporting general VoIP Switch issues and customer problems:

  • The ConfigCenter "Support Log" displays the VoIP Switch internal activities
  • The ConfigCenter "Traces" displays the signaling between the VoIP Switch an external devices
  • The ConfigCenter "Call Data" lists the CDR of all incoming or outgoing connections or connection attempts. The "Call Data" provide shortcuts to SIP, SDP trace and RTP statistic information of a single call.
  • The ConfigCenter "Address Registration" displays if a SIP device or MGCP MTA has registered a telephone number
  • The ConfigCenter "System Components" displays the state and activity of the VoIP Switch components
  • The ConfigCenter "Channels" displays the state of connections
  • The ConfigCenter "System Utilization" displays a statistical overview of the VoIP Switch resource utilization




→ Top

VoIP Switch ConfigCenter Support Tools


→ Top

The ConfigCenter Support Log

The "Support Log" provides the supporter with information from the internal processes of the ServiceCenter:

  • Registration
  • Connection setup, release and exceptions
  • Call Routing
  • Used Ruleset
  • Emergency calls
  • etc


The "Support Log" provides filters for:

  • Time based selection: From – Until, From – Duration
  • Text filter
  • Registration events
  • Call events
  • etc.


The "Support Log" has a limited history. The history may last from a few hours up to some days. The length of the history may be different from VoIP switch to VoIP switch and depends on the length of log files and amount of logging events.


Note

The "Support Log" is tenant sensitive. This means a supporter of tenant A is not able to see events of tenant B!





→ Top

Navigate to the "Support Log"

ConfigCenter:

nav Menu "Support"
nav Menu "Support Log"




→ Top

Get a "Support Log"

Dialog: "Support Log":

Dialog: Support Log



When the dialog "Support Log" opens it contains by default in "From" the actual date/time (-5min) and in "Duration" a duration of 5min:

  1. Click the Button [ Download ]
  2. Via HTTP an ASCII formatted file with the last 5 minutes will be downloaded


Retrieving a "Support Log" in the past:

  1. Insert the in "From" the desired start date/time
  2. Insert in "Duration" the needed length
  3. Press on the PC keyboard the 'Enter' key : The "Until" date/time will be computed
  4. Click the Button [ Download ]

or

  1. Insert the in "From" the desired start date/time
  2. Insert the in "Until" the desired stop date/time
  3. Press on the PC keyboard the 'Enter' key: The "Duration" will be computed
  4. Click the Button [ Download ]


Best Practice

Get the events of a connection in the past:

  1. Search the Call ID of the connection in the "Call Data"
  2. Use the Call ID in the "Text" filter of the Support Log dialog
  3. Make sure that the connection date/time match "From"- "Until"
  4. Download the Support Log


Get the events of a just finished connection:

  1. Set the "Duration" to 5min (or shorter)
  2. Download the Support Log
  3. Search for the connection





→ Top

Interpretation of a "Support Log"

The interpretation of a "Support Log" is quite easy and straight forward. With a little experience one will be soon familiar with the interpretation.

Interpretation and example of a call setup and release:

Example Support Log





→ Top

ConfigCenter Trace

The "Trace" provides the supporter with information from the message traffic between the VoIP switch and external VoIP devices, such as PSTN gateway, SIP CPE, SIP or MGCP telephones.

The "Trace" contains:

  • Session Initiation Protocol SIP registration and connection signaling messages
  • Media Gateway Control Protocol MGCP audit and endpoint control messages
  • Session Description Protocol SDP streaming media initialization parameters


The "Trace" provides filters for:

  • Time based selection: From – Until, From – Duration
  • Text filter


The "Trace" has a limited history. The history may last from a few hours up to some days. The length of the history may be different from VoIP switch to VoIP switch and depends on the length of log files and amount of logging events.


The interpretation of a "Trace" (PCAP formatted file) has to be done in an external application like Wireshark network protocol analyzer. Wireshark offers deep and rich VoIP analysis .


Note

The "Trace" is not tenant sensitive. This means a supporter of tenant A is able to see signaling messages of tenant B!

Due to this open display of information it may be possible that the "Trace" is not available for the supporters and operators on a multi tenant VoIP Switch.





→ Top

Navigate to the "Trace"

ConfigCenter:

nav Menu "Support"
nav Menu "Trace"




→ Top

Get a "Trace"

Dialog: "Trace":

Dialog: Trace



When the dialog "Trace" opens it contains by default in "From" the actual date/time (-5min) and in "Duration" a duration of 5min:

  1. Click the Button [ Download ]
  2. Via HTTP an PCAP formatted file with the last 5 minutes will be downloaded


Retrieving a "Trace" in the past:

  1. Insert the in "From" the desired start date/time
  2. Insert in "Duration" the needed length
  3. Press on the PC keyboard the 'Enter' key: The "Until" date/time will be computed
  4. Click the Button [ Download ]

or

  1. Insert the in "From" the desired start date/time
  2. Insert the in "Until" the desired stop date/time
  3. Press on the PC keyboard the 'Enter' key: The "Duration" will be computed
  4. Click the Button [ Download ]


Best Practice

Get the events of a connection in the past:

  1. Search the connection in the "Call Data"
  2. Click the Button [ Trace ]


Get the events of a just finished connection:

  1. Set the "Duration" to 5min (or shorter)
  2. Download the Trace
  3. Search for the connection





→ Top

Interpretation of a "Trace"

The interpretation of a "Trace" needs experience!

For more information:


Example of a Wireshark call capture, SIP setup and release:

Example "Trace"



Example of a Wireshark call list:

Navigate in Wireshark:

nav Menu "Statistics"
nav Menu "VoIP Calls"


Wireshark dialog where all calls are listed of the actual trace:

Example Trace VoIP Call List



Example of a Wireshark call flow:


Navigate in Wireshark:

nav Menu "Statistics"
nav Menu "VoIP Calls"
nav Select the call of interest
nav Click Button [ Graph ]


Wireshark dialog where the message flow is shown of the selected call:

Example Trace VoIP Call Flow





→ Top

The ConfigCenter Call Data

The "Call Data" lists the CDR of all incoming or outgoing connections or connection attempts. Extended filters enable the supporter to search for specific calls. The filters can be combined with logical AND.

Filter CDRs according:

  • Call start and end date/time
  • Call duration
  • Call charges
  • Telephone number of caller and/or callee.
  • Tenants & account
  • Price list attributes "Destination Type" & "Destination"

The "Call Data" has a limited history. The length of the history may be different from VoIP switch to VoIP switch and depends on the CDR storage length in the date base.


Selected CDR details allow direct access to the information of:

  • SIP Trace:
The SIP message contents of this specific connection or call attempt is shown. For the interpretation of the trace consult the article "Brief Tutorial of the SIP Signaling and SDP Media Protocols", chapter "Knowhow SIP Signaling" .
  • RTP/RTCP Media:
The RTP/RTCP information and statistics of this specific connection or call attempt is shown. For the interpretation of the media information consult the article "Brief Tutorial of the SIP Signaling and SDP Media Protocols", chapter "Knowhow Media Stream" .


Note
  • The "Call Data" has a limited history. The length of the history may be different from VoIP switch to VoIP switch and depends on the CDR storage length in the date base.
  • Not all filter options may be available on the VoIP Switch.
  • The "Call Data" is tenant sensitive. This means a supporter/operator of tenant A is not able to see events of tenant B!



Warning

Depending an the settings of a VoIP system it may be possible to change values in CDR.

Changing a CDR's contents may be a legal violation in the country of operation of the VoIP Switch!





→ Top

Navigate to the "Call Data"

ConfigCenter:

nav Menu "Rating"
nav Menu "Call Data"




→ Top

Get the "Call Data"

Dialog: "Call Data":

Dialog: "Call Data"



By clicking on the line of a CDR a dialog pops up, which provides a) more details of the connection and b) one click access to the call's SIP trace and media RTP/RTCP information and statistics:

Dialog: "Call Data Details"






→ Top

The ConfigCenter Address Registration

The ConfigCenter "Address Registration" displays if a SIP device or MGCP MTA has registered the telephone number. The supporter finds the following information of the registering devices:

  • Type of registration, SIP, notifications, presence, etc
  • IP address
  • SIP user agent
  • Registration time left.

Registrations can be de-registrated on the VoIP Switch by force.

Hint:
The device cannot be informed that it was de-registerd on the VoIP Switch. That means you have to wait until it re-registers automatically or force the device manually to re-register.




→ Top

Navigate to "Registrations"

ConfigCenter:

nav Menu "Addresses"

or

nav Menu "Accounts"
nav Click on the line of the desired account
nav Click on the right arrow at "Addresses"


For details:

nav Click on the line of the desired address
nav Click on the right arrow at "Registration"




→ Top

Interpretation of "Registrations" Information

Display of "Addresses" and registration overview:

Dialog: "Addresses & Registration"



By clicking on the line of an address and then the right arrow at "Registration" a dialog pops up, which provides informations of all registrations of the address:

Dialog: "Registration Details"





→ Top

The ConfigCenter Components

The "Components" displays the state and activity of the VoIP Switch components. The components are the entities of the VoIP Switch that provide all functionality and features. The display is automatically updated every few seconds and shows the actual state and load of every component.


Note

On most VoIP Switches the "Components" display is not available for the supporters and operators.





→ Top

Navigate to "Components"

ConfigCenter:

nav Menu "System"
nav Menu "Components"




→ Top

Interpretation of "Components" Information

Display of "Components":

Dialog: "Components"



By clicking on the line of a component a dialog pops up, which provides more informations or enables to send messages or handle the work load of the component:

Dialog: "Component Details"





→ Top

The ConfigCenter Channels

The ConfigCenter "Channels" is a live display of the current active connections and connection build-up. The administrator can filter an search the connections. If needed a connection can be forced to be released.


Note

On most VoIP Switches the "Channels" display is not available for the supporters and operators.





→ Top

Navigate to "Channels"

ConfigCenter:

nav Menu "Channels"




→ Top

Interpretation of "Channels" Information

Display of "Channels":

Dialog: "Channles"





→ Top

The ConfigCenter System Utilization

The "System Utilization" gives a statistical overview of the VoIP Switch resource utilization:

  • Number of accounts
  • Number of addresses (telephone numbers)
  • Number of registrations
  • etc


Note

On most VoIP Switches the "System Utilization" display is not available for the supporters and operators.





→ Top

Navigate to "System Utilization"

ConfigCenter:

nav Menu "System"
nav Menu "Utilization"




→ Top

Interpretation of the "System Utilization" Information

The "System Utilization" provides the numbers of used resources:

Dialog: "System Utilization"




→ Top

© Aarenet Inc 2018

Version: 3.0     Author:  Aarenet     Date: May 2017

Retrieved from "http://help.aarenet.com/mediawiki/index.php?title=Support_tools&oldid=1108"