Editing logging properties

This topic provides instructions on editing the logging properties for a TrueSight Network Automation application server.

You must have edit rights to be able to open the Edit Logging Properties page. The logging properties, taken from the BCAN_DATA\logging.properties file, are displayed in edit mode.

On the Admin > System Admin > Logging Properties page, click Edit and do the following:

1. (Optional) Edit the log levels for an item by changing the value in a line of the following type: 

   <logger class/component/package>.level=<LogLevel>

   Note

   You can remove a logging level line by adding a "#" in front of the line, changing the line to a comment line.

2. (Optional) Click Insert to add a property, and select one of the predefined property types from the drop-down menu:
   

   Note

   You can set the log level for these properties after you insert them into the file.

   • Device File Transfer Debug Properties: Adds lines that enable debugging of device data transfers, and ena-*.tmp files are not deleted. Refer to your device agent path settings to determine where these .tmp files are located.
   • Device Import XML File Debug Properties: Adds a line that enables debugging of device imports, and intermediate XML files are not deleted. The files can be found in the following directories:
     • C:\Windows\temp (Microsoft Windows)
     • BCA-Networks-Data/tmp (Linux)
   • Device Interaction Debug Properties: Adds lines that enable debugging of device interactions, including the data sent to and received from devices in the log in ASCII and binary formats, as well as some trace of command processing and property setting.
   • Profiling Properties: Adds a line that enables logging of memory usage every 5 seconds, and requests garbage collection every 2 minutes. For this logging method to work, the profileMemory global property must be enabled in the global.properties file. See Default-global-properties-file.
3. (Optional) Return the values in the logging.properties file to the default values by clicking Revert to Default.

4. Click Save to save and implement your changes to the logging properties for the application server.

   Note

   • When you modify logging properties in the Network Automation UI, the changes are enabled without having to restart the Network Automation web server service.
   • Modifying the logging properties in the Network Automation UI produces the same results as editing the BCAN_DATA\logging.properties file directly. However, when you modify the properties file directly, you must restart the Network Automation web server service to enable the changes.
   • Changes to the logging properties will be lost when you upgrade Network Automation. BMC recommends saving your modified logging.properties file before upgrade, and restoring your modified version after the upgrade.

How to video

For more information about editing the logging properties, watch the following video (03:34).

 https://www.youtube.com/watch?v=lWuMvC7jC4I