Notes on records
Note the following points when collecting records.
- Organization of this page
Notes on cases in which record instances cannot be uniquely identified
PFM - Agent for Platform references the latest OS information at a given interval to collect performance data. If a record instance in a record field cannot be uniquely identified from the information acquired from the OS, one of the following two actions is performed:
-
A number #n (where n = 1, 2, 3, ...) is appended to the field.
The table below shows the record fields to which a number is appended.
Table 8‒10: Record fields to which a number is appended Record name
Field name
Event Log (PD_ELOG)
Source Name (SOURCE_NAME)
Generic Data Detail (PD_GEND)
Instance (INSTANCE)
Generic Data Interval (PI_GENI)
Instance (INSTANCE)
Logical Disk Overview (PI_LOGD)
ID (INSTANCE)
NBT Overview (PI_NBT)
Instance (INSTANCE)
Network Interface Overview (PI_NETI)
Instance (INSTANCE)
Page File Detail (PD_PAGF)
Instance (INSTANCE)
Physical Disk Overview (PI_PHYD)
ID (INSTANCE)
Process End Detail (PD_PEND)
Program (PROCESS_NAME)
Generic Data Detail64 (PD_GD64)
Instance (INSTANCE)
Generic Data Interval64 (PI_GI64)
Instance (INSTANCE)
When record instances cannot be uniquely identified from the information acquired from the OS, the performance data collected for each record instance is correct. In this case, however, the device corresponding to the instance (for example, the corresponding NIC for the Network Interface Overview (PI_NETI) record) cannot be identified.
-
For the PD_UPD, PD_UPDB, PI_UPI, PI_UPIB, and PI_XUI1 to PI_XUI5 records, the first instance of each record is used.
If the system environment has been modified, the integrity of the record instance cannot be guaranteed, and, as a result, correct real-time data updating and historical data summarization cannot be executed.
Notes on cases in which records cannot be collected and on the application event log
Notes on cases in which records cannot be collected
To use PFM - Agent for Platform to collect the performance data of the records listed below, the objects must be in a monitoring-enabled state on the performance console#. The table below shows the objects that correspond to various records, the source (service) names that are output in the event log, and the performance extension DLLs.
- #
-
You can check the object names that correspond to individual records in Performance Management. If objects corresponding to individual records do not exist, make the objects monitorable by following the procedure published in Microsoft Knowledge Base provided by Microsoft Corporation.
Category |
Record name (Record ID) |
Object name |
Source (service) output to event log |
Performance extension DLL |
---|---|---|---|---|
Disk |
Logical Disk Overview (PI_LOGD) |
LogicalDisk |
PerfDisk |
PerfDisk.dll |
Physical Disk Overview (PI_PHYD) |
PhysicalDisk |
|||
Protocol |
ICMP Overview (PI_ICMP) |
ICMP |
Tcpip |
perfctrs.dll |
ICMP Version 6 Overview (PI_ICM6) |
ICMPv6 |
|||
IP Overview (PI_IP) |
IP or IPv4 |
|||
IP Version 6 Overview (PI_IP6) |
IP or IPv6 |
|||
TCP Overview (PI_TCP) |
TCP or TCPv4 |
|||
TCP Version 6 Overview (PI_TCP6) |
TCP or TCPv6 |
|||
UDP Overview (PI_UDP) |
UDP or UDPv4 |
|||
UDP Version 6 Overview (PI_UDP6) |
UDP or UDPv6 |
|||
Network-related |
Network Interface Overview (PI_NETI) |
Network Interface |
Tcpip |
perfctrs.dll |
NBT Overview (PI_NBT) |
NBT Connection |
|||
WINS Server Overview (PI_WINS) |
WINS Server |
Wins |
winsctrs.dll |
|
Browser Overview (PI_BRSR) |
Browser |
PerfNet |
perfnet.dll |
|
Server Work Queues Overview (PI_SVRQ) |
Server Work Queues |
|||
System Overview (PI) |
Redirector |
|||
Server |
||||
OS in general (processor, memory, for example) |
System Overview (PI) |
Cache |
PerfOS |
PerfOS.dll |
Memory |
||||
Objects |
||||
System |
||||
Processor and Processor Information |
||||
Processor Overview (PI_PCSR) |
Processor |
|||
Page File Detail (PD_PAGF) |
Paging File |
|||
Process-related |
Process Detail (PD) |
Process |
PerfProc |
PerfProc.dll |
Process Detail Interval (PD_PDI) |
||||
Application Process Interval (PD_APSI) |
||||
Application Process Overview (PD_APS) |
||||
Application Summary (PD_APP) |
||||
Application Summary Extension (PD_APP2) |
||||
Application Process Detail (PD_APPD) |
||||
Process End Detail (PD_PEND) |
||||
Workgroup Summary (PI_WGRP) |
||||
Active Directory |
Active Directory Overview (PI_AD) |
Database |
ESENT |
esentprf.dll |
NTDS |
NTDS |
ntdsperf.dll |
||
DNS |
DNS |
dnsperf.dll |
||
General |
Generic Data Detail (PD_GEND) |
Objects set by the collection data addition utility |
Differs for each object. |
|
Generic Data Interval (PI_GENI) |
||||
Other |
Event Log (PD_ELOG) |
Not applicable |
(Not applicable) |
|
Device Detail (PD_DEV) |
||||
User Data Detail (PD_UPD) |
||||
User Data Detail - Extended (PD_UPDB) |
||||
User Data Interval (PI_UPI) |
||||
User Data Interval - Extended (PI_UPIB) |
||||
Service Process Detail (PD_SVC) |
||||
Application Service Overview (PD_ASVC) |
||||
User Data Interval - Expanded 1 (PI_XUI1) |
||||
User Data Interval - Expanded 2 (PI_XUI2) |
||||
User Data Interval - Expanded 3 (PI_XUI3) |
||||
User Data Interval - Expanded 4 (PI_XUI4) |
||||
User Data Interval - Expanded 5 (PI_XUI5) |
Application event logs when records cannot be correctly collected
If Perflib (the source (service) name common to all objects or the source (service) name of each object) is recorded in an application event log, PFM - Agent for Platform may not run normally, or it may not be possible to collect the records corresponding to that source (service) in some cases. If the application event logs described in the table below are recorded, re-install the source (service), eliminate the cause identified in Microsoft Knowledge Base provided by Microsoft Corporation, or ask the company that developed the source (service) about a corrective measure, and restore an environment in which no application event log is recorded. The table below shows examples of application event logs that are recorded when PFM - Agent for Platform does not run normally or the records corresponding to the source (service) cannot be collected.
Event ID |
Source (service) name |
Event log details |
---|---|---|
1008 |
Perflib# |
Service "service-name" (DLL "dll-name") could not be opened. Performance data for this service cannot be used. The returned status code is data DWORD 0. |
1009 |
Perflib# |
An exception occurred during the opening of the service "service-name" (DLL "dll-name"). Performance data for this service cannot be used. The returned status code is data DWORD 0. |
1010 |
Perflib# |
An exception occurred or an invalid status was returned during the collection of the service "service-name" (DLL "dll-name"). Performance data returned from the counter DLL is not returned to the performance data block. The returned exception or status code is data DWORD 0. |
1011 |
Perflib# |
The library file "dll-name" specified for the service "service-name" could not be opened. Performance data for this service cannot be used. The status code is data DWORD 0. |
2001 |
Perflib# |
Service "service-name" does not have a Performance subkey, or its key could not be opened. Performance counter is not collected for this service. The Win32 error code is returned as data. |
2002 |
Perflib# |
Opening of the service "service-name" with a DLL "dll-name" took longer than the established standby time. There may be an error in this extendable counter or the service that is collecting data, or the system may have been busy when this call was tried. |
2000 |
PerfDisk |
Logical volume information cannot be read from the system. The returned status code is data DWORD 0. |
- #
-
For details about application event logs output by Perflib that are not listed in the above table, see the Microsoft Knowledge Base.
Notes on records
-
Performance information for the following records cannot be collected in an Internet Protocol version 6 (IPv6) environment:
-
ICMP Overview (PI_ICMP)
-
IP Overview (PI_IP)
-
TCP Overview (PI_TCP)
-
UDP Overview (PI_UDP)
-
-
For those multi-instance records that have _Total in their instance names, the total value and average value for all instances are collected. If instance information is modified during a collection interval, value inconsistency may result.
-
If the system resource is changed during record collection, the Agent Collector service issues the following message to the common message log and does not collect records twice:
KAVF11406-W The system resources have been modified. (record-id)
-
PFM - Agent for Platform cannot handle values that are greater than the data types defined in the data model. If values that are greater than the data types defined in the data model are collected, accurate values cannot be displayed.
Notes on using the program name of a process
Data acquired from the Windows performance registry is set as the program name of a process. This name may not match the name displayed in Windows Task Manager or System Monitor in terms of case, for example.
When the program name of a process is used for defining an alarm or the display condition for the fields to be displayed in a report, it is case-sensitive. Check the program name of the process, including its case, by following the procedure described below. Afterwards, you can use the verified program name of the process to specify a monitoring process in an alarm definition or the display condition for the fields to be displayed in a report.
To check the program name of a process:
-
Start PFM - Web Console.
-
Start the report wizard.
For details about how to start the report wizard, see the chapter explaining creation of reports for operation analysis in the JP1/Performance Management User's Guide.
-
Define the fields to be displayed in the report.
In the report wizard's New Report > Field window, specify the record and field to be monitored.
-
Record: Process Detail (PD)
-
Field: Program (INSTANCE)
-
-
Complete report creation by following the report wizard.
-
Display the created report.
The program names of all processes within the system are displayed.
Record generation results when data cannot be collected
The following explains the record generation results when data to be stored in fields cannot be collected:
-
Records cannot be generated
When PFM - Agent for Platform cannot collect performance data to be stored in the fields defined as ODBC key fields, no records are generated.
-
A record having a field with Unknown or UNKNOWN as its value is generated
When the value acquired from the OS is unknown or a value cannot be acquired for a field whose data type is character string, a record having a field with Unknown or UNKNOWN as its value is generated.
Notes on reserved records
Under Record in the New Report > Field window of the PFM - Web Console report wizard, reserved records are displayed, and you can create a report of these records. You cannot, however, display a report of reserved records.
In addition, if PFM - Agent for Platform 07-00 or earlier is upgraded to 08-00 or later, records reserved in 08-00 or later appear during history collection setup. These records can be modified. However, if they are modified and then specified for data collection, no records will be collected. The following message is issued to the common message log during the first collection attempt only:
KAVF11201-W An illegal collection event occurred. (record-id, rc=maintenance-information)
- Note
-
When you perform a new installation of PFM - Agent for Platform 08-00 or later, the properties of reserved records are not displayed.
Installing Active Directory
PFM - Agent for Platform 08-11 or later provides the Active Directory Overview (PI_AD) record for collecting Active Directory information. To collect performance data for Active Directory, you must first install Active Directory. In an environment in which Active Directory is not available, the KAVF11304-W message is output and the record cannot be collected. The following describes how to install Active Directory.
To install Active Directory:
-
Execute the dcpromo command.
From the Windows Start menu, choose Run. The Run dialog box appears. Enter dcpromo in the Name text box, and then click OK. The Active Directory installation wizard starts.
-
Install Active Directory.
Install Active Directory as directed by the Active Directory installation wizard.