Call statistics format C
From TBwiki
(Difference between revisions)
(Removing extra )) |
(Added MOS values in the RTP stats summary) |
||
| (3 intermediate revisions by 3 users not shown) | |||
| Line 1: | Line 1: | ||
| + | {{DISPLAYTITLE:Call statistics format}} | ||
| + | === '''''Applies to version(s): v3.0''''' === | ||
| + | |||
{| class="wikitable" | {| class="wikitable" | ||
|- | |- | ||
! Field name !! Description | ! Field name !! Description | ||
|- | |- | ||
| − | | colspan="2" style="text-align: center;" | ''' | + | | colspan="2" style="text-align: center;" | '''Statistics''' |
|- | |- | ||
| − | | @{StatSummary} || Summary of the RTP and T.38 stats in a pre-defined format:<br/> RTP( Rx(Pkt=2 CN=0 Signaling=0 Err=0) Tx(Pkt=0 CN=0 Signaling=0 Err=0)) T38( Rx(Pages=0 Pkt=0 Err=0) Tx(Pages=0 Pkt=0))<br/>For customized format, use other variables below. | + | | @{StatSummary} || Summary of the RTP and T.38 stats in a pre-defined format:<br/> RTP( Rx(Pkt=2 CN=0 Signaling=0 Err=0) Tx(Pkt=0 CN=0 Signaling=0 Err=0)) T38( Rx(Pages=0 Pkt=0 Err=0) Tx(Pages=0 Pkt=0))<br/>MOS(In=4.3 Out=4.3}) NetworkQuality(In=100 Out=100)<br/>For customized format, use other variables below. |
| + | |- | ||
| + | | colspan="2" style="text-align: center;" | '''MOS statistics''' | ||
| + | |- | ||
| + | | @{Stat:MOS} || Summary of the MOS stats: (Codec;Ingress;Egress) | ||
| + | |- | ||
| + | | @{Stat:MOS:Codec} || Maximal MOS value for the audio codec used | ||
| + | |- | ||
| + | | @{Stat:MOS:Ingress} || Calculated MOS value using RTP RX statistics | ||
| + | |- | ||
| + | | @{Stat:MOS:Egress} || Calculated MOS value using RTCP statistics (available only when RTCP is enable) | ||
| + | |- | ||
| + | | @{Stat:MOS:Global} || Minimum value between MOS ingress and MOS egress | ||
| + | |- | ||
| + | | colspan="2" style="text-align: center;" | '''Network quality statistics''' | ||
| + | |- | ||
| + | | @{Stat:NetworkQuality} || Summary of the network quality stats: (Ingress;Egress) | ||
| + | |- | ||
| + | | @{Stat:NetworkQuality:Ingress} || Calculated network quality percentage from 0 (bad) to 100 (perfect) for packets received | ||
| + | |- | ||
| + | | @{Stat:NetworkQuality:Egress} || Calculated network quality percentage from 0 (bad) to 100 (perfect) for packets transmitted (available only when RTCP is enable) | ||
| + | |- | ||
| + | | @{Stat:NetworkQuality:Global} || Minimum value between ingress and egress | ||
| + | |- | ||
| + | | colspan="2" style="text-align: center;" | '''Receive statistics''' | ||
|- | |- | ||
| − | | @{Stat:Rtp:Rx} || Summary of the Rx stats: (Packets;CNPackets;SignalingPackets;Errors) | + | | @{Stat:Rtp:Rx} || Summary of the Rx stats: (Packets;CNPackets;SignalingPackets;Errors;MOS:Ingress) |
|- | |- | ||
| @{Stat:Rtp:Rx:Packets} || Number of packets received from the IP network (audio + comfort noise + signaling) | | @{Stat:Rtp:Rx:Packets} || Number of packets received from the IP network (audio + comfort noise + signaling) | ||
| Line 57: | Line 84: | ||
| colspan="2" style="text-align: center;" | '''Transmit statistics''' | | colspan="2" style="text-align: center;" | '''Transmit statistics''' | ||
|- | |- | ||
| − | | @{Stat:Rtp:Tx} || Summary of the Tx stats: (Packets;CNPackets;SignalingPackets;Errors) | + | | @{Stat:Rtp:Tx} || Summary of the Tx stats: (Packets;CNPackets;SignalingPackets;Errors;MOS:Egress) |
|- | |- | ||
| @{Stat:Rtp:Tx:Packets} || Number of packets sent to the IP network (audio + comfort noise + signaling) | | @{Stat:Rtp:Tx:Packets} || Number of packets sent to the IP network (audio + comfort noise + signaling) | ||
| Line 166: | Line 193: | ||
| colspan="2" style="text-align: center;" | '''Receive statistics''' | | colspan="2" style="text-align: center;" | '''Receive statistics''' | ||
|- | |- | ||
| − | | @{ErrorSummary} || Summary of reported leg errors in a pre-defined format:<br/> FromNetwork(NoPackets;ExcessivePackets;ExcessivePayloadTypeChanges;ExcessiveIpPortChanges) ToNetwork(NoPackets)<br/>For customized format, use other variables below. | + | | @{ErrorSummary} || Summary of reported leg errors in a pre-defined format:<br/> FromNetwork(NoPackets;ExcessivePackets;ExcessivePayloadTypeChanges;ExcessiveIpPortChanges;ExcessiveSsrcChanges) ToNetwork(NoPackets)<br/>For customized format, use other variables below. |
|- | |- | ||
| − | | @{Error:FromNetwork} || Summary of the leg errors 'from network': (NoPackets;ExcessivePackets;ExcessivePayloadTypeChanges;ExcessiveIpPortChanges) | + | | @{Error:FromNetwork} || Summary of the leg errors 'from network': (NoPackets;ExcessivePackets;ExcessivePayloadTypeChanges;ExcessiveIpPortChanges;ExcessiveSsrcChanges) |
|- | |- | ||
| @{FromNetwork:NoPackets} || When '1', no packets received from the network in the last few seconds, while packets were expected. | | @{FromNetwork:NoPackets} || When '1', no packets received from the network in the last few seconds, while packets were expected. | ||
| Line 175: | Line 202: | ||
|- | |- | ||
| @{Error:FromNetwork:ExcessiveIpPortChanges} || When '1', excessive remote IP/Port changes were detected in the last few seconds. Received packets will be dropped. | | @{Error:FromNetwork:ExcessiveIpPortChanges} || When '1', excessive remote IP/Port changes were detected in the last few seconds. Received packets will be dropped. | ||
| + | |- | ||
| + | | @{Error:FromNetwork:ExcessiveSsrcChanges} || When '1', excessive remote SSRC changes (SSRC field in RTP packets header) were detected in the last few seconds. Received packets will be dropped. | ||
|- | |- | ||
| @{Error:FromNetwork:ExcessivePackets} || When '1', excessive packets/bytes rate was received from the network. All packets will be dropped. | | @{Error:FromNetwork:ExcessivePackets} || When '1', excessive packets/bytes rate was received from the network. All packets will be dropped. | ||
Latest revision as of 09:45, 25 July 2018
Applies to version(s): v3.0
| Field name | Description |
|---|---|
| Statistics | |
| @{StatSummary} | Summary of the RTP and T.38 stats in a pre-defined format: RTP( Rx(Pkt=2 CN=0 Signaling=0 Err=0) Tx(Pkt=0 CN=0 Signaling=0 Err=0)) T38( Rx(Pages=0 Pkt=0 Err=0) Tx(Pages=0 Pkt=0)) MOS(In=4.3 Out=4.3}) NetworkQuality(In=100 Out=100) For customized format, use other variables below. |
| MOS statistics | |
| @{Stat:MOS} | Summary of the MOS stats: (Codec;Ingress;Egress) |
| @{Stat:MOS:Codec} | Maximal MOS value for the audio codec used |
| @{Stat:MOS:Ingress} | Calculated MOS value using RTP RX statistics |
| @{Stat:MOS:Egress} | Calculated MOS value using RTCP statistics (available only when RTCP is enable) |
| @{Stat:MOS:Global} | Minimum value between MOS ingress and MOS egress |
| Network quality statistics | |
| @{Stat:NetworkQuality} | Summary of the network quality stats: (Ingress;Egress) |
| @{Stat:NetworkQuality:Ingress} | Calculated network quality percentage from 0 (bad) to 100 (perfect) for packets received |
| @{Stat:NetworkQuality:Egress} | Calculated network quality percentage from 0 (bad) to 100 (perfect) for packets transmitted (available only when RTCP is enable) |
| @{Stat:NetworkQuality:Global} | Minimum value between ingress and egress |
| Receive statistics | |
| @{Stat:Rtp:Rx} | Summary of the Rx stats: (Packets;CNPackets;SignalingPackets;Errors;MOS:Ingress) |
| @{Stat:Rtp:Rx:Packets} | Number of packets received from the IP network (audio + comfort noise + signaling) |
| @{Stat:Rtp:Rx:VoicePackets} | Number of voice (audio) packets received from the IP network |
| @{Stat:Rtp:Rx:VoiceBytes} | Number of payload bytes from voice (audio) packets received from the IP network |
| @{Stat:Rtp:Rx:CNPackets} | Number of comfort noise packets received from the IP network |
| @{Stat:Rtp:Rx:SignalingPackets} | Number of signaling packets (like "Telephony events") received from the IP network |
| @{Stat:Rtp:Rx:IPPackets} | Number of packets received from the IP network |
| @{Stat:Rtp:Rx:IPBytes} | Number of bytes received from the IP network |
| @{Stat:Rtp:Rx:RFC2833Tones} | Number of RFC2833 tones received from the IP network, and played back to TDM |
| @{Stat:Rtp:Rx:RedundantPackets} | Number of redundant packets received from the IP network (same sequence number received more than once) |
| @{Stat:Rtp:Rx:MeanPower} | Mean audio power (from IP to TDM direction), in dBov (0 the loudest, negative is softer level). Available only for calls with Echo cancellation enabled, thus only TDM<->IP calls. |
| @{Stat:Rtp:Rx:VoiceDuration} | Duration (in seconds) of voice (audio), from IP to TDM direction |
| @{Stat:Rtp:Rx:PlayoutDelay} | Current IP to TDM audio delay in millisecond (adaptive jitter buffer delay) |
| @{Stat:Rtp:Rx:MaxPlayoutDelay} | Maximum (for the whole call) IP to TDM audio delay in millisecond (adaptive jitter buffer delay) |
| @{Stat:Rtp:Rx:SsrcChanges} | Number of changes of "SSRC" RTP header value (counting initial SSRC received as one) |
| @{Stat:Rtp:Rx:Concealments} | Number of times decoder made audio concealment to preserve audio continuity (frequent upon first packet of a call, or after RFC2833 tones) |
| @{Stat:Rtp:Rx:Echo:ERLLevel} | Attenuation of a signal from the received-out port to the send-in port of an echo canceller |
| @{Stat:Rtp:Rx:Error:BufOverflows} | Number of packets dropped due to jitter buffer adaptation (to keep play-out delay low) |
| @{Stat:Rtp:Rx:Error:SeqErrors} | Number of sequence errors detected among packets received from the IP network |
| @{Stat:Rtp:Rx:Error:BadPackets} | Number of packets received with invalid header, or other error preventing proper audio decoding |
| @{Stat:Rtp:Rx:Error:RFC2833BadPackets: | Number of RFC2833 signaling packets that could not be properly decoded |
| @{Stat:Rtp:Rx:Error:LatePackets} | Number of packets that arrived after the moment they should have started to be played-out to TDM |
| @{Stat:Rtp:Rx:Error:LostPackets} | Number of packets considered "lost" (never received for play-out to TDM) |
| @{Stat:Rtp:Rx:Errors} | Total of all "Rtp:Rx:Error:" statistics above |
| Transmit statistics | |
| @{Stat:Rtp:Tx} | Summary of the Tx stats: (Packets;CNPackets;SignalingPackets;Errors;MOS:Egress) |
| @{Stat:Rtp:Tx:Packets} | Number of packets sent to the IP network (audio + comfort noise + signaling) |
| @{Stat:Rtp:Tx:VoicePackets} | Number of voice (audio) packets sent to the IP network |
| @{Stat:Rtp:Tx:CNPackets} | Number of comfort noise packets sent to the IP network |
| @{Stat:Rtp:Tx:SignalingPackets} | Number of signaling packets (like "Telephony events") sent to the IP network |
| @{Stat:Rtp:Tx:IPPackets} | Number of packets sent to the IP network |
| @{Stat:Rtp:Tx:IPBytes} | Number of bytes sent to the IP network |
| @{Stat:Rtp:Tx:RFC2833Tones} | Number of RFC2833 tones sent to the IP network (relaying corresponding detected TDM tones) |
| @{Stat:Rtp:Tx:MeanPower} | Mean audio power (from TDM to IP direction), in dBov (0 the loudest, negative is softer level). Available only for calls with Echo cancellation enabled, thus only TDM<->IP calls. |
| @{Stat:Rtp:Tx:VoiceDuration} | Duration (in seconds) of voice (audio), from TDM to IP direction |
| @{Stat:Rtp:Tx:Echo:ACOMLevel} | Attenuation of a signal from the receive-out port to the send-out port of an echo canceller |
| @{Stat:Rtp:Tx:Error:LostPackets} | Number of packets considered "lost" by remote side (only available if RTCP is used) |
| @{Stat:Rtp:Tx:Error:ArpFailure} | Number of failures to ARP remote IP address to send RTP packets to (preventing sending any packets) |
| @{Stat:Rtp:Tx:Errors} | Total of all "Rtp:Tx:Error:" statistics above |
| RTCP statistics (only if RTCP is enabled on the profile) | |
| @{Stat:Rtcp} | Summary of the Rtcp stats: (Packets;LostPackets;Jitter) |
| @{Stat:Rtcp:Packets} | Number of packets reported as received by remote equipment |
| @{Stat:Rtcp:LostPackets} | Number of packets reported as lost by remote equipment |
| @{Stat:Rtcp:Jitter} | Inter-packet interval jitter, in millisecond |
| @{Stat:Rtcp:RoundTripDelay} | Round-trip delay in milliseconds. Requires extended RTCP (XRTCP) to be enabled. |
| T38 statistics | |
| @{Stat:T38:StateChanges} | Number of T.38 state changes, through T.30 negotiation between FAX machines |
| @{Stat:T38:Rx | Summary of the T.38 Rx stats: (Pages;Packets;Errors) |
| @{Stat:T38:Rx:Pages} | Number of FAX pages received from T.38 packets from the IP network |
| @{Stat:T38:Rx:Packets} | Number of T.38 packets received from the IP network |
| @{Stat:T38:Rx:Bytes} | Number of T.38 payload bytes from T.38 packets received from the IP network |
| @{Stat:T38:Rx:Duration} | Duration of the T.38 session from IP to TDM |
| @{Stat:T38:Rx:PlayoutDelay} | Current IP to TDM audio delay in millisecond (re-modulation and jitter buffer delay) |
| @{Stat:T38:Rx:MaxPlayoutDelay} | Maximum IP to TDM audio delay in millisecond (re-modulation and jitter buffer delay) |
| @{Stat:T38:Rx:Error:BufOverflows} | Number of packets dropped because "from IP" jitter buffer is full |
| @{Stat:T38:Rx:Error:BufUnderflows} | Number of times T.38 re-modulation to TDM had no data (received from IP) to re-modulate |
| @{Stat:T38:Rx:Error:SeqErrors} | Number of sequence errors detected among packets received from the IP network |
| @{Stat:T38:Rx:Error:BadPackets} | Number of packets received with invalid header, or other error preventing proper audio decoding |
| @{Stat:T38:Rx:Errors} | Total of all "T38:Rx:Error:" statistics above |
| @{Stat:T38:Tx} | Summary of the T.38 Tx stats: (Pages;Packets) |
| @{Stat:T38:Tx:Pages} | Number of FAX pages received from TDM, sent to T.38 packets to the IP network |
| @{Stat:T38:Tx:Packets} | Number of T.38 packets sent to the IP network |
| @{Stat:T38:Tx:Bytes} | Number of T.38 payload bytes from T.38 packets sent to the IP network |
| @{Stat:T38:Tx:Duration} | Duration of the T.38 session from TDM to IP |
| @{Stat:T38:FromTdm:MeanPower} | Mean audio power received from TDM side, in dBov (0 the loudest, negative is softer level) |
| TMS-IP statistics (only for calls joined to a call leg on another adapter, and that used TMS-IP to carry audio from one adapter to the other) | |
| @{Stat:TmsIp} | Summary of the TMS-IP stats: (Packets;Errors) |
| @{Stat:TmsIp:Packets | Number of TMS-IP packets received from the other joined call leg |
| @{Stat:TmsIp:Bytes | Number of TMS-IP bytes received from the other joined call leg |
| @{Stat:TmsIp:Duration | Duration (in seconds) of the TMS-IP connection |
| @{Stat:TmsIp:Error:BufOverflows | Number of TMS-IP packets dropped due to jitter buffer overflow |
| @{Stat:TmsIp:Error:SeqErrors | Number of TMS-IP packet sequence errors detected among packets received from the IP network |
| @{Stat:TmsIp:Error:BadPackets | Number of TMS-IP packets received with invalid header, or other error preventing proper audio decoding |
| @{Stat:TmsIp:Error:LatePackets | Number of TMS-IP packets that arrived too late, causing jitter buffer underrun |
| @{Stat:TmsIp:Error:LostPackets | Number of TMS-IP packets considered "lost" (never received) |
| @{Stat:TmsIp:Errors} | Total of all "TmsIp:Error:" statistics above |
| Field name | Description |
|---|---|
| Receive statistics | |
| @{ErrorSummary} | Summary of reported leg errors in a pre-defined format: FromNetwork(NoPackets;ExcessivePackets;ExcessivePayloadTypeChanges;ExcessiveIpPortChanges;ExcessiveSsrcChanges) ToNetwork(NoPackets) For customized format, use other variables below. |
| @{Error:FromNetwork} | Summary of the leg errors 'from network': (NoPackets;ExcessivePackets;ExcessivePayloadTypeChanges;ExcessiveIpPortChanges;ExcessiveSsrcChanges) |
| @{FromNetwork:NoPackets} | When '1', no packets received from the network in the last few seconds, while packets were expected. |
| @{Error:FromNetwork:ExcessivePayloadTypeChanges} | When '1', excessive payload type changes were detected in the last few seconds. Payload type changes will be ignored. Packets may be dropped. |
| @{Error:FromNetwork:ExcessiveIpPortChanges} | When '1', excessive remote IP/Port changes were detected in the last few seconds. Received packets will be dropped. |
| @{Error:FromNetwork:ExcessiveSsrcChanges} | When '1', excessive remote SSRC changes (SSRC field in RTP packets header) were detected in the last few seconds. Received packets will be dropped. |
| @{Error:FromNetwork:ExcessivePackets} | When '1', excessive packets/bytes rate was received from the network. All packets will be dropped. |
| @{Error:ToNetwork} | Summary of the leg errors 'tonetwork': (NoPackets) |
| @{Error:ToNetwork:NoPackets} | When '1', no packets were sent to network in the last few seconds, while we were supposed to send packets (remote IP not reachable?) |
