This section presents details about working with log files for the following components:
Working with Real User Cloud Probe log files
BMC recommends the following settings to control logging for a
The macro unmigrated-inline-wiki-markup from Confluence is no longer available.
. For complete logging options and details, refer to the deployment documentation for Red Hat Enterprise Linux.
Setting the logging level for the Cloud Probe
- On the virtual machine with the Cloud Probe, log in as root.
- To stop the rsyslog service, run the following command:
/etc/init.d/rsyslog stop - Open the /etc/rsyslog.conf configuration file.
To save messages to the Cloud Probe log file, probe, add the following lines to the end of the RULES section:
# Save Probe messages to the probe log
local5.info /var/log/probe
- Start the rsyslog service by running the following command:
/etc/init.d/rsyslog start
Creating and modifying rotation rules for the Cloud Probe log
After you set the logging level, you can rotate the log files based on age or size.
- On the virtual machine with the Cloud Probe, log in as root.
- In the /etc/logrotate.d directory, create a new file named probe.
Add the following lines for the Cloud Probe rotation rules, and modify the options. (For details, refer to Red Hat Linux documentation.)
/var/log/probe
{
daily
copytruncate
rotate 4
missingok
create 0600 root root
}
- daily — rotates the log file every day
- copytruncate — creates a copy of the original log file and truncates the original file (probe)
- rotate 4 — limits the number of log file rotations, creating backup files
- missingok — continues without an error message if the the log file is missing
- create 0600 root root — (optional) creates a copy of the original log file, with specified permissions and groups
- (Optional) You can check (debug) the rotation settings by running the following command:
logrotate -d /etc/logrotate.conf
The command tests the settings without actually rotating files.
Working with BMC TM ART log files
The following major log files are used by the integration with BMC TM ART. These files are stored in root/data/var/opt/victor/log.
- tmart-Integration-web-bundle.log for information about the interaction between the Configuration page and the dashlets
- tmart-Integration-java-bundle.log for information about the BMC TM ART Integration internal logic
- tmart-ws-client.log for information about the connections and interaction with BMC TM ART
You can control logging settings for these log files, as described in the following tasks.
To set the log level in the tmart-integration-web-bundle.log file
- Locate the BMC TM ART Integration plugin in root/data/var/opt/victor/plugins and save a backup of the plugin file.
- Using a utility for manipulating archives (such as 7-Zip), open the plugin archive.
- Within the archive, navigate to the bundles\tmart-integration-web-bundle<build name and number>.war\WEB-INF\classes\logback.xml file.
- Open the logback.xml file, and set the logger level property to the relevant log level, as in the following line:
<logger level="DEBUG" name="tmart-integration-web-bundle.event">
You can choose from the following log levels (listed in descending order of detail):- ALL
- TRACE
- DEBUG
- INFO (the default)
- ERROR
- OFF
- Save your changes in the logback.xml file and repackage it in the plugin archive file.
- Restart the BMC Application Performance Management Console.
To set the log level in the tmart-integration-java-bundle.log file
- Locate the BMC TM ART Integration plugin in root/data/var/opt/victor/plugins and save a backup of the plugin file.
- Using a utility for manipulating archives (such as 7-Zip), open the plugin archive.
- Within the archive, navigate to the bundles directory > Java bundle .jar file > logback.xml file.
- Open the logback.xml file, and set the logger level property to the relevant log level, as in the following line:
<logger level="DEBUG" name="tmart-integration-java-bundle.event">
You can choose from the following log levels (listed in descending order of detail):- ALL
- TRACE
- DEBUG
- INFO (the default)
- ERROR
- OFF
- Save your changes in the logback.xml file and repackage it in the plugin archive file.
- Restart the BMC Application Performance Management Console.
To control logging in the tmart-ws-client.log file
Through the tmart-ws-client-log4j.properties file, found in root/data/var/opt/victor/conf/props, you can control various aspects of the logging in the tmart-ws-client.log file. In this properties file, you can configure the following main properties:
| | |
---|
| | The level of detail in the log based on message severity. Messages at the level that you specify or at any more severe level are written to the log file.
You can choose from the following log levels (listed in descending order of detail): - ALL
- TRACE
- DEBUG
- INFO (the default)
- ERROR
- OFF
|
| | Maximum size of the log file, in megabytes. When this size is reached, the current log file is renamed with the addition of a numerical extension and a new log file is created.
The default is 10 megabytes. |
Number of backup log files | | Maximum number of backup log files to create before deleting the oldest.
The default is 10 log files in the log rotation cycle. |