Disk Activity Test

When executed on Windows, Solaris, AIX, and HP-UX systems, this test reports statistics pertaining to the input/output utilization of each physical disk on a system.

Target of the test : Any host system

Agent deploying the test : An internal agent

Outputs of the test : One set of results for each host monitored

Configurable parameters for the test
Parameter	Description
Test Period	How often should the test be executed.
Host	The host for which the test is to be configured.
Useexe	Setting the USEEXE flag to true, ensures that the disk activity metrics are collected by executing a binary instead of dynamically linking to the Performance instrumentation library. By default, this is set to false
Disks	To obtain disk activity metrics for both logical and physical disks, enter all in the DISKS text box. To collect metrics for physical disks, set the DISKS parameter to Physical and to collect metrics for logical disks, set the parameter to Logical.
Use sudo	By default, the USE SUDO parameter is set to No. This indicates that, by default, this test will report the detailed diagnosis for the Disk busy measure of each disk partition being monitored by executing the /usr/bin/iotop command or /usr/sbin/iotop command. However, in some highly secure environments, the eG agent install user may not have the permissions to execute this command directly. In such cases, do the following: Edit the sudoers file on the target host and append an entry of the following format to it: <eG_agent_install_user> ALL=(ALL) NOPASSWD:<Command_with_path> For instance, if the eG agent install user is eguser, then the entries in the sudoers file should be: eguser ALL=(ALL) NOPASSWD: /usr/bin/iotop eguser ALL=(ALL) NOPASSWD: /usr/sbin/iotop Finally, save the file. Then, when configuring the test using the eG admin interface, set the use sudo parameter to Yes. This will enable the eG agent to execute the sudo /usr/bin/iotop command or sudo /usr/sbin/iotop and retrieve the detailed diagnosis of the Disk busy measure.
IOTOP Location	By default, the IOTOP Location parameter is set to none. This indicates that the eG agent would automatically discover the default location of the iotop package i.e. /usr/bin or /usr/sbin, for executing the sudo command when the USE SUDO flag is set to yes. However, if the iotop package is installed in a different location in your environment, then specify that location in the IOTOP Location text box.
Trace	By default, this flag is set to No, indicating that the test does not generate in-depth details such as details on read/write activities on each file stored in the disk, by default. In such a way, you can conserve storage space on the eG database. However, if you want the test to generate and store details of read/write activities performed on each and every file in the disk, set the TRACE flag to Yes.
Read Size in KB	This parameter is applicable only when the Trace flag is set to Yes and the Disk Busy measure violates the value specified against the “Disk Busy Percent” parameter. By default, the value of this parameter is set to 10 KB. This indicates that the detailed diagnosis of this test will include the details of only those files from which data of size greater than or equal to 10 KB has been read. This setting will help you to conserve space on the database and also to identify the files on which maximum read operations were performed. However, you can override the default value of this parameter as per your requirement.
Write Size in KB	This parameter is applicable only when the Trace flag is set to Yes and the Disk Busy measure violates the value specified against the “Disk Busy Percent” parameter. By default, the value of this parameter is set to 10 KB. This indicates that the detailed diagnosis of this test will include the details of only those files on which data of size greater than or equal to 10 KB has been written. This setting will help you to conserve space on the database and also to identify the files on which more number of write operations were performed. However, you can override the default value of this parameter as per your requirement.
Disk Response Time Secs	This parameter is applicable only when the Trace flag is set to Yes and the Disk Busy measure violates the value specified against the “Disk Busy Percent” parameter. By default, the value of this parameter is set to 1 second. This indicates that the detailed diagnosis of this test will include the details of only those files that took longer than 1 second to read/write data of size specified against the READ SIZE IN KB and WRITE SIZE IN KB parameters. This setting will help you to conserve space on the database and also to identify the files that took longer time to respond to read/write requests. However, you can override the default value of this parameter as per your requirement.
Event Capture Interval In Secs	This parameter is applicable only when the Trace flag is set to Yes and the Disk Busy measure violates the value specified against the “Disk Busy Percent” parameter. By default, the value of this parameter is set to 10 seconds. This setting ensures that the test will only capture the details of the disk events performed during the last 10 seconds of the specified measurement period. In addition, the detailed diagnosis of this test will include the details of the files involved in the disk events captured during the interval specified against this parameter only if the size of the data read from/written to the files is greater than or equal to the values specified against the READ SIZE IN KB and WRITE SIZE IN KB parameters or the response time of the read/write operations is greater than or equal to the values specified against the DISK RESPONSE TIME SECS parameter. However, you can override the default value of this parameter as per your requirement.
Disk Busy Percent	This parameter is applicable only when the TRACE flag is set to Yes. Specify the percentage of time beyond which the test should reveal the detailed diagnosis for the Disk Busy measure. By default, this parameter is set to 20. However, you can override this value as per your requirement.
High Security	This flag is applicable only when the target Linux host is monitored in the agentless manner. In highly secure environments, eG Enterprise could not perform agentless monitoring on a Linux host using SSH. To enable monitoring of the Linux hosts in such environments, set the HIGH SECURITY flag to Yes. It indicates that eG Enterprise will connect to the target Linux host in a more secure way and collect performance metrics. By default, this flag is set to No.
Display Mounts	By default, this parameter is set to false. This indicates that this test will report the I/O utilization of the disk drives by default. However, if you wish set this flag to true, then the eG agent will map the disk drives to mount points and reports the I/O utilization of each mount point in the target server. To this effect, the mount points discovered by this test will be the descriptors.
DD Frequency	Refers to the frequency with which detailed diagnosis measures are to be generated for this test. The default is 1:1. This indicates that, by default, detailed measures will be generated every time this test runs, and also every time the test detects a problem. You can modify this frequency, if you so desire. Also, if you intend to disable the detailed diagnosis capability for this test, you can do so by specifying none against DD frequency.
Detailed Diagnosis	To make diagnosis more efficient and accurate, the eG Enterprise embeds an optional detailed diagnostic capability. With this capability, the eG agents can be configured to run detailed, more elaborate tests as and when specific problems are detected. To enable the detailed diagnosis capability of this test for a particular server, choose the On option. To disable the capability, click on the Off option. The option to selectively enable/disable the detailed diagnosis capability will be available only if the following conditions are fulfilled: The eG manager license should allow the detailed diagnosis capability Both the normal and abnormal frequencies configured for the detailed diagnosis measures should not be 0.

Measurements made by the test
Measurement	Description	Measurement Unit	Interpretation
Disk read time:	Indicates the average time in seconds of a read of data from the disk.	Secs
Disk write time:	Indicates the average time in seconds of a write of data from the disk.	Secs
Disk read rate:	Indicates the number of reads happening on a logical disk per second.	Operations/Sec	A dramatic increase in this value may be indicative of an I/O bottleneck on the server.
Data read rate from disk:	Indicates the rate at which bytes are transferred from the disk during read operations.	KB/Sec	A very high value indicates an I/O bottleneck on the server.
Disk write rate:	Indicates the number of writes happening on a local disk per second.	Operations/Sec	A dramatic increase in this value may be indicative of an I/O bottleneck on the server.
Data write rate to disk:	Indicates the rate at which bytes are transferred from the disk during write operations.	KB/Sec	A very high value indicates an I/O bottleneck on the server.
Disk service time:	Indicates the average time that this disk took to service each transfer request ( i.e., the average I/O operation time)	Secs	A sudden rise in the value of this measure can be attributed to a large amount of information being input or output. A consistent increase however, could indicate an I/O processing bottleneck.
Disk queue time:	Indicates the average time that transfer requests waited idly on queue for this disk.	Secs	Ideally, the value of this measure should be low.
Disk I/O time:	Indicates the average time taken for read and write operations of this disk.	Secs	The value of this measure is the sum of the values of the Disk service time and Disk queue time measures. A consistent increase in the value of this measure could indicate a latency in I/O processing.

Note:

For this test to report measures on Unix systems, the sysstat package must be installed on the server (check for the existence of the iostat command on the target system).
If the sysstat version installed on the target server is less than 4.0.7, the following measures also will not be available – Data read rate from disk and Data write rate to disk.
As the HPUX operating system only provides the overall transfer rate to and from the disk, the eG agent reports this value for both the Disk read rate and the Disk write rate. Likewise, the Data read rate from disk and Data write rate to disk are also reported as the same values (i.e., equal to the data transfer rate from the disk). Likewise, the Disk read time and Disk write time are also reported as the same values (i.e., equal to the seconds per average seek).
Detailed diagnosis will not be available for systems operating on HPUX platforms.