| 45.6. CTIIAX diagnostics and statistics | ||
|---|---|---|
 | Chapter 45. IAX - Inter-Asterisk eXchange |  |
| 45.6. CTIIAX diagnostics and statistics | ||
|---|---|---|
| | Chapter 45. IAX - Inter-Asterisk eXchange | |
Use the following commands to display the diagnostics of the CTIIAX resource:
Shows diagnostic information, such as the state of the resource, the currently used channels, the remote IAX username/address/port, the calling and the called number.
Shows diagnostic information in an extended format: the same information listed for d d ctiiax command and the state of Unattended/Attended Call Transfer, the minimum/average/maximum lag value during the call and the jitter value (calculated as variance of the lag) in least 10 seconds.
[22:15:27] ABILIS_CPX:d d ctiiax
RES:CtiIax --------------------------------------------------------------------
Inter-Asterisk_eXchange_Version_2
STATE:ACTIVE UDP-STATE:OPENED USED-CHAN:1
- IAX Channels diagnostics ---------------------------------------------
CH: IAXState User RemAdd-RemPort
Q931State CallId CG CD
------------------------------------------------------------------------
0 CONNECTED asterisk160 192.168.000.253-4569
10-CONNECTED-TO 636 9916 749
------------------------------------------------------------------------
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
------------------------------------------------------------------------[22:15:30] ABILIS_CPX:d de ctiiax
RES:CtiIax --------------------------------------------------------------------
Inter-Asterisk_eXchange_Version_2
STATE:ACTIVE UDP-STATE:OPENED USED-CHAN:1
- IAX Channels diagnostics ---------------------------------------------
CH: IAXState User RemAdd-RemPort
Q931State CallId CG CD
Q932State UCTState ACTState CPOState
MinLag MaxLag AvgLag LastLag 10sec-JitterLag
------------------------------------------------------------------------
0 CONNECTED asterisk160 192.168.000.253-4569
10-CONNECTED-TO 636 9916 749
IDLE - - -
- - - - -
------------------------------------------------------------------------
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
------------------------------------------------------------------------Use the following commands to display the statistics of the CTIIAX resource:
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 succesful/failed transmission requests.
Shows statistic information in an extended format: the same information listed for d se ctiiax command are shown for each session.
[22:15:27] ABILIS_CPX:d s ctiiax
RES:CtiIax --------------------------------------------------------------------
Inter-Asterisk_eXchange_Version_2
--- Cleared 45 days 03:25:16 ago, on 07/11/2007 at 18:50:14 ------------
-----------|---INPUT---|--OUTPUT---|-----------|---INPUT---|--OUTPUT---|
SUCC-CALL | 1023| 5569|FAIL-CALL | 53| 1304|
SUCC-REG | 51217| 12807|FAIL-REG | 12| 52198|
SUCC-QUAL | 0| |FAIL-QUAL | 31| |
SUCC-TRAN | 2520| |FAIL-TRAN | 1018| |
SUCC-TXREQ | 0| 0|FAIL-TXREQ | 0| 0|
EXP-RETRY | 12| 53530|DTMF | 34| 100|
QUELCH | 2461| |UNQUELCH | 2416| |
LOST-JITTER| | 0|OUTSEQ-FULL| 21| |
LOST-NOBUF | 0| 0|OUTSEQ-MINI| 7| |
BLACKLISTED| 0| |UNSUPPORTED| 0| 0|
TRUNK-OVR | | 0|
------------------------------------------------------------------------[22:15:30] ABILIS_CPX:d se ctiiax
RES:CtiIax --------------------------------------------------------------------
Inter-Asterisk_eXchange_Version_2
--- Cleared 45 days 03:25:23 ago, on 07/11/2007 at 18:50:15 ------------
-----------|---INPUT---|--OUTPUT---|-----------|---INPUT---|--OUTPUT---|
SUCC-CALL | 1023| 5569|FAIL-CALL | 53| 1304|
SUCC-REG | 51217| 12807|FAIL-REG | 12| 52198|
SUCC-QUAL | 0| |FAIL-QUAL | 31| |
SUCC-TRAN | 2520| |FAIL-TRAN | 1018| |
SUCC-TXREQ | 0| 0|FAIL-TXREQ | 0| 0|
EXP-RETRY | 12| 53530|DTMF | 34| 100|
QUELCH | 2461| |UNQUELCH | 2416| |
LOST-JITTER| | 0|OUTSEQ-FULL| 21| |
LOST-NOBUF | 0| 0|OUTSEQ-MINI| 7| |
BLACKLISTED| 0| |UNSUPPORTED| 0| 0|
TRUNK-OVR | | 0|
------------------------------------------------------------------------
CH:0 CallId:24026 CG:3381834848 CD:601
-----------|---INPUT---|--OUTPUT---|-----------|---INPUT---|--OUTPUT---|
VOICE-FRM | 334| 301|LOST | 0| |
OUTSEQ-FULL| 0| |LOST-JITTER| | 0|
OUTSEQ-MINI| 0| |LOST-NOBUF | | 0|
------------------------------------------------------------------------
CH:1 CallId:17799 CG: CD:621
-----------|---INPUT---|--OUTPUT---|-----------|---INPUT---|--OUTPUT---|
VOICE-FRM | 0| 0|LOST | 0| |
OUTSEQ-FULL| 0| |LOST-JITTER| | 0|
OUTSEQ-MINI| 0| |LOST-NOBUF | | 0|
------------------------------------------------------------------------
CH:2 CallId:1488 CG:671 CD:601
-----------|---INPUT---|--OUTPUT---|-----------|---INPUT---|--OUTPUT---|
VOICE-FRM | 1184| 1178|LOST | 0| |
OUTSEQ-FULL| 0| |LOST-JITTER| | 0|
OUTSEQ-MINI| 0| |LOST-NOBUF | | 0|
------------------------------------------------------------------------
CH:3 CallId:0 CG: CD:
-----------|---INPUT---|--OUTPUT---|-----------|---INPUT---|--OUTPUT---|
VOICE-FRM | 0| 0|LOST | 0| |
OUTSEQ-FULL| 0| |LOST-JITTER| | 0|
OUTSEQ-MINI| 0| |LOST-NOBUF | | 0|
------------------------------------------------------------------------
CH:4 CallId:0 CG: CD:
-----------|---INPUT---|--OUTPUT---|-----------|---INPUT---|--OUTPUT---|
VOICE-FRM | 0| 0|LOST | 0| |
OUTSEQ-FULL| 0| |LOST-JITTER| | 0|
OUTSEQ-MINI| 0| |LOST-NOBUF | | 0|
------------------------------------------------------------------------
CH:5 CallId:0 CG: CD:
-----------|---INPUT---|--OUTPUT---|-----------|---INPUT---|--OUTPUT---|
VOICE-FRM | 0| 0|LOST | 0| |
OUTSEQ-FULL| 0| |LOST-JITTER| | 0|
OUTSEQ-MINI| 0| |LOST-NOBUF | | 0|
------------------------------------------------------------------------
CH:6 CallId:0 CG: CD:
-----------|---INPUT---|--OUTPUT---|-----------|---INPUT---|--OUTPUT---|
VOICE-FRM | 0| 0|LOST | 0| |
OUTSEQ-FULL| 0| |LOST-JITTER| | 0|
OUTSEQ-MINI| 0| |LOST-NOBUF | | 0|
------------------------------------------------------------------------
CH:7 CallId:0 CG: CD:
-----------|---INPUT---|--OUTPUT---|-----------|---INPUT---|--OUTPUT---|
VOICE-FRM | 0| 0|LOST | 0| |
OUTSEQ-FULL| 0| |LOST-JITTER| | 0|
OUTSEQ-MINI| 0| |LOST-NOBUF | | 0|
------------------------------------------------------------------------
CH:8 CallId:0 CG: CD:
-----------|---INPUT---|--OUTPUT---|-----------|---INPUT---|--OUTPUT---|
VOICE-FRM | 0| 0|LOST | 0| |
OUTSEQ-FULL| 0| |LOST-JITTER| | 0|
OUTSEQ-MINI| 0| |LOST-NOBUF | | 0|
------------------------------------------------------------------------
CH:9 CallId:0 CG: CD:
-----------|---INPUT---|--OUTPUT---|-----------|---INPUT---|--OUTPUT---|
VOICE-FRM | 0| 0|LOST | 0| |
OUTSEQ-FULL| 0| |LOST-JITTER| | 0|
OUTSEQ-MINI| 0| |LOST-NOBUF | | 0|
------------------------------------------------------------------------Below debug commands are described. They are useful to view the authentication/registration logs and the registered IAX users table.
![[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:
[14:09:58] ABILIS_CPX:debug res:ctiiax lsn:0
RES:CtiIax --------------------------------------------------------------------
Inter-Asterisk_eXchange_Version_2
BufferLength:931 Date/Time:29/06/2007 14:10:00 TraceTime:4812354
Usage:
LSN:0 - This help
LSN:1 - Extra channels diags
LSN:2 - Show transferring 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 unregisterring.Type the following command to display the event logs connected with the users registation:
[18:04:09] ABILIS_CPX:debug res:ctiiax lsn:3
RES:CtiIax --------------------------------------------------------------------
Inter-Asterisk_eXchange_Version_2
BufferLength:16243 Date/Time:28/06/2007 18:05:56 TraceTime:<NotRunning>
DD/MM/YYYY HH:MM:SS - CALLID DESCRIPTION
28/06/2007 16:20:03 - [17449] Error in IN channel with 192.168.0.167:4569
28/06/2007 16:20:03 - [17449] Retransmission out of time FF 6, 14
28/06/2007 16:20:28 - [17451] Error in OUT channel with 192.168.0.100:4569
28/06/2007 16:20:28 - [17451] Password is not valid, peer:iaxphoneThis 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 are cut off).
Most common usage are:
debug res:ctiiax lsn:3 : shows log;
debug res:ctiiax lsn:3 cmd:clr : clear log;
debug res:ctiiax lsn:3 cmd:set:err : set log mask to log only errors events;
debug res:ctiiax lsn:3 cmd:set:err,reg : set log mask to log only errors and registration events;
debug res:ctiiax lsn:3 cmd:set:full : set log mask to log any event.
The following command shows the registration table (remote peers registered with Abilis and remote peers Abilis is registered to). Registration in IAX is a way to avoid NAT troubles and mantain connectivity between IAX peers.
[17:03:12] ABILIS_CPX:debug res:ctiiax lsn:4
RES:CtiIax --------------------------------------------------------------------
Inter-Asterisk_eXchange_Version_2
BufferLength:324 Date/Time:18/01/2008 11:24:47 TraceTime:<NotRunning>
User Host Port REG LIFETIME AGE
-------------------------------------------------------------------------------
asterisk 192.168.000.250 4569 REMOTE 60 12
zoiper 192.168.000.024 4569 LOCAL 60 35
-------------------------------------------------------------------------------Meaning of the parameters:
UserUsername registered in the user table (d user).
HostIP address of the user.
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
asterisk (ip address: 192.168.0.250) which needs
Abilis registration each 60 seconds; Abilis registered itself 12 seconds
ago.
The user zoiper (ip address: 192.168.0.24) is
registered to Abilis; it registered itself 35 seconds ago.
| |  | |
| 45.5. Connecting Abilis and Asterisk |  | 45.7. Appendix - IAX protocol |