Operational modes

Last Updated : Apr 25, 2023 |

Non real-time mode

The tool starts with at least one file in the command line parameters. The tool automatically detects the type of files, processes the files, and finally displays messages from the different files in one diagram ordered by the timestamp. If filters are set, only the messages that match the filters are displayed in the diagram. In this mode, enabling live capture is not an option.

Examples:

traceSBC tracesbc_sip_1408635251

traceSBC /archive/log/tracesbc/tracesbc_sip/tracesbc_sip_1408635251 archive/log/tracesbc/tracesbc_ppm/tracesbc_ppm_1408633429

Real-time mode

In this mode, traceSBC runs interactively. You must run traceSBC on the active SBC and without specifying a file in the command line parameters. When you run traceSBC, the tool opens, displaying a list of options at the bottom of the screen. Those options are described in User interface elements and options.

Once you start the trace, the system automatically starts processing the log files. The live capture can be started and stopped anytime without affecting service.

Automatic mode

In this mode, traceSBC must be on the SBC and the command is called with -a and -w parameters at a minimum.

Example:

traceSBC -a "sip|ppm" -w /tmp/trace.log

Use this mode for test automation. You can also use this mode to stop capture when a certain condition is met, and then save filtered messages automatically. Multiple stop triggers are present, such as number of packets, time, regular expression, and a combination of these. When a stop trigger fires, or when you press CTRL+C, the tool automatically saves the filtered messages and stops the captures.