Application Process Interval (PD_APSI)
- Organization of this page
Function
The Application Process Interval (PD_APSI) record stores performance data that shows the state at a given point in time of a process that has been set for process monitoring. This record is a multi-instance record.
- Notes:
-
-
Each process represents a program that is being executed during data collection.
-
If a new record corresponding to the Program Name (PROGRAM_NAME) field is generated during a collection interval, 0 is displayed as the first value for the following fields, because their values are computed from the information collected during the preceding collection interval:
• CPU % (PCT_PROCESSOR_TIME)
• IO Data Bytes/sec (IO_DATA_BYTES_PER_SEC)
• IO Data Operations/sec (IO_DATA_OPERATIONS_PER_SEC)
• IO Other Bytes/sec (IO_OTHER_BYTES_PER_SEC)
• IO Other Operations/sec (IO_OTHER_OPERATIONS_PER_SEC)
• IO Read Bytes/sec (IO_READ_BYTES_PER_SEC)
• IO Read Operations/sec (IO_READ_OPERATIONS_PER_SEC)
• IO Write Bytes/sec (IO_WRITE_BYTES_PER_SEC)
• IO Write Operations/sec (IO_WRITE_OPERATIONS_PER_SEC)
• Privileged CPU % (PCT_PRIVILEGED_TIME)
• User CPU % (PCT_USER_TIME)
• Page Faults/sec (PAGE_FAULTS_PER_SEC)
-
If the value in the Program Name (PROGRAM_NAME) field of this record is System or System Idle Process, the data for the Elapsed Time (ELAPSED_TIME) field may not be collected correctly. In such a case, the value for the Elapsed Time (ELAPSED_TIME) field is close to the value for the System Up Time (SYSTEM_UP_TIME) field of the System Overview (PI) record, so utilize this value.
-
Any character in the source information that is not in the ASCII character set range of 0x20 to 0x7E will be converted to a hash mark (#: 0x23) before it is stored in the Program Name (PROGRAM_NAME) field. Note that multi-byte characters are processed in single-byte units during conversion. For example, the multi-byte (full-width) letter is converted as follows:
Source information
Post-conversion information
Character encoding
Binary
Binary
Character string
Shift-JIS
8260
2360
#`
EUC
A3C1
2323
##
UTF-8
EFBCA1
232323
###
-
The value of the Program Name (PROGRAM_NAME) field corresponds to the value shown in the Image Name column when you open the Processes tab in Windows Task Manager.
-
If the startup type of the Windows Management Instrumentation service (service name: Winmgmt) that provides system management information for the OS is set to Disabled, this record cannot be collected correctly. If the startup type of the Windows Management Instrumentation service is set to Disabled while PFM - Agent for Platform is running, change the startup type to a value other than Disabled, and then restart PFM - Agent for Platform.
-
Default values and values that can be specified
Item |
Default value |
Modifiable |
---|---|---|
Log |
No |
Yes |
LOGIF |
Blank |
Yes |
Over 10 Sec Collection Time |
No |
No |
Sync Collection With |
Detail Records, APP2 |
No |
Realtime Report Data Collection Mode |
Reschedule |
Yes |
ODBC key fields
-
PD_APSI_ID_PROCESS
-
PD_APSI_START_TIME
-
PD_APSI_APPLICATION_NAME
-
PD_APSI_MONITORING_NUMBER
Lifetime
From the time of execution of the process for which the application definition was set until the process terminates or the application definition is deleted.
Record size
-
Fixed portion: 681 bytes
-
Variable portion: 712 bytes
Fields
PFM-View name (PFM - Manager name) |
Description |
Smry |
Format |
Delta |
Not sprtd on |
Data source |
---|---|---|---|---|---|---|
Application Name (APPLICATION_NAME) |
The name specified in the process monitoring settings |
-- |
string (64) |
No |
-- |
-- |
CPU % (PCT_PROCESSOR_TIME) |
Percentage of the elapsed processor time used by the process (%). In a multi-processor environment, usage is displayed with number of processors × 100% as the maximum value. However, the maximum value might be exceeded, depending on the collection timing. |
-- |
double |
No |
-- |
-- |
Creating Process ID (PROCESS_ID) |
Process ID of the process that activated this process# |
-- |
ulong |
No |
-- |
-- |
Elapsed Time (ELAPSED_TIME) |
Total elapsed time for process execution (seconds)# |
-- |
utime |
No |
-- |
-- |
Group (GROUP_NAME) |
Name of the group to which the user who executed the process belongs. The group name is a domain name or a name pre-defined by the local system (NT AUTHORITY, computer-name, for example). If no group name is found that corresponds to the process security ID, NONE_MAPPED is stored; if the executing group name cannot be acquired from the process ID, Unknown is stored. |
-- |
string (36) |
No |
-- |
-- |
Handle Count (HANDLE_COUNT) |
Number of handles kept open by the process# |
-- |
ulong |
No |
-- |
-- |
IO Data Bytes/sec (IO_DATA_BYTES_PER_SEC) |
Rate at which data was read or written in all I/O operations generated by the process (bytes/second) |
-- |
double |
No |
-- |
-- |
IO Data Operations/sec (IO_DATA_OPERATIONS_PER_SEC) |
Number of read and write operations in all I/O operations generated by the process (operations/second) |
-- |
double |
No |
-- |
-- |
IO Other Bytes/sec (IO_OTHER_BYTES_PER_SEC) |
Rate at which data was manipulated by operations other than read or write operations (control functions, for example) in all I/O operations generated by the process (bytes/second) |
-- |
double |
No |
-- |
-- |
IO Other Operations/sec (IO_OTHER_OPERATIONS_PER_SEC) |
Number of operations other than read or write operations (control functions, for example) in all I/O operations generated by the process (operations/second) |
-- |
double |
No |
-- |
-- |
IO Read Bytes/sec (IO_READ_BYTES_PER_SEC) |
Rate at which data was read in all I/O operations generated by the process (bytes/second) |
-- |
double |
No |
-- |
-- |
IO Read Operations/sec (IO_READ_OPERATIONS_PER_SEC) |
Number of read operations in all I/O operations generated by the process (operations/second) |
-- |
double |
No |
-- |
-- |
IO Write Bytes/sec (IO_WRITE_BYTES_PER_SEC) |
Rate at which data was written in all I/O operations generated by the process (bytes/second) |
-- |
double |
No |
-- |
-- |
IO Write Operations/sec (IO_WRITE_OPERATIONS_PER_SEC) |
Number of write operations in all I/O operations generated by the process (operations/second) |
-- |
double |
No |
-- |
-- |
Interval (INTERVAL) |
Always 0 |
-- |
ulong |
No |
-- |
-- |
Monitoring Field (MONITORING_FIELD) |
Field to be monitored |
-- |
string (16) |
No |
-- |
-- |
Monitoring Label (MONITORING_LABEL) |
Name used to identify the monitoring condition |
-- |
string (32) |
No |
-- |
-- |
Monitoring Number (MONITORING_NUMBER) |
The monitoring condition number |
-- |
word |
No |
-- |
-- |
PID (ID_PROCESS) |
Process ID. Unique identifier of the executing process |
-- |
ulong |
No |
-- |
-- |
Page Faults/sec (PAGE_FAULTS_PER_SEC) |
Rate at which page faults occurred in the process (faults/second) |
-- |
double |
No |
-- |
-- |
Page File Kbytes (PAGE_FILE_BYTES) |
Size of the virtual memory area used by the process as paging files (KB)# |
-- |
double |
No |
-- |
-- |
Page File Kbytes Peak (PAGE_FILE_BYTES_PEAK) |
Maximum size of the virtual memory area used by the process as paging files (KB)# |
-- |
double |
No |
-- |
-- |
Pool Nonpaged Kbytes (POOL_NONPAGED_BYTES) |
Size of the memory that was used by the process and that cannot be paged (KB)# |
-- |
double |
No |
-- |
-- |
Pool Paged Kbytes (POOL_PAGED_BYTES) |
Size of the memory that was used by the process and that can be paged (KB)# |
-- |
double |
No |
-- |
-- |
Priority Base (PRIORITY_BASE) |
Process base priority. The greater the value, the higher the priority. The following values are available: • 24: Real-time • 13: High • 10: Higher than normal • 8: Normal • 6: Lower than normal • 4: Low |
-- |
ulong |
No |
-- |
-- |
Private Kbytes (PRIVATE_BYTES) |
Size of the memory that was allocated to the process and that cannot be shared with other processes (KB)# |
-- |
double |
No |
-- |
-- |
Privileged CPU % (PCT_PRIVILEGED_TIME) |
Percentage of the elapsed time the process used the processor in the privileged mode (%). In a multi-processor environment, usage is displayed with number of processors × 100% as the maximum value. However, the maximum value might be exceeded, depending on the collection timing. |
-- |
double |
No |
-- |
-- |
Program Name (INSTANCE) |
Executing program name |
-- |
string (257) |
No |
-- |
-- |
Record Time (RECORD_TIME) |
Time at which the record was created |
-- |
time_t |
No |
-- |
-- |
Record Type (INPUT_RECORD_TYPE) |
Record name. Always APSI. |
-- |
char (8) |
No |
-- |
-- |
Start time (START_TIME) |
Start time of the process |
-- |
time_t |
No |
-- |
-- |
Thread Count (THREAD_COUNT) |
Number of threads (unit for executing an instruction) in the process. When a process is executed, at least one thread is started.# |
-- |
ulong |
No |
-- |
-- |
User (USER_NAME) |
Executing user name for the process. If no user name is found that corresponds to the process security ID, NONE_MAPPED is stored; if the executing user name cannot be acquired from the process ID, Unknown is stored. |
-- |
string (36) |
No |
-- |
-- |
User CPU % (PCT_USER_TIME) |
Amount of processor time used by the process in the user mode (%). In a multi-processor environment, usage is displayed with number of processors × 100% as the maximum value. However, the maximum value might be exceeded, depending on the collection timing. |
-- |
double |
No |
-- |
-- |
Virtual Env ID (VIRTUAL_ENV_ID) |
ID of the virtualized environment created by the virtualized system provided by the OS |
-- |
string (65) |
No |
2012 |
-- |
Virtual Kbytes (VIRTUAL_BYTES) |
Size of the virtual address space used by the process (KB)# |
-- |
double |
No |
-- |
-- |
Virtual Kbytes Peak (VIRTUAL_BYTES_PEAK) |
Maximum size of the virtual address space used by the process (KB)# |
-- |
double |
No |
-- |
-- |
Working Set Kbytes (WORKING_SET) |
Size of the memory used by the process (which is called a working set and indicates either the total memory size or the amount of memory that can be referenced without page faults) (KB)# |
-- |
double |
No |
-- |
-- |
Working Set Kbytes Peak (WORKING_SET_PEAK) |
Maximum size of the memory used by the process (which is called a working set and indicates either the total memory size or the amount of memory that can be referenced without page faults) (KB)# |
-- |
double |
No |
-- |
-- |