Overview
The SBC Core can trace SIPRec legs to assist in debugging various issues associated with SIPRec legs, such as:
- Missing media packets
- Missing Signalling packets towards SIP Recording Server (SRS) in debug (
.DBG
) logs - Crank back issues in QUAD SIPREC
As part of the enhancement, the flag sipRecLegsCapture
is introduced under the callFilter
parameter of the global callTrace
object.
When the main call is traced and SIPREC is invoked based on a matching criteria, if the flag sipRecLegsCapture
is set to enabled
:
- For single and DUAL SIPRec calls:
- The media packets of the main call's leg (non-SIPRec side) and the SIPRec legs are logged in
.PKT
file. - The
.TRC
file contains SIP Protocol Data Units (PDUs) for SIPRec calls, as well as tracing data of the main call (depending on the level of the trace).
- For QUAD SIPRec calls:
- Packets are not captured for the main call and the
.PKT
files do not have the media of the main call. However, media packets of the SIPRec legs are logged in the .PKT
files. - The
.TRC
file contains SIP PDUs for SIPRec calls, as well as tracing data of the main call (depending on the level of the trace).
Behavior of sipRecLegsCapture based on Call Trace Filter Level
The effect of enabling the flag sipRecLegsCapture
varies based on the level of the call trace filter, as described in the table below:
Caption |
---|
0 | Table |
---|
1 | Behavior of sipRecLegsCapture based on Call Trace Filter Level |
---|
|
Call Trace Filter level | State of sipRecLegsCapture flag | Result |
---|
Level 1/2/3 | enabled | If the main call is traced by the same call filter, the SBC captures SIPRec SIP PDUs in .TRC file and SIPRec legs Media in .PKT file. | Level 1/2/3 | disabled | The SBC captures neither SIP PDUs in .TRC file, nor media packets of the SIPRec legs in .PKT file. | Level 4 | enabled/disabled | SIP PDUs only for the specified peer IP are captured in .TRC file. If the peer IP is same as the SRS IP, all SIP PDUs from and towards that SRS are captured. If the peer IP is an end point, all SIP PDUs from and towards that end point are captured. If the peer IP is 255.255.255.255 , all SIP PDUs are captured. |
|
Content of PKT file based on SIPRec Criteria and Number of Simultaneous Sessions
If call trace is triggered for filter level 1, 2, or 3, the information captured in .PKT
file varies based on the SIPRec criteria and the number of simultaneous SIPRec sessions, as described in the table below:
Caption |
---|
0 | Table |
---|
1 | Content of PKT file based on SIPRec Criteria and Number of Simultaneous Sessions |
---|
|
SIPRec Recording Type | Number of simultaneous SIPRec sessions | State of sipRecLegsCapture flag | Information captured in PKT file |
---|
All legs/Ingress | 1 | enabled | Egress leg media packets of the main call, and media packets of SIPREC legs. | All legs/Ingress | 1 | disabled | Egress leg media packets of the main call. | All legs/Ingress | 2 (DUAL SIPREC) | enabled | Egress leg media packets of the main call, and media packets of SIPREC legs. | All legs/Ingress | 2 (DUAL SIPREC) | disabled | Egress leg media packets of the main call. | All legs/Ingress | 4 (QUAD SIPREC) | enabled | Media packets of only SIPREC legs. | All legs/Ingress | 4 (QUAD SIPREC) | disabled | No media packets are captured. | Egress | 1 | enabled | Ingress leg media packets of the main call, and media packets of SIPREC legs. | Egress | 1 | disabled | Ingress leg media packets of the main call. | Egress | 2 (DUAL SIPREC) | enabled | Ingress leg media packets of the main call, and media packets of SIPREC legs. | Egress | 2 (DUAL SIPREC) | disabled | Ingress leg media packets of the main call. | Egress | 4 (QUAD SIPREC) | enabled | Media packets of only SIPREC legs. | Egress | 4 (QUAD SIPREC) | disabled | No media packets are captured. |
|