6.2.1 Setting user-defined records for collecting performance console counter information

To specify user-defined records for collecting performance console counter information:

From the Windows Start menu, start the collection data addition utility.

Note: displaying product names

The service name displayed in the main window can be replaced with the product name by selecting Product Name Display from the View menu of the collection data addition utility.

- Normal display

Agent Store: TS1 host-name

Agent Collector: TA1 host-name

- Product name display

Agent Store: host-name<Windows>(Store)

Agent Collector: host-name<Windows>

For details about the product name display functionality, see the chapter explaining the functionality in the JP1/Performance Management Planning and Configuration Guide.
From the tree area, select the Agent Store for the currently logged-in host, and in the list area, right-click the Agent Collector icon and choose PI_GENI/PD_GEND Records Add/Confirm/Delete.

The following shows the PI_GENI-PD_GEND Record Settings dialog box.
From Object, select the data object to be collected.

When a data object is selected, the data counter that can be set for the selected data object is displayed in Counter. Data instances (multi-instance objects) that can be set are displayed in Instance.

If the selected object is a single-instance object, there is no data instance that can be set, and thus nothing is displayed in Instance.

The data objects selected here are stored in the Object Name (OBJECT_NAME) field of a user-defined record.
From Counter, select the data counter to be collected.

Multiple data counters can be selected and deselected by clicking with the Ctrl key pressed. When a data counter is selected, an explanation for the selected data counter is displayed in Counter description.

The data counter selected here is stored in the Counter Name (COUNTER_NAME) field of the user-defined record.

Note that Counter displays only data counters that can be collected by the collection data addition utility. The data counters that can be collected by the collection data addition utility correspond to the following performance counters. For details about the relationship between data counters and performance counters, contact Microsoft Corporation.
- 100nSec Multi Timer
- 100nSec Multi Timer Inv
- 100nSec Timer
- 100nSec Timer Inv
- Average Bulk
- Average Timer
- Counter 100nSec Queuelen
- Counter Bulk Count
- Counter Counter
- Counter Delta
- Counter Large Delta
- Counter Large Queuelen
- Counter Large Rawcount
- Counter Large Rawcount Hex
- Counter Multi Timer
- Counter Multi Timer Inv
- Counter Object Time Queuelen
- Counter Queuelen
- Counter Rawcount
- Counter Rawcount Hex
- Counter Text
- Counter Timer
- Counter Timer Inv
- Elapsed Time
- Large Raw Fraction
- Object Time Timer
- Precision 100nSec Timer
- Precision Object Timer
- Precision System Timer
- Raw Fraction
- Sample Counter
- Sample Fraction
From Instance, select the data instance to be collected.

Multiple items displayed in Instance can be selected and deselected by clicking with the Ctrl key pressed. The data instance selected here is stored in the Instance (INSTANCE) field of the user-defined record.

If no data instance is displayed, it means that there is no data instance that can be set. Proceed to step 6.
Select PD_GEND or PI_GENI in Record.

Select PD_GEND to collect performance values for PD_GEND records.

Select PI_GENI to collect performance values for PI_GENI records.
Click the Add button.

The objects, counters, and instance information displayed in Counter-increment is reflected in Incremented Counter. The performance data reflected in Incremented Counter is set in the user record as a collection target.
To add more performance data to be collected to the user-defined record, repeat steps 3 through 7.
When finished, click the Close button.

The PI_GENI-PD_GEND Record Settings dialog box is closed.

Important

There are no limits to the number of objects, counters, and instances that can be added to the performance data to be collected. However, if too large a number is set, data collection by PFM - Agent for Platform might overburden the system or might require an excessively large amount of disk space. A total value of approximately 100 should typically be used as the upper limit.
Performance console counter information functions under WOW64. Objects that do not support WOW64 are not displayed in the Add Record window of the collection data addition utility. PI_GI64 and PD_GD64 records must be used to collect 64-bit performance console counters. For details about the PI_GI64 and PD_GD64 records, see 8. Records.

For details about how to specify whether to store the user-defined records set here in a database, see the chapter explaining the management of operation monitoring data in the JP1/Performance Management User's Guide.

To Page Top