<Scan> Data
The <Scan> tag must have a time associated with it.
Table 16: Scan Data Descriptions
| Attribute | Req | Description |
|---|---|---|
| Time | yes | An integer value representing time. This may be UNIX time or a relative time. |
| Units | no | Valid values are sec, msec, and μsec. The default unit is seconds (sec). |
In addition, <Scan> tags have a number of elements that describe the state of the server at collection time. There are three categories of elements, as follows:
- global elements—summarize the overall state of the server
- dynamic disk elements – summarize the disk utiliizations
- process elements—summarize the state of individual processes
Table 17: Global and Process Element Descriptions
| Element | Req | Description | |
|---|---|---|---|
| Globals | no | Summary information about the state of the server since the last time scan. On servers with multiple CPUs, there can be an entry for each CPU on the system or one entry for all the CPUs. | |
| Attribute | Description | ||
| accumulate | “yes” if this scan includes all data, not just since the last scan. In this case Server Characterization Editor will calculate a difference based on the value collected for the previous scan. Individual elements within the Global element may override this setting. | ||
| Process | no | Summary information about the state of individual disks since the last scan time. Entries are only required for disks that are active in the scan period. In cases where accumulation is “yes”, there should be an entry for all disks. | |
| Attribute | Description | ||
| accumulate | “yes” if this scan includes all data, not just since the last scan. In this case Server Characterization Editor will calculate a difference based on the value collected for the previous scan. Individual elements within the Global element may override this setting. | ||
| Process | no | Summary information about the state of individual processes since the last scan time. There should be an entry for each process on the system. | |
| Attribute | Description | ||
| accumulate | “yes” if this scan includes all data, not just since the last scan. In this case Server Characterization Editor will calculate a difference based on the value collected for the previous scan. Individual elements within the Global element may override this setting. |
<Globals>
Table 18: Global Element Descriptions
| Element | Req | Description | |
|---|---|---|---|
| CPUTime | yes | The total amount of CPU time used by all process in the system since the last scan. This is a double precision floating point value. | |
| Attribute | Description | ||
| accumulate | “yes” if this scan includes all data, not just since the last scan. In this case Server Characterization Editor will calculate a difference based on the value collected for the previous scan. | ||
| units | sec – seconds msec – milliseconds μsec - microseconds |
||
| CPU | no | In a multiple CPU system, this specifies the CPU to which this <Globals> element applies. If multiple <Global> elements exist in a single <Scan> element, then this element is required. This is an integer value. |
|
| GlobalReads | no | The number of physical reads made to the local disk storage devices. This is a double precision floating point value. | |
| Attribute | Description | ||
| accumulate | “yes” if this scan includes all data, not just since the last scan. In this case Server Characterization Editor will calculate a difference based on the value collected for the previous scan. | ||
| GlobalWrites | no | The number of physical writes made to the local storage devices. This is a double precision floating point value. | |
| Attribute | Description | ||
| accumulate | “yes” if this scan includes all data, not just since the last scan. In this case Server Characterization Editor will calculate a difference based on the value collected for the previous scan. | ||
| GlobalIOBytes | no | The total size of all I/O operations in this scan interval. This is a double precision floating point value. | |
| Attribute | Description | ||
| accumulate | “yes” if this scan includes all data, not just since the last scan. In this case Server Characterization Editor will calculate a difference based on the value collected for the previous scan. | ||
| units | gb – gigabytes mb – megabytes kb – kilobytes b – bytes |
||
| GlobalIOSize | no | The average size of all I/O operations in this scan interval. This is a double precision floating point value. | |
| Attribute | Description | ||
| accumulate | “yes” if this scan includes all data, not just since the last scan. In this case Server Characterization Editor will calculate a difference based on the value collected for the previous scan. | ||
| units | gb – gigabytes mb – megabytes kb – kilobytes b – bytes |
||
| GlobalIORate | no | The rate of data transfer for all I/O operations in this scan interval. This is a double precision floating point value. | |
| Attribute | Description | ||
| units | gb – gigabytes per second mb – megabytes per second kb – kilobytes per second b – bytes per second |
||
| GlobalReadbytes | no | The total size of all block reads in this scan interval. This is a double precision floating point value. | |
| Attribute | Description | ||
| accumulate | “yes” if this scan includes all data, not just since the last scan. In this case Server Characterization Editor will calculate a difference based on the value collected for the previous scan. | ||
| units | gb – gigabytes mb – megabytes kb – kilobytes b – bytes |
||
| GlobalReadSize | no | The average size of block reads in this scan interval. This is a double precision floating point value. | |
| Attribute | Description | ||
| accumulate | “yes” if this scan includes all data, not just since the last scan. In this case Server Characterization Editor will calculate a difference based on the value collected for the previous scan. | ||
| units | gb – gigabytes mb – megabytes kb – kilobytes b – bytes |
||
| GlobalReadRate | no | The rate of data transfer for all block reads in this scan interval. This is a double precision floating point value. | |
| Attribute | Description | ||
| units | gb – gigabytes per second mb – megabytes per second kb – kilobytes per second b – bytes per second |
||
| GlobalWriteBytes | no | The total size of all block writes in this scan interval. This is a double precision floating point value. | |
| Attribute | Description | ||
| accumulate | “yes” if this scan includes all data, not just since the last scan. In this case Server Characterization Editor will calculate a difference based on the value collected for the previous scan. | ||
| units | gb – gigabytes mb – megabytes kb – kilobytes b - bytes |
||
| GlobalWriteSize | no | The average size of block writes in this scan interval. This is a double precision floating point value. | |
| Attribute | Description | ||
| accumulate | “yes” if this scan includes all data, not just since the last scan. In this case Server Characterization Editor will calculate a difference based on the value collected for the previous scan. | ||
| units | gb – gigabytes mb – megabytes kb – kilobytes b - bytes |
||
| GlobalWriteRate | no | The rate of data transfer for all block writes in this scan interval. This is a double precision floating point value. | |
| Attribute | Description | ||
| units | gb – gigabytes per second mb – megabytes per second kb – kilobytes per second b – bytes per second |
||
| GlobalMinorFaults | no | The number of minor faults (faults not requiring an I/O) which occurred in this scan interval. This is an integer value. | |
| Attribute | Description | ||
| accumulate | “yes” if this scan includes all data, not just since the last scan. In this case Server Characterization Editor will calculate a difference based on the value collected for the previous scan. | ||
| GlobalMajorFaults | The number of major faults (faults requiring an I/O) which occurred in this interval. This is an integer value. | ||
| Attribute | Description | ||
| accumulate | “yes” if this scan includes all data, not just since the last scan. In this case Server Characterization Editor will calculate a difference based on the value collected for the previous scan. | ||
| PagesIn | no | The number of pages swapped in to memory during this scan interval. This is an integer value. | |
| Attribute | Description | ||
| accumulate | “yes” if this scan includes all data, not just since the last scan. In this case Server Characterization Editor will calculate a difference based on the value collected for the previous scan. | ||
| PageInBytes | no | The total size of all pages swapped in to memory during this scan interval. This is a double precision floating point value. | |
| Attribute | Description | ||
| accumulate | “yes” if this scan includes all data, not just since the last scan. In this case Server Characterization Editor will calculate a difference based on the value collected for the previous scan. | ||
| units | gb – gigabytes mb – megabytes kb – kilobytes b - bytes |
||
| PageInRate | no | The rate of data transfer for all pages swapped in to memory during this scan interval. This is a double precision floating point value. | |
| Attribute | Description | ||
| units | gb – gigabytes per second mb – megabytes per second kb – kilobytes per second b – bytes per second |
||
| PagesOut | no | The number of pages swapped out from memory during this scan interval. This is an integer value. | |
| Attribute | Description | ||
| accumulate | “yes” if this scan includes all data, not just since the last scan. In this case Server Characterization Editor will calculate a difference based on the value collected for the previous scan. | ||
| PageOutBytes | no | The total size of all pages swapped out from memory during this scan interval. This is a double precision floating point value. | |
| Attribute | Description | ||
| accumulate | “yes” if this scan includes all data, not just since the last scan. In this case Server Characterization Editor will calculate a difference based on the value collected for the previous scan. | ||
| units | gb – gigabytes mb – megabytes kb – kilobytes b - bytes |
||
| PageOutRate | no | The rate of data transfer for all pages swapped out from memory during this scan interval. This is a double precision floating point value. | |
| Attribute | Description | ||
| units | gb – gigabytes per second mb – megabytes per second kb – kilobytes per second b – bytes per second |
||
| PageReqs | no | The number of all paging operations during this scan interval. This is an integer value. | |
| Attribute | Description | ||
| accumulate | “yes” if this scan includes all data, not just since the last scan. In this case Server Characterization Editor will calculate a difference based on the value collected for the previous scan. | ||
| GlobalSize | no | The amount of memory used by all processes in the system. This includes the resident memory and the memory in swap. This is a double precision floating point value. | |
| Attribute | Description | ||
| accumulate | “yes” if this scan includes all data, not just since the last scan. In this case Server Characterization Editor will calculate a difference based on the value collected for the previous scan. | ||
| units | gb – gigabytes mb – megabytes kb – kilobytes b - bytes |
||
| GlobalRSS | no | The amount of physical memory used by all processes in the system. This is a double precision floating point value. | |
| Attribute | Description | ||
| accumulate | “yes” if this scan includes all data, not just since the last scan. In this case Server Characterization Editor will calculate a difference based on the value collected for the previous scan. | ||
| units | gb – gigabytes mb – megabytes kb – kilobytes b - bytes |
<DynamicDisk>
Table 19: DynamicDisk Descriptions
| Element | Req | Description | |
|---|---|---|---|
| DynamicDiskName | yes | The name used by the operating system to refer to the physical disk. This is a string value. | |
| DynamicDiskResponseTime | no | The total amount of CPU time used by all process in the system since the last scan. This is a double precision floating point value. | |
| Attribute | Description | ||
| units | sec – seconds msec – milliseconds usec - microseconds |
||
| DynamicDiskTransfers | no | The total number of I/O operations performed on this disk since the last scan. This is an integer value. | |
| DynamicDiskReads | no | The total number of read operations performed on this disk since the last scan. This is an integer value. | |
| DynamicDiskWrites | no | The total number of write operations performed on this disk since the last scan. This is an integer value. | |
| DynamicDiskReadBytes | no | The total number of bytes read from this disk since the last scan. This is an integer value. | |
| DynamicDiskWriteBytes | no | The total number of bytes written to this disk since the last scan. This is an integer value. |
<Process>
Table 20: Process Element Descriptions
| Element | Req | Description | |
|---|---|---|---|
| ProcessID | yes | An identifier unique to the process. This is a string value. | |
| ProcessSize | yes | The amount of memory used by the process during the scan interval. This includes physical memory and swap memory. This is a double precision floating point value. | |
| Attribute | Description | ||
| accumulate | “yes” if this scan includes all data, not just since the last scan. In this case Server Characterization Editor will calculate a difference based on the value collected for the previous scan. | ||
| units | gb – gigabytes mb – megabytes kb – kilobytes b - bytes |
||
| ProcessName | yes | The name given to the process. This need not be unique. This is a string value. | |
| ProcessCPU | yes | The amount of CPU time used by this process since the last scan. This is a double precision floating point value. | |
| Attribute | Description | ||
| accumulate | “yes” if this scan includes all data, not just since the last scan. In this case Server Characterization Editor will calculate a difference based on the value collected for the previous scan. | ||
| units | sec – seconds msec – milliseconds usec - microseconds mb – megabytes kb – kilobytes b - bytes |
||
| MinorFaults | no | The number of minor faults (faults not requiring an I/O operation) that occurred since the last scan. This is an integer value. | |
| Attribute | Description | ||
| accumulate | “yes” if this scan includes all data, not just since the last scan. In this case Server Characterization Editor will calculate a difference based on the value collected for the previous scan. | ||
| MajorFaults | no | The number of major faults (faults requiring an I/O operation) that occurred since the last scan. This is an ineteger value. | |
| Attribute | Description | ||
| accumulate | “yes” if this scan includes all data, not just since the last scan. In this case Server Characterization Editor will calculate a difference based on the value collected for the previous scan. | ||
| InputBlocks | no | The number of physical read operations during the scan interval. This is an integer value. | |
| Attribute | Description | ||
| accumulate | “yes” if this scan includes all data, not just since the last scan. In this case Server Characterization Editor will calculate a difference based on the value collected for the previous scan. | ||
| OutputBlocks | no | The number of physical write operations during the scan interval. This is an integer value. | |
| Attribute | Description | ||
| accumulate | “yes” if this scan includes all data, not just since the last scan. In this case Server Characterization Editor will calculate a difference based on the value collected for the previous scan. | ||
| ProcessThread | no | The thread identifier for this thread. When this element is used, there may be multiple <Process> elements for the same process, as long as each element has a different value for <ProcessThread>. This is a string value. |
|
| ProcessParent | no | The process identifier for the parent process of this process. This is a string value. | |
| ProcessGroup | no | The identifier of the process group. This is a string value. | |
| ProcessUser | no | The identifier of the user executing the process. This is a string value. | |
| ProcessApplication | no | The identifier of the process application. This is used by data collectors that aggregate multiple processes into a single application. This is a string value. | |
| ProcessTask | no | The identifier of the process task associated with the process. This assignment is normally used by the operating system to group related processes. This is a string value. | |
| ProcessRSS | no | The amount of physical memory used by the process since the last scan. This is a double precision floating point value. | |
| Attribute | Description | ||
| accumulate | “yes” if this scan includes all data, not just since the last scan. In this case Server Characterization Editor will calculate a difference based on the value collected for the previous scan. | ||
| units | gb – gigabytes mb – megabytes kb – kilobytes b – bytes |
||
| ProcessArgs | no | The arguments passed to the process on startup. This is a string value. | |
| ProcessPriority | no | The priority of the process during the scan interval. This is an integer value. | |
| Swaps | no | The number of times the process was swapped out during the last scan interval. This is an integer value. | |
| Attribute | Description | ||
| accumulate | “yes” if this scan includes all data, not just since the last scan. In this case Server Characterization Editor will calculate a difference based on the value collected for the previous scan. | ||
| InputBytes | no | The total number of bytes read through all block input operations. This will be the same as InputBlocks * average block size. This is a double precision value. | |
| Attribute | Description | ||
| accumulate | “yes” if this scan includes all data, not just since the last scan. In this case Server Characterization Editor will calculate a difference based on the value collected for the previous scan. | ||
| gb – gigabytes mb – megabytes kb – kilobytes b – bytes |
|||
| OutputBytes | no | The total number of bytes written through all block output operations. This will be the same as OutputBlocks * average block size. This is a double precision value. | |
| Attribute | Description | ||
| accumulate | “yes” if this scan includes all data, not just since the last scan. In this case Server Characterization Editor will calculate a difference based on the value collected for the previous scan. | ||
| gb – gigabytes mb – megabytes kb – kilobytes b – bytes |
|||
| IOBytes | no | The total number of bytes written through all block output operations. This will be the same as IOBlocks * average block size. This is a double precision value. | |
| Attribute | Description | ||
| accumulate | “yes” if this scan includes all data, not just since the last scan. In this case Server Characterization Editor will calculate a difference based on the value collected for the previous scan. | ||
| units | gb – gigabytes mb – megabytes kb – kilobytes b – bytes |
||
| ProcessStart | no | The start time of a process. | |
| Attribute | Description | ||
| time | An integer value representing time. This may be UNIX time or a relative time. | ||
| units | sec – seconds msec – milliseconds usec - microseconds |