Controlling and reviewing debug logs

Whenever you need to troubleshoot the BMC TM ART Adapter, you can turn on the generation of debug log files that record the adapter's actions. The created log files are stored on the BMC TrueSight Infrastructure Management Server, in the installationDirectory\pw\pronto\logs\debug directory. The following debug log files are available:

Debug log file	Description
DetailDiagnostics.log	Records data to be displayed in Detailed Diagnostics windows. For the BMC TM ART monitors, the log records information about the Page Timers and the Run Now + TrueLog Detailed Diagnostics processes.
TMARTAdaptor.log	Records processes, data, and data collection verification or errors encountered with BMC TM ART Central.
TMARTAdaptorDataCollector.log	Records information regarding the overall data collection process
TMARTAdaptorDataCollector2.log	Records information from BMC TM ART Central's responses to data collection.
TMARTAdaptorAutoDiscovery.log	Records data about the auto-sync process. The log is updated when the auto-sync process runs, that is, when you add or edit an adapter instance, and when an auto-sync is scheduled (every 24 hours by default).
TMARTAdaptorDemandPoll.log	Records data to be displayed in the FlashCheck window.

By default, the generation of debug log files is disabled. You turn on and control other aspects of the generation of debug logs through the Pw Commands window. The following CLI commands are useful:

Objective	CLI command
Turn on or turn off debugging	`pw debug <on/off> -a [agentName/IPAddress] -s [logName]` agentName: Host name of the remote agent as listed by `pw remote list` logName: The name of the debug log file, as listed in the table above
Set the number of days that data is collected	`pw log period <rate/baseline> <numberOfDays>` Default number of days for rate is 8, and for baseline is 30.
View the rate/baseline data retention period of a particular monitor	`pw log period list -<rate/baseline>monitorUniqueName]`
View the command history	`pw log list`
Retrieve log files from a remote agent	`pw debug file <agentName/IPAddress> [-x]` Pulls the log files from the remote agent and stores them as compressed .jar file on the BMC TrueSight Infrastructure Management Server, in the **installationDirectory/pw/pronto/agentlogs/agentName** directory. If `-x` is specified, the files are brought in their original uncompressed form.
List debug status	`pw debug list -a [agentName/IPAddress]`

Example

To turn on debugging in the BMC TM ART log files discussed above, run the following commands:

pw debug on -a <Agent_name> -s DetailDiagnostics
pw debug on -a <Agent_name> -s TMARTAdaptor
pw debug on -a <Agent_name> -s TMARTAdaptorDataCollector
pw debug on -a <Agent_name> -s TMARTAdaptorDataCollector2
pw debug on -a <Agent_name> -s TMARTAdaptorAutoDiscovery
pw debug on -a <Agent_name> -s TMARTAdaptorDemandPoll

For more information about CLI commands, see pw log and pw debug.

Page tree

Controlling and reviewing debug logs