Workgroup Summary (PI_WGRP)

Function

The Workgroup Summary (PI_WGRP) record stores the Performance data in which the data stored in the Process Detail (PD) record is summarized as the state for each workgroup at a given point in time. A record is created for each workgroup. For details about how to collect workgroup information, see 6. User-Defined Record Collection.

A workgroup named Other is automatically created for all process records that do not belong to any of the defined workgroups.

This is a multi-instance record.

Note that even if the Process Detail (PD) record is not collected, performance data is stored in the Workgroup Summary (PI_WGRP) record.

Notes:
  • When there are many objects to be collected because, for example, there are many processes on the machine, increased throughput results in a heavier processing load.
  • To change a workgroup definition, you need to restart PFM - Agent for Platform.
  • Group names are based on actual group names, and not on effective group names.

Default values and values that can be specified

ItemDefault valueModifiable
Collection Interval60Yes
Collection Offset#0Yes
LogNoYes
LOGIFBlankYes
#
A value between 0 and 32,767 seconds can be specified (a value within the range specified for Collection Interval). Use this item to distribute the collection load, because executing data collection all at once results in concentration of the processing workload. Note that the data collection duration to be recorded is the same as the Collection Interval, regardless of the value specified for Collection Offset.
When changing the Collection Offset value, specify a value that takes into account the impact of the collection processing load.

ODBC key fields

PI_WGRP_WORKGROUP_NAME

Lifetime

None

Record size

Fields

PFM-View name
(PFM-Manager name)
DescriptionSmryFormatDeltaNot sprtd inData source
Argument Lists(ARGUMENT_LISTS)Process argument list.
If the value exceeds 30 bytes, the character becomes >.
This field shows the character string specified in the arguments_02 parameter of the wgfile file.
COPYstring(30)No----
Avg I/O Kbytes(AVG_IO_KBYTES)Average transfer size in I/O operations (KB)COPYfloatNoHP-UX,
AIX,
Linux
TOTAL_IO_KBYTES [Figure] (READ_OPS + WRITE_OPS)
CPU %(CPU_PERCENT_USED)Average value obtained by dividing CPU usage by the number of processors (%)COPYfloatNo--(((USER_CPU_TIME + SYSTEM_CPU_TIME) [Figure] INTERVAL) [Figure] processors-count) [Figure] 100
CPU % Each(CPU_PERCENT_USED_EACH)CPU usage by workgroupsCOPYfloatNo--((USER_CPU_TIME + SYSTEM_CPU_TIME) [Figure] INTERVAL) [Figure] 100
Context Switches(CONTEXT_SWITCHES)Number of times context switching was executedCOPYulongYesHP-UX,
Linux
--
Groups(GROUPS)Group name list. If the value exceeds 30 bytes, the character becomes >.
This field shows the character string specified in the groups parameter of the wgfile file.
This field shows the character string specified in the groups or groups_02 parameter of the wgfile file in version 08-00 or later.
COPYstring(30)No--PFM - Agent for Platform adds the process group name to this field for each process the workgroup executes.
Interval(INTERVAL)Interval at which the Workgroup Summary (PI_WGRP) record was stored (seconds)COPYulongYes--When the delta value is not collected, total of the operating time of each process. When the delta value is collected, RECORD_TIME - previous record time
Major Faults(MAJOR_FAULTS)Number of page faults that cause physical I/O operationsCOPYulongYes----
Process Count(PROCESS_COUNT)Number of processes executed by workgroupsCOPYulongNo--Number of processes in the process table that have user properties, group properties, or program properties that match the workgroup definition
Programs(PROGRAMS)Program name list. If the value exceeds 30 bytes, the character becomes >.
This field shows the character string specified in the programs parameter of the wgfile file.
This field shows the character string specified in the programs or programs_02 parameter of the wgfile file in version 08-00 or later.
COPYstring(30)No--PFM - Agent for Platform adds the process program name to this field for each process the workgroup executes.
Reads(READ_OPS)In AIX, this field shows the number of times RAW read operations occurred.
In Solaris, this field shows the number of times Block read operation occurred.
COPYulongYesHP-UX,
Linux
--
Reads/sec(READ_OPS_PER_SECOND)Frequency at which read operations occurred (number of operations per second)RfloatYesHP-UX,
Linux
READ_OPS [Figure] total-elapsed-time-of-all-processes-executed-by-workgroup
Real Mem Kbytes(REAL_MEMORY_KBYTES)Physical memory size used (KB)COPYulongNo----
Record Time(RECORD_TIME)Time at which the record was created (Greenwich Mean Time)COPYtime_tNo----
Record Type(INPUT_RECORD_TYPE)Record type. Always WGRP.COPYchar(8)No----
Swaps(SWAPS)Number of times swapping occurredCOPYulongYesLinux--
System CPU(SYSTEM_CPU_TIME)Time during which the system ran in the kernel mode (seconds)COPYutimeYes----
Throughput/sec(IO_KBYTES_PER_SECOND)I/O operation speed (KB per second)RfloatYesAIX,
Linux
TOTAL_IO_KBYTES [Figure] total-elapsed-time-of-all-processes-executed-by-workgroup
Total I/O Kbytes(TOTAL_IO_KBYTES)Total size transferred in I/O operations (KB)COPYdoubleYesAIX,
Linux
--
Total I/O Ops(TOTAL_IO_OPS)Number of I/O operations that occurredCOPYulongYesHP-UX,
AIX,
Linux
READ_OPS + WRITE_OPS
Total I/O Ops/sec(TOTAL_IO_OPS_PER_SECOND)Frequency at which I/O operations occurred (number of operations per second)RfloatYesHP-UX,
AIX,
Linux
TOTAL_IO_OPS [Figure] total-elapsed-time-of-all-processes-executed-by-workgroup
User CPU(USER_CPU_TIME)Time during which the CPU ran in the user mode (seconds)COPYutimeYes----
Users(USERS)User name list. If the value exceeds 30 bytes, the character becomes >.
This field shows the character string specified in the users parameter of the wgfile file.
This field shows the character string specified in the users or users_02 parameter of the wgfile file in version 08-00 or later.
COPYstring(30)No--PFM - Agent for Platform adds the process user name to this field for each process the workgroup executes.
Virtual Mem Kbytes(VIRTUAL_MEMORY_KBYTES)Size of the virtual memory used (KB)COPYulongNoSolaris--
Workgroup(WORKGROUP_NAME)Workgroup name. Other is displayed if a process does not belong to any of the defined workgroups.
This field shows the character string specified in the workgroup parameter of the wgfile file.
COPYstring(30)No----
Writes(WRITE_OPS)In AIX, this field shows the number of times RAW write operations occurred.
In Solaris, this field shows the number of times Block write operation occurred.
COPYulongYesHP-UX,
Linux
--
Writes/sec(WRITE_OPS_PER_SECOND)Frequency at which write operations occurred (number of operations per second)RfloatYesHP-UX,
Linux
WRITE_OPS [Figure] total-elapsed-time-of-all-processes-executed-by-workgroup