Configuring logs
This topic describes how to configure logs. For information about the available logs, see Contents of the logs.
Log configuration files
The following files configure logging:
Configuration file | Location | Description |
---|---|---|
logback-dwp.xml | /Apache Software Foundation/Tomcat8.0/external-conf/ | Configures dwp.log. Edit this file to configure log levels, file size, type of logging, and other settings. The logging mechanism supports multiple logging levels:
For detailed information about the logback-dwp.xml file, see the
LOGBack documentation
|
logback_server.xml | <InstallDir>/SmartITMyIT/conf | Configures bundle.log. Edit this file to configure log levels, file size, type of logging, and other settings. The logging mechanism supports multiple logging levels:
For detailed information about the logback_server.xml file, see the
LOGBack documentation
|
Best practice
Note
The following video shows an older version of BMC Digital Workplace . The previous product name was MyIT. Although there might be minor changes in the UI, the overall functionality remains the same.
To set the log level
Events are logged in dwp.log. To set the log level, perform the following steps:
- From the BMC Digital Workplace server, open the logback-dwp.xml file in C:\Program Files\Apache Software Foundation\Tomcat8.0\external-conf.
- Find the following line for the default logger, and change the level to
DEBUG
:<logger name="com.bmc.bsm" level="INFO">
<appender-ref ref="FILE"/>
</logger>
- Find the following line for the error logger, and change the level to
DEBUG
:<logger name="ERROR" level="INFO" additivity="false">
<appender-ref ref="ERROR-FILE"/>
</logger>
As needed, set the logging for other components to debug:
Debug settings<!--Optional SQL LOGGER--> <if condition='${LOG_SQL_STATEMENTS}'> <then> <!-- SQL LOGGER --> <logger name="SQL" level="DEBUG" additivity="false"> <appender-ref ref="SQL-FILE"/> </logger> </then> </if> <!--Optional annotated code logger--> <if condition='${LOG_ANNOTATED}'> <then> <logger name="ANNOTATED" level="DEBUG" additivity="false"> <appender-ref ref="ANNOTATED-FILE"/> </logger> </then> </if> <!--Optional Globalsearch logger--> <if condition='${LOG_GLOBALSEARCH}'> <then> <logger name="com.bmc.bsm.myit.service.globalsearch" level="DEBUG" additivity="false"> <appender-ref ref="GLOBALSEARCH-FILE"/> </logger> </then> </if> <!--Optional Social logger--> <if condition='${LOG_SOCIAL_RESPONSES}'> <then> <logger name="social.server.debug.logger" level="DEBUG" additivity="false"> <appender-ref ref="SOCIAL-FILE"/> </logger> </then> </if> <!-- Measure performance --> <logger name="instrumentation" level="DEBUG" additivity="false"> <appender-ref ref="PERF-FILE"/> </logger>
- Save the file and restart the Tomcat server.
To configure self-managing logs
The dwp.<timeStamp>.part.n.log logs are self-managing according to the settings in logback.xml file.
- From the BMC Digital Workplace server, open the logback-dwp.xml file in C:\Program Files\Apache Software Foundation\Tomcat8.0\external-conf.
- In the header of the file, modify the following settings:
- Log file size limit - When the maximum defined log file size is reached, a new log file is created, and the n counter in the log file name is incremented to n+1.
- Daily or time based rollover
- Period for number of time-based rollovers
- Save the file and restart the Tomcat server.
To configure logging history
The dwp.log files record history according to the properties defined in the logback-dwp.xml file.To configure logging history, perform the following steps:
- From the BMC Digital Workplace server, open the logback-dwp.xml file in C:\Program Files\Apache Software Foundation\Tomcat8.0\external-conf.
As needed, configure the following properties to configure the period of time and log file size limit:
<!-- Period of time. Keep history for number of time based rollovers --> <property name="MAX_HISTORY" value="60"/> <!-- Log file size limit --> <property name="LOG_FILE_SIZE" value="20MB"/>
- Save the file and restart the Tomcat server.
Comments
Log in or register to comment.