Editing logging properties

This topic describes how to edit the logging properties for a BMC Network Automation application server.

To edit logging properties

1. Open the Edit Logging Properties page by navigating to Admin > System Admin > Logging in the BMC Network Automation UI, and clicking Edit.

   Note

   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.

   Note

   You should not edit any of the properties below the line that states Please do note edit anything below this line..

2. You can 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.

3. You can add properties by clicking Insert, and selecting 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.
4. You can return the values in the logging.properties file to the default values by clicking Revert to Default.

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

   Note

   • When you modify logging properties in the BMC Network Automation UI, the changes are enabled without having to restart the BMC Network Automation web server service.
   • Modifying the logging properties in the BMC 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 BMC Network Automation web server service to enable the changes.
   • Changes to the logging properties will be lost when you upgrade BMC Network Automation. BMC recommends saving your modified logging.properties file before upgrade, and restoring your modified version after the upgrade.

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