Workgroup Summary (PI_WGRP)
- Organization of this page
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 7. 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.
-
This record does not support collection in a logical host environment. Collect this record in a physical host environment.
-
Default values and values that can be specified
|
Item |
Default value |
Modifiable |
|---|---|---|
|
Collection Interval |
60 |
Yes |
|
Collection Offset# |
0 |
Yes |
|
Log |
No |
Yes |
|
LOGIF |
Blank |
Yes |
|
Over 10 Sec Collection Time |
Yes |
No |
|
Realtime Report Data Collection Mode |
Reschedule |
Yes |
- #
-
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
-
Fixed portion: 681 bytes
-
Variable portion: 278 bytes
Fields
|
PFM-View name (PFM-Manager name) |
Description |
Smry |
Format |
Delta |
Not sprtd in |
Data 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. |
COPY |
string(30) |
No |
-- |
-- |
|
Avg I/O Kbytes(AVG_IO_KBYTES) |
Average transfer size in I/O operations (KB) |
COPY |
float |
No |
HP-UX, AIX, Linux |
TOTAL_IO_KBYTES ÷ (READ_OPS + WRITE_OPS) |
|
CPU %(CPU_PERCENT_USED) |
Average value obtained by dividing CPU usage by the number of processors (%) |
COPY |
float |
No |
-- |
(((USER_CPU_TIME + SYSTEM_CPU_TIME) ÷ INTERVAL) ÷ processors-count) × 100 |
|
CPU % Each(CPU_PERCENT_USED_EACH) |
CPU usage by workgroups |
COPY |
float |
No |
-- |
((USER_CPU_TIME + SYSTEM_CPU_TIME) ÷ INTERVAL) × 100 |
|
Context Switches(CONTEXT_SWITCHES) |
Number of times context switching was executed |
COPY |
ulong |
Yes |
HP-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. |
COPY |
string(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) |
COPY |
ulong |
Yes |
-- |
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 operations |
COPY |
ulong |
Yes |
-- |
-- |
|
Process Count(PROCESS_COUNT) |
Number of processes executed by workgroups |
COPY |
ulong |
No |
-- |
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. |
COPY |
string(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. |
COPY |
ulong |
Yes |
HP-UX, Linux |
-- |
|
Reads/sec(READ_OPS_PER_SECOND) |
Frequency at which read operations occurred (number of operations per second) |
R |
float |
Yes |
HP-UX, Linux |
READ_OPS ÷ total-elapsed-time-of-all-processes-executed-by-workgroup |
|
Real Mem Kbytes(REAL_MEMORY_KBYTES) |
Physical memory size used (KB) |
COPY |
ulong |
No |
-- |
-- |
|
Record Time(RECORD_TIME) |
Time at which the record was created (Greenwich Mean Time) |
COPY |
time_t |
No |
-- |
-- |
|
Record Type(INPUT_RECORD_TYPE) |
Record type. Always WGRP. |
COPY |
char(8) |
No |
-- |
-- |
|
Swaps(SWAPS) |
Number of times swapping occurred |
COPY |
ulong |
Yes |
Linux |
-- |
|
System CPU(SYSTEM_CPU_TIME) |
Time during which the system ran in the kernel mode (seconds) |
COPY |
utime |
Yes |
-- |
-- |
|
Throughput/sec(IO_KBYTES_PER_SECOND) |
I/O operation speed (KB per second) |
R |
float |
Yes |
AIX, Linux |
TOTAL_IO_KBYTES ÷ total-elapsed-time-of-all-processes-executed-by-workgroup |
|
Total I/O Kbytes(TOTAL_IO_KBYTES) |
Total size transferred in I/O operations (KB) |
COPY |
double |
Yes |
AIX, Linux |
-- |
|
Total I/O Ops(TOTAL_IO_OPS) |
Number of I/O operations that occurred |
COPY |
ulong |
Yes |
HP-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) |
R |
float |
Yes |
HP-UX, AIX, Linux |
TOTAL_IO_OPS ÷ 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) |
COPY |
utime |
Yes |
-- |
-- |
|
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. |
COPY |
string(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) |
COPY |
ulong |
No |
Solaris |
-- |
|
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. |
COPY |
string(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. |
COPY |
ulong |
Yes |
HP-UX, Linux |
-- |
|
Writes/sec(WRITE_OPS_PER_SECOND) |
Frequency at which write operations occurred (number of operations per second) |
R |
float |
Yes |
HP-UX, Linux |
WRITE_OPS ÷ total-elapsed-time-of-all-processes-executed-by-workgroup |