Hitachi

JP1 Version 12 for Windows Systems JP1/Performance Management - Agent Option for Platform Description, User's Guide and Reference


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 [Figure] 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

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

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

--

--

Legend:

Smry: Summary

Not sprtd on: Not supported on