Product Log Files

OpsCx for IBM Tivoli records actions performed by its event and topology integration services into log files. Occurrences of unexpected behavior are also added as entries into the log files. You can use the logged information to investigate issues.

Log Files Location

OpsCx for IBM Tivoli creates and maintains log files in the <OvDataDir>/log directory.

There is one log file for each integrated IBM Tivoli aspect (events, topology) as follows:

HPBsmIntTivoli-event.<Date>.log

HPBsmIntTivoli-metric.<Date>.log

HPBsmIntTivoli-topology.<Date>.log

To change location of the log file for a particular integrated IBM Tivoli entity type, perform these steps:

1. Change the current directory to <OvDataDir>/conf/HPBsmIntTivoli/genint and open the appropriate integration configuration file (event_integration.conf, metric_integration.conf, or
   topology_integration.conf) in a plain text editor.

2. In the genintd section, change the value of the log-file option. Preserve the %d placeholder in the log file name.

3. Save your changes.

4. Restart the affected integration service as described in Restarting the Services topic.

There are also log and trace files originating from the event backward synchronization. To change their location, edit the logfile and tracefile options in the event backward synchronization configuration file. See Configuring the Event Backward Synchronization topic.

Logging Severity Levels

Log entries have different severity levels. In OpsCx for IBM Tivoli, the following levels are available:

Severity Level	Keyword	Meaning
0	No Log	logging is disabled
1	Error, Config	errors, current values of integration configuration options
2	Info, Warning	information messages, warnings
3	Trace	tracing (debugging) messages

By default, the logging severity level is set to 1 (internal default), which means only errors and configuration-related messages are logged. For troubleshooting purposes, you can change the level.

When a particular logging level is set, it causes messages with lower severity level to be recorded as well. For example, if the severity level is set to 2, information messages, warnings, errors, and configuration-related messages are logged, but tracing messages are not.

To change the logging severity level for an integrated IBM Tivoli entity type, perform these steps:

1. Change the current directory to <OvDataDir>/conf/HPBsmIntTivoli and open the appropriate integration configuration file in a plain text editor.

2. In the genintd section, perform the following:

   1. Uncomment the line with the log-level option.

   2. In the same line, replace the value placeholder in quotation marks with the chosen logging severity level.

   For example, to change the logging severity level from the default level to 2, change the line

   // "log-level" : "3",

   to

   "log-level" : "2",

3. Save your changes.

4. Restart the affected integration service as described in Restarting the Services topic.

Related topics

Restarting the Services

Configuring the Event Backward Synchronization