PerformanceGuard agents are typically installed on key computers that many users and business processes rely on. It's important that an agent doesn't affect the performance of the computer it's installed on. Agents therefore have a number of built-in features in order to protect the systems that they run on.

To make its measurements an agent collects information from many parts of the Windows operating system. This means that the agent will be affected if the operating system isn't performing well.

Service Recovery Handled by Windows SCM

The PerformanceGuard agent runs as a service. Service recovery is handled by Windows' Service Control Manager (SCM).

The service is installed with the following recovery options:

• First failure: Restart the service,
• Second failure: Restart the service,
• Subsequent failures: Take no action
• Reset count after: 10 minutes.

This means that the operating system will restart the agent a maximum of two times within 10 minutes if the agent service stops unexpectedly.

Agent Thread Checks

The various kinds of data collected by the agent are handled by a number of threads of execution, all hosted within the PerformanceGuard agent executable.

All the threads of execution within the agent are checked by a special monitoring thread.

A thread is either:

• Waiting for an event from another thread
• Waiting for a timer to expire
• Collecting measurements

Every time a thread wakes up from waiting, it signals to the monitoring thread. Likewise, a thread will signal to the monitoring thread before it begins to wait.

The monitoring threads keeps track of all other threads, and checks that they are all alive. A thread should not be collecting data for more than a few seconds without checking in with the monitoring thread.

Agent Memory Usage Checks

The PerformanceGuard agent regularly checks how much of the host computer's memory it uses. If the agent detects that it uses 60 MB or more of the host computer's RAM, the PerformanceGuard Agent service will automatically restart itself in order not to use excessive amounts of the computer's memory.

Such an agent restart will be logged, and you can view information about it in the message log for the computer in question. To view the message log, select ANALYZE > Computer Search, and search for a computer. Then, in the search results, click the name of the required computer, and then select the Message Log tab. In the log, agent restarts caused by memory usage will be listed with the name Agent restart caused by : Agent memory size exceeded.