Docs.bmc.com will undergo a brief maintenance outage 27 March 2025. The site will be unavailable for ten minutes starting at 6:30 AM CDT/5 PM IST.

  Important This documentation space contains information about PATROL Agents when deployed in a BMC Helix Operations Management environment. If you are a TrueSight Operations Management user, see PATROL Agent 23.1

Managing performance retrieval parameters

The agent allows you to manage certain aspects of how it gathers performance data on Windows systems. You can determine the following aspects:

  • The number of data values collected by the persistent data collection program (PatrolPerf.exe) before it restarts
  • The time for which the agent waits for a response from the persistent data collection program
  • The location to which the data collection program writes the debug information

Note

These parameters only apply to the PATROL Agent running on Windows systems.

Determining the maximum number of data points collected before restarting

The /AgentSetup/PerfGetMaxTimes agent configuration variable determines the number of data points that the persistent data collection program collects before it restarts itself. Zero (0) indicates that the program does not restart itself.

Establishing a timeout period

The /AgentSetup/PerfGetTimeout agent configuration variable determines how long the agent waits for a response from the persistent data collection program.

Specifying the debug file

The /AgentSetup/PerfGetDebugFile agent configuration variable specifies the file to which the persistent data collection program writes debug information. The agent creates this file only if a "serious" error occurs. The debug level, and thus the definition of "serious," is set internally. You cannot alter it.