Creating a performance monitoring agent - Perfmon Launch Configuration

 

Creating a Perfmon Launch Configuration

 

To launch a new Perfmon Agent using the Profiling Launch Configurations:

 

NOTE that all the agents (Windows, Linux, JBoss, and Jonas) work in exactly the same way and this help section details a Windows perfmon specific example.

 

  1. Make sure you have a Project in your workspace to hold the trace data
  2. Switch to the profiling perspective using Window > Open Perspective > Other > Profiling and Logging
  3. Open the Launch Configurations dialog using Run > Profile

 

Image showing launch configuration dialog

 

  1. Right-click on Host - Windows (Perfmon) and select New

 

PerfMon launch configuration tab

 

  1. Enter a name for the configuration in the Name: field
  2. Select the Project you wish to store the trace data in using the Browse button next to the Statistical Model container field
  3. Select the host to be used and (if necessary) click Apply, then Profile
  1. The Agent Controller must be running on the machine specified in Connect to this host.
  2. If the performance objects are required for the machine on which Hyades is actually running (i.e. localhost), you do not need to change any information in the dialog box.
  3. If the performance objects from a remote machine are required, select Connect to remote registry and type the name or IP address of the remote machine. Note : use the Perfmon format for specifying the remote machine, i.e. preceed the host name or IP address with double backslashes, e.g. "\\192.168.1.23" or "\\smithy".
  1. The Profiling Monitor view will open and after a short while you will see the agent appear

 

Profiling Monitor View and PerfMon Agent

 

  1. To configure the Perfmon counters you wish to trace, right click on the agent node select Configure Statistical Data Collection Counters. A counter configuration dialog will appear.

 

Profiling Monitor View and PerfMon Agent

 

 

Note : in the case of a performance trace node, only the highest level performance objects are initially displayed. These highest level performance object are typically not actually metrics, but rather containers for related metrics. To expose the actual metrics you must recursively request the children of a particular performance object until its metrics are displayed. To request the children of a performance object, select Get Child Counters from its pop-up menu and then wait for the "+" symbol to appear beside the performance object in the tree to indicate that its children have been retrieved.

 

Related concepts
Statistical Console

Related tasks
Creating a performance trace
Configuring performance objects
Starting and stopping a trace
Viewing statistical models
Perfmon Launch Configuration
Creating a new statcon file for performance trace

Related reference
Statistical Console graphs and tables