| 46.7. CTISIP diagnostics and statistics | ||
|---|---|---|
 | Chapter 46. SIP - Session Initiation Protocol |  |
| 46.7. CTISIP diagnostics and statistics | ||
|---|---|---|
| | Chapter 46. SIP - Session Initiation Protocol | |
To display the diagnostics of the CTISIP resource the following commands are used:
Shows diagnostic information, such as the state of the resource, the currently used channels, the remote SIP username, the local/remote IP address-port of the SIP channel for incoming packets, the calling and the called number.
Shows diagnostic information in an extended format: the same information listed for d d ctisip command and the state of Unattended/Attended Call Transfer, the local/remote IP address-port of the SIP channel for outgoing packets, the local/remote IP address-port for RTP and RTCP channel.
[12:34:34] ABILIS_CPX:d d ctisip
RES:CtiSip --------------------------------------------------------------------
Session_Initiation_Protocol
STATE:ACTIVE UDP-STATE:CLOSED USED-CHAN:0
- SIP Channels diagnostics ---------------------------------------------
CH: SIPState Prot TcpLsn SIP-LocAdd-Port-In SIP-RemAdd-Port-In
Q931State CG CD
User CallId
------------------------------------------------------------------------
0 DISCONNECTED
00-DISCONNECTED
------------------------------------------------------------------------
1 DISCONNECTED
00-DISCONNECTED
------------------------------------------------------------------------
2 DISCONNECTED
00-DISCONNECTED
------------------------------------------------------------------------
3 DISCONNECTED
00-DISCONNECTED
------------------------------------------------------------------------
4 DISCONNECTED
00-DISCONNECTED
------------------------------------------------------------------------
5 DISCONNECTED
00-DISCONNECTED
------------------------------------------------------------------------
6 DISCONNECTED
00-DISCONNECTED
------------------------------------------------------------------------
7 DISCONNECTED
00-DISCONNECTED
------------------------------------------------------------------------
8 DISCONNECTED
00-DISCONNECTED
------------------------------------------------------------------------
9 DISCONNECTED
00-DISCONNECTED
------------------------------------------------------------------------[12:34:34] ABILIS_CPX:d de ctisip
RES:CtiSip --------------------------------------------------------------------
Session_Initiation_Protocol
STATE:ACTIVE UDP-STATE:CLOSED USED-CHAN:0
- SIP Channels diagnostics ---------------------------------------------
CH: SIPState Prot TcpLsn SIPLocAdd-Port-In SIPRemAdd-Port-In
SIPLocAdd-Port-Out SIPRemAdd-Port-Out
Q931State CG CD
User CallId
Q932State UCTState ACTState CPOState
RTPState RTPLocAdd-LocPort RTPRemAdd-RemPort
RTCPState RTCPLocAdd-LocPort RTCPRemAdd-RemPort
------------------------------------------------------------------------
0 DISCONNECTED
00-DISCONNECTED
------------------------------------------------------------------------
1 DISCONNECTED
00-DISCONNECTED
------------------------------------------------------------------------
2 DISCONNECTED
00-DISCONNECTED
------------------------------------------------------------------------
3 DISCONNECTED
00-DISCONNECTED
------------------------------------------------------------------------
4 DISCONNECTED
00-DISCONNECTED
------------------------------------------------------------------------
5 DISCONNECTED
00-DISCONNECTED
------------------------------------------------------------------------
6 DISCONNECTED
00-DISCONNECTED
------------------------------------------------------------------------
7 DISCONNECTED
00-DISCONNECTED
------------------------------------------------------------------------
8 DISCONNECTED
00-DISCONNECTED
------------------------------------------------------------------------
9 DISCONNECTED
00-DISCONNECTED
------------------------------------------------------------------------To display the statistics of the CTISIP resource the following commands are used:
Shows statistic information, such as the number of incoming/outgoing accepted/rejected calls, the number of incoming/outgoing succesful/failed registrations, the number of incoming/outgoing reinvites, the number of successful incoming/outgoing transfers, the number of expired retransmission timer in incoming/outgoing calls.
Shows statistic information in an extended format: the same information listed for d se ctisip command are shown for each session.
[12:34:34] ABILIS_CPX:d s ctisip
RES:CtiSip --------------------------------------------------------------------
Session_Initiation_Protocol
--- Cleared 20 days 16:33:47 ago, on 03/12/2007 at 03:21:24 ------------
-----------|---INPUT---|--OUTPUT---|-----------|---INPUT---|--OUTPUT---|
SUCC-CALL | 0| 0|FAIL-CALL | 0| 0|
SUCC-REG | 0| 0|FAIL-REG | 0| 0|
SUCC-TRAN | 0| 0|FAIL-TRAN | 0| 0|
EXP-RETRY | 0| 0|DTMF | 0| 0|
HOLD | 0| 0|UN-HOLD | 0| 0|
UNKNOWN | 0| 0|REINVITES | 0| 0|
LOST-NOBUF | 0| 0|OUTSEQ | 0| |
BLACKLISTED| 0| |
------------------------------------------------------------------------[12:34:34] ABILIS_CPX:d se ctisip
RES:CtiSip --------------------------------------------------------------------
Session_Initiation_Protocol
--- Cleared 0 days 00:23:42 ago, on 19/12/2010 at 10:09:52 -------------
-----------|---INPUT---|--OUTPUT---|-----------|---INPUT---|--OUTPUT---|
SUCC-CALL | 0| 0|FAIL-CALL | 0| 0|
SUCC-REG | 0| 0|FAIL-REG | 0| 0|
SUCC-TRAN | 0| 0|FAIL-TRAN | 0| 0|
EXP-RETRY | 0| 0|DTMF | 0| 0|
HOLD | 0| 0|UN-HOLD | 0| 0|
UNKNOWN | 0| 0|REINVITES | 0| 0|
LOST-NOBUF | 0| 0|OUTSEQ | 0| |
BLACKLISTED| 0| |
------------------------------------------------------------------------
CH:0 CallId:
CG: CD:
-----------|---INPUT---|--OUTPUT---|-----------|---INPUT---|--OUTPUT---|
RTP-PCK | 0| 0|RTCP-PCK | 0| 0|
RTP-LOST | 0| 0|SIP-OUTSEQ | 0| |
RTP-OUTSEQ | 0| |RTP-NOBUF | 0| 0|
------------------------------------------------------------------------
CH:1 CallId:
CG: CD:
-----------|---INPUT---|--OUTPUT---|-----------|---INPUT---|--OUTPUT---|
RTP-PCK | 0| 0|RTCP-PCK | 0| 0|
RTP-LOST | 0| 0|SIP-OUTSEQ | 0| |
RTP-OUTSEQ | 0| |RTP-NOBUF | 0| 0|
------------------------------------------------------------------------
CH:2 CallId:
CG: CD:
-----------|---INPUT---|--OUTPUT---|-----------|---INPUT---|--OUTPUT---|
RTP-PCK | 0| 0|RTCP-PCK | 0| 0|
RTP-LOST | 0| 0|SIP-OUTSEQ | 0| |
RTP-OUTSEQ | 0| |RTP-NOBUF | 0| 0|
------------------------------------------------------------------------
CH:3 CallId:
CG: CD:
-----------|---INPUT---|--OUTPUT---|-----------|---INPUT---|--OUTPUT---|
RTP-PCK | 0| 0|RTCP-PCK | 0| 0|
RTP-LOST | 0| 0|SIP-OUTSEQ | 0| |
RTP-OUTSEQ | 0| |RTP-NOBUF | 0| 0|
------------------------------------------------------------------------
CH:4 CallId:
CG: CD:
-----------|---INPUT---|--OUTPUT---|-----------|---INPUT---|--OUTPUT---|
RTP-PCK | 0| 0|RTCP-PCK | 0| 0|
RTP-LOST | 0| 0|SIP-OUTSEQ | 0| |
RTP-OUTSEQ | 0| |RTP-NOBUF | 0| 0|
------------------------------------------------------------------------
CH:5 CallId:
CG: CD:
-----------|---INPUT---|--OUTPUT---|-----------|---INPUT---|--OUTPUT---|
RTP-PCK | 0| 0|RTCP-PCK | 0| 0|
RTP-LOST | 0| 0|SIP-OUTSEQ | 0| |
RTP-OUTSEQ | 0| |RTP-NOBUF | 0| 0|
------------------------------------------------------------------------
CH:6 CallId:
CG: CD:
-----------|---INPUT---|--OUTPUT---|-----------|---INPUT---|--OUTPUT---|
RTP-PCK | 0| 0|RTCP-PCK | 0| 0|
RTP-LOST | 0| 0|SIP-OUTSEQ | 0| |
RTP-OUTSEQ | 0| |RTP-NOBUF | 0| 0|
------------------------------------------------------------------------
CH:7 CallId:
CG: CD:
-----------|---INPUT---|--OUTPUT---|-----------|---INPUT---|--OUTPUT---|
RTP-PCK | 0| 0|RTCP-PCK | 0| 0|
RTP-LOST | 0| 0|SIP-OUTSEQ | 0| |
RTP-OUTSEQ | 0| |RTP-NOBUF | 0| 0|
------------------------------------------------------------------------
CH:8 CallId:
CG: CD:
-----------|---INPUT---|--OUTPUT---|-----------|---INPUT---|--OUTPUT---|
RTP-PCK | 0| 0|RTCP-PCK | 0| 0|
RTP-LOST | 0| 0|SIP-OUTSEQ | 0| |
RTP-OUTSEQ | 0| |RTP-NOBUF | 0| 0|
------------------------------------------------------------------------
CH:9 CallId:
CG: CD:
-----------|---INPUT---|--OUTPUT---|-----------|---INPUT---|--OUTPUT---|
RTP-PCK | 0| 0|RTCP-PCK | 0| 0|
RTP-LOST | 0| 0|SIP-OUTSEQ | 0| |
RTP-OUTSEQ | 0| |RTP-NOBUF | 0| 0|
------------------------------------------------------------------------Below debug commands are described.
![[Note]](../images/note.png) | Note |
|---|---|
To use these commands you need to have administrator or super user rights. |
Type the following command to display the syntax of the command:
[12:34:34] ABILIS_CPX:debug res:ctisip lsn:0
RES:CtiSip --------------------------------------------------------------------
Session_Initiation_Protocol
BufferLength:1027 Date/Time:28/11/2010 10:39:59 TraceTime:<NotRunning>
Usage:
LSN:0 - This help
LSN:1 - Extra channels diags
LSN:3 - Show debug log
LSN:3 CMD:CLR - Clear debug log
LSN:3 CMD:SET:[DFT | CLR | FULL | [level,...]] - Set log event mask
No parameters - Show current events log mask
DFT - Log default events (ERR events only)
CLR - Clear log event mask
FULL - Log all events
levels:
ERR - Log only error events
REG - Registration events
INFO - Informative events
LSN:4 - Show registered users
LSN:10 CMD:UserName - Force Abilis registration with this user
LSN:11 CMD:UserName - Force User unregistering
LSN:20 CMD:NumPackets - Simulates loss of NumPackets packets from CTIR
LSN:21 CMD:NumPackets - Simulates loss of NumPackets packets to CTIRType the below command to view the event logs connected with the users registration:
[12:37:17] ABILIS_CPX:debug res:ctisip lsn:3
RES:CtiSip --------------------------------------------------------------------
Session_Initiation_Protocol
BufferLength:10838 Date/Time:18/01/2008 11:37:06 TraceTime:<NotRunning>
DD/MM/YYYY HH:MM:SS - CHANNEL DESCRIPTION
10/12/2007 09:33:26 - [ 30] Error in OUT channel with 62.62.62.62:5060
10/12/2007 09:33:26 - [ 30] AUTH timer timeout
10/12/2007 11:08:09 - [ 30] Error in OUT channel with 62.62.62.62:5060
10/12/2007 11:08:09 - [ 30] AUTH timer timeout
10/12/2007 15:34:56 - [ 30] Error in OUT channel with 62.62.62.62:5060
10/12/2007 15:34:56 - [ 30] AUTH timer timeout
10/12/2007 15:40:44 - [ 30] Error in OUT channel with 62.62.62.62:5060
10/12/2007 15:40:44 - [ 30] AUTH timer timeout
10/12/2007 17:46:24 - [ 30] Error in OUT channel with 62.62.62.62:5060
10/12/2007 17:46:24 - [ 30] AUTH timer timeoutThis table shows data, time, identification of the event and the description of the error.
Possible errors could be:
unknown user;
codec not supported;
retransmission out of time (happens when you're cut off).
Most common usage are:
debug res:ctisip lsn:3 : shows log;
debug res:ctisip lsn:3 cmd:clr : clear log;
debug res:ctisip lsn:3 cmd:set:err : set log mask to log only errors events;
debug res:ctisip lsn:3 cmd:set:err,reg : set log mask to log only errors and registration events;
debug res:ctisip lsn:3 cmd:set:full : set log mask to log any event.
The following command allows to show the registration table (remote peers registered with Abilis and remote peers Abilis is registered to).
[17:03:12] ABILIS_CPX:debug res:ctisip lsn:4
RES:CtiSip --------------------------------------------------------------------
Session_Initiation_Protocol
BufferLength:324 Date/Time:18/01/2008 11:38:56 TraceTime:<NotRunning>
User Host Prot Port REG LIFETIME AGE
-------------------------------------------------------------------------------
sip_proxy 062.062.062.062 UDP 5060 REMOTE 120 21
zoiper 192.168.000.024 UDP 5060 LOCAL 60 35
-------------------------------------------------------------------------------Meaning of the parameters:
UserUsername registered in the user table (d user).
HostIP address of the user.
ProtTransport protocol.
PortUDP port of the user.
REGRegistration of the user [REMOTE: Abilis
is registered to a remote peer; LOCAL: a remote
peer is registered to Abilis].
LIFETIMEHow often (in seconds) the registration is requested.
AGETime (in seconds) since last valid registration.
In the previous example, Abilis is registered to the remote peer
sip_proxy (ip address: 62.62.62.62) which needs
Abilis registration each 120 seconds; Abilis registered itself 21
seconds ago.
The user zoiper (ip address: 192.168.0.24) is
registered to Abilis; it registered itself 35 seconds ago.
| |  | |
| 46.6. Busy Lamp Field (BLF) |  | 46.8. Appendix - SIP protocol overview |