Skip to main content

Windows Performance Monitor

This monitor type uses Windows Performance Monitor to collect measurements from a monitoring target running Microsoft Windows.

Add Monitors Wizard in Eggplant Performance

For information about the Poll Interval and Injector fields, please refer to Connection settings.

It is important that the monitor process (started by the injector) runs as a Windows user account which has access to Windows Performance Monitor on the monitoring target. The user account might be a member of the Administrators group or of the Performance Monitor Users group. For more information, see Overview of Windows Performance Monitor.

The Eggplant Performance Windows Performance Monitor uses a Perfmon API to collect measurements. If you are having trouble connecting to the monitoring target, try running perfmon.exe on the injector machine and configuring a remote connection in that. If you can set up remote access to Performance Monitor from the injector machine, then the Eggplant Performance Windows Performance Monitor should work.

note

You might need to open TCP port 445 on any firewalls between the injector machine and the monitoring target.

How to Run the Injector as the Right User Account

In each of these different sets of instructions, the path to the batch files might be different depending on how Eggplant Performance was installed. Also, the 39000 port parameter might need to change depending on the port selected in the injector definition in Eggplant Performance Studio.

Log into the Injector Machine as a User with Correct Permissions

Simply run the injector software:

  1. Open a command window (cmd.exe), and enter:
"C:\Program Files (x86)\Eggplant Performance Injector\bin\runInjector.bat" 39000

OR:

  1. On the Start menu, click Eggplant Performance\Injector\Start injector

  2. Select the Use injector user account option when configuring the monitor.

Start the Injector Software as a User with Correct Permissions

If you cannot log into the injector machine with the right user, you can try to start the software using a different user account.

  1. Open a command window (cmd.exe), and enter:

    runas /user:domain\username "C:\Program Files (x86)\Eggplant Performance Injector\bin\runInjector.bat 39000"

    You might be prompted for the user's password before the injector will start.

  2. Select the Use injector user account option when configuring the monitor.

Run the Injector as a Service and Change the Log on User

Run the injector software as a service:

  1. Open a command window (cmd.exe), and enter:

    "C:\Program Files (x86)\Eggplant Performance Injector\bin\installInjectorService.bat"

or...

  1. On the Start menu, click Eggplant Performance\Injector\Install injector service

  2. In Control Panel, open Administrative tools, and then open Services.

  3. Locate the service named Eggplant Performance Injector Service, right-click it and then click Properties.

  4. On the Log On tab, select This account and enter the required credentials.

Select the Use injector user account option when configuring the monitor.

Allow the Monitor to Impersonate a User with Correct Permissions

If you cannot get the injector to run as the correct user, then select the Impersonate a user option on the Connection Settings page of the Add Monitors wizard (or in the Monitoring Profile view). Enter the username and password of the user account. If the user account is a Windows domain account, then enter the domain, otherwise leave the domain field blank.