Troubleshooting Agent issues by using Windows tools


The following sections describe Microsoft Windows tools that you can use to troubleshoot issues related to Agents:

PerfMon 

PerfMon (perfmon.exe) is a performance monitoring tool that is shipped with Windows operating systems. It uses direct performance registry access to gather performance counters. When you run Perfmon, performance counters that are exposed by WMI high-performance providers are displayed. You can use this tool for debugging data collection issues. For example, if the Data Collection Status report shows that the Collector failed to collect a metric group, you can verify whether the metric group shows any data in PerfMon.

If an issue exists in the metric group, you can add the metric group in PerfMon and share the PerfMon log file along with historical UDR data with the BMC Support team.

Exctrlst 

Exctrlst (exctrlst.exe) is a tool from the Windows Resource Kit. It uses direct performance registry access to display the names and locations of the dynamic link libraries (DLLs) that support performance counters. If a metric group does not show up in PerfMon, you can run this tool to check whether the DLL responsible for the metric group is disabled or does not exist. If the DLL is disabled, you can enable it and restart the Agent and data collection request. If the DLL is not available, it indicates that the service or application that provides the DLL is not installed on the computer.

Event Viewer 

Event Viewer is an event monitoring tool that is shipped with Windows operating systems. This tool maintains logs about programs, security, and system events on your computer. If an issue exists in a metric group, you can check the logs to troubleshoot the issue. You can look for events with the identified source as perflib and verify whether any event indicates a critical failure.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

BMC Helix Continuous Optimization 22.3