Configuring VSTG Logging

Modify VSTG logging properties to control logging information.

You can make changes to the properties available in vstgproperties.txt file to control the logging information for desired results. For information on locating and accessing the vstgproperties.txt, see About VSTG Properties.

The VSTG log file names begin with the vtg prefixes, respectively. The names of debug-level logs, which have more detail than the console logs, begin with the vtg-dlog prefix.

Each Vocera SIP Telephony Gateway log statement has a preamble consisting of four sections:

The following table describes the VSTG logging properties that you can modify:

Property

Description

PJSIPLogLevel

Controls the level of logging from the PJSIP stack. Specify a value from 1 (least amount of logging) to 10 (greatest amount of logging). Generally, you should set this to 5 or lower unless you are experiencing problems. The default is 4.

VGWConsoleLoggingLevel

Sets the logging level for the console. Specify 0 to 8, 0 being the least amount of logging and 8 being the most. The default is 4.

0 = FATAL
1 = ERROR
2 = WARNING
3 = INFO
4 = DEBUG
5 = PJSIP
6 = SIP_MSGS
7 = DEBUG_VERBOSE
8 = RTP_INFO

If you specify 5 (PJSIP), the amount of PJSIP logging depends on the PJSIPLogLevel property.

VGWFileLoggingLevel

Sets the logging level for the log file. Specify 0 to 8, 0 being the least amount of logging and 8 being the most. See VGWConsoleLoggingLevel for the list of logging levels. The default is 4.

VGWMaxLinesPerLogfile

Sets the maximum size of each log file. The default is 70,000 lines.

VGWNumLogFilesToKeep

Sets the maximum number of log files to keep for the current gateway process. If you have plenty of disk space available and you do not want to delete older log files, you can set this property to 0. The default is 50.

Note: Each time the gateway service is stopped and started, it will create up to VGWNumLogFilesToKeep new log files.

VGWMaxDaysToKeepLogfiles

Sets the maximum number of days to keep log files for the current gateway process. The default is 21 days. When the Vocera SIP Telephony Gateway is started, it finds log files that have not been modified within the VGWMaxDaysToKeepLogfiles period, and it deletes those files. This keeps the logs directory from growing too large.

To preserve all log files and not automatically delete them, set VGWMaxDaysToKeepLogfiles to 0.

VTGLogMaxLines

Sets the maximum size of each VSTG console log file. This property does not affect the size of debug log files. The default is 100,000 lines.

VTGLogMaxFiles

Sets the maximum number of VSTG console log files. The default is 100 files.