Notes on records

Note the following points when collecting records.

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:

  1. 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 7-11 Record fields to which a number is appended

    Record nameField 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)
  2. For the PD_UPD, PD_UPDB, PI_UPI, and PI_UPIB records, the instance of the first record is used.
    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. Furthermore, 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.

Table 7-12 Objects that correspond to various records, source (service) names that are output in the event log, and performance extension DLLs

CategoryRecord name (Record ID)Object nameSource (service) output to event logPerformance extension DLL
DiskLogical Disk Overview (PI_LOGD)LogicalDiskPerfDiskPerfDisk.dll
Physical Disk Overview (PI_PHYD)PhysicalDisk
ProtocolICMP Overview (PI_ICMP)ICMPTcpipperfctrs.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-relatedNetwork Interface Overview (PI_NETI)Network InterfaceTcpipperfctrs.dll
NBT Overview (PI_NBT)NBT Connection
WINS Server Overview (PI_WINS)WINS ServerWinswinsctrs.dll
Browser Overview (PI_BRSR)BrowserPerfNetperfnet.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)CachePerfOSPerfOS.dll
Memory
Objects
System
Processor
Processor Overview (PI_PCSR)Processor
Page File Detail (PD_PAGF)Paging File
Process-relatedProcess Detail (PD)ProcessPerfProcPerfProc.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 DirectoryActive Directory Overview (PI_AD)DatabaseESENTesentprf.dll
NTDSNTDSntdsperf.dll
DNSDNSdnsperf.dll
GeneralGeneric Data Detail (PD_GEND)Objects set by the collection data addition utilityDiffers for each object.
Generic Data Interval (PI_GENI)
OtherEvent 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)

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.

Table 7-13 Examples of application event logs when records cannot be collected normally

Event IDSource
(service) name
Event log details
1008Perflib#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.
1009Perflib#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.
1010Perflib#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.
1011Perflib#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.
2001Perflib#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.
2002Perflib#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.
2000PerfDiskLogical 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

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:

  1. Start PFM - Web Console.
  2. 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 Job Management Partner 1/Performance Management User's Guide.
  3. 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)
  4. Complete report creation by following the report wizard.
  5. 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:

Notes on reserved records

If PFM - Agent for Platform 07-00 or earlier is upgraded to 08-00 or later, records reserved in 08-00 or later appear in Record in the New Report > Field window of the PFM - Web Console report wizard 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)

Reference 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:

  1. 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.
  2. Install Active Directory.
    Install Active Directory as directed by the Active Directory installation wizard.