Disk Space Test

This test monitors the space usage of every disk partition on a host. While this test typically reports the space usage of every physical disk partition on a host, when monitoring hosts running Windows 2008/Vista/7 hosts however, this test reports usage metrics of physical and logical partitions.

Target of the test : Any host system

Agent deploying the test : An internal agent

Outputs of the test : One set of results for each physical/logical disk partition and/or NFS drive on the host monitored

Configurable parameters for the test
  1. Test period - How often should the test be executed
  2. Host - The host for which the test is to be configured.
  3. discover nfs – This flag is applicable for Windows 7 and Windows 2008 operating systems only. Set this flag to Yes, if you want the test to automatically discover NFS drives on your system and report their status as well. By default, this flag is set to No.
  4. exclude – Against this parameter, you can provide a comma-separated list of disk partitions that you want to exclude from monitoring. For example, on Unix systems, you can use this parameter to exclude temporary partitions that the Unix system itself creates from monitoring.     
  5. domain, domain user, and domain passwordThese parameters are applicable to Windows systems only. When monitoring a Windows system, if the DISCOVER NFS flag of this test is set to Yes, then the test should be configured with the privileges of a valid domain user in order to auto-discover NFS drives and report their usage and status. In such a case therefore, specify a valid Windows domain name against DOMAIN , provide the name of a valid user in that domain against DOMAIN USER, and specify the password of that user against PASSWORD. Once the domain user credentials are provided, the test auto-discovers all those NFS drives on the target Windows system to which the configured domain user has access.
  6. confirm passwordRetype the PASSWORD of the configured domain user here.
  7. timeout - Specify the maximum duration (in seconds) for which the test will wait for a response from the server. The default timeout period is 30 seconds.
  8. use sudoThis parameter applies only to Linux and Solaris systems. By default, the USE SUDO parameter is set to No. This indicates that, by default, this test will report metrics by executing the df -Pk –l command on the Solaris host. 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>

      For instance, if the eG agent install user is eguser, then the entry in the sudoers file should be:

      eguser ALL=(ALL) NOPASSWD: df –Pk -l

    • 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 df –Pk –l command and retrieve the desired metrics.
  9. sudo path This parameter is relevant only when the use sudo parameter is set to ‘Yes’. By default, the sudo path is set to none. This implies that the sudo command is in its default location – i.e., in the  /usr/bin or /usr/sbin folder of the target Solaris host. In this case, the eG agent automatically runs the metastat command with sudo from its default location, once the use sudo flag is set to Yes. However, if the sudo command is available in a different location in your environment, you will have to explicitly specify the full path to the sudo command in the sudo path text box to enable the eG agent to run the sudo command.   
Measurements made by the test
Measurement Description Measurement Unit Interpretation

Total capacity:

Indicates the total capacity of a disk partition.

MB

 

Used space:

Indicates the amount of space used in a disk partition.

MB

 

Free space:

Indicates the current free space available for each disk partition of a system.

MB

 

Percent usage:

Indicates the percentage of space usage on each disk partition of a system.

Percent

A value close to 100% can indicate a potential problem situation where applications executing on the system may not be able to write data to the disk partition(s) with very high usage.

Drive availability:

Indicates whether/not this drive is available currently.

Percent

If the drive is available, then this measure will report the value 100. If not, then this measure will report the value 0.

This measure gains significance when monitoring NFS drives, as it enables you to identify those drives that are no longer mapped to the system.