User interface elements and options

Last Updated : Dec 07, 2020 |

Window header

The window header shows the hostname, the name of the script, the number of captured messages, and the number of displayed messages that matched the filters. The header also displays warning messages such as MAX NUM PACKETS 10000 EXCEEDED.

Status bar

The status bar on the bottom of the screen is the most important and most used part of the tool. The bottom line has two areas, and its content depends on which mode the tool is in. The left side of the status bar shows the filename in nonreal-time mode, or shows Multiple files when the tool was called with more than one file. In real-time mode, this area shows which trace is active. Red means disabled, and green means enabled.

The rest of the status bar lists the available commands:

s=Start / s=Stop : Starts or stops live capture, which means the tool enables or disables the appropriate logging. Capture can be enabled for SIP and PPM individually. Stop disables all logging at the same time and stops processing the log files. This command shows only if the tool was started in real-time mode.

Note:

Depending on the traffic and the capture modes at the time of stopping the trace, the log files might contain more messages than the messages already captured by the tool.

q=Quit: Quit from the tool. If capture is running, the tool shows a pop-up to confirm the exit without stopping the logging.

w=Write: Export filtered messages to a file. The dialog prompts you for a filename. The system saves SIP messages in the specified file to the current directory. The system saves PPM messages in a separate file with a .ppm extension. The system also exports SIP messages in pcapng format to a file with a .pcapng extension. SIP messages can be exported if text2pcap and tshark utilities are available on the machine where you run traceSBC.

i=IP / i=Name: Toggle between IP and user name presentation of the hosts in the header of the ladder diagram.

r=RTP: Turn RTP simulation on or off. When a session is established early or confirmed, the tool inserts a line in the diagram. This line represents the RTP stream between the two hosts described by the SDP. The diagram also shows the negotiated codec type.

Note:

The RTP stream is created based on the negotiated information in SDP. However, there is no guarantee that these RTP streams come to the system.

u=Full Screen: Use the full screen for the message detail box without having the left and right side of the frame. This option is useful not only to see more about the message, but to easily copy or paste the content.

d=Calls: Shows the summary of all calls.

Ladder diagram

The ladder diagram displays the filtered messages. The arrow shows the direction of the message between the SBC and the host from where the message arrived or was sent to. The IP of the host is at the top of the column. If the host is an Avaya phone, traceSBC attempts to extract the user information from the message, and replaces the IP with the user handle. To navigate between the messages, use the UP/DOWN arrow keys. The message is highlighted. To see the details of the message, press Enter. The header of the message detail form shows the source and destination IP or port and the transport protocol.