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
Parameter Description

Test Period

How often should the test be executed

Host

The host for which the test is to be configured.

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.

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.  

Domain, Domain user, Domain password and Confirm password

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 Domain 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.

In the Confirm password text box, retype the Password of the configured domain user here.

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.

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. 

Cleanup automation status

Indicates the current status of cleanup automation.

This measure will appear only if the Automation parameter is set to Yes.

 

The values reported by this measure and its numeric equivalents are mentioned in the table below:

Measure Value

Numeric Value
Not required 1

Started

2

Running

3

Completed

4

Not enabled

5

Failed

6

Note:

By default, this measure reports the Measure Values listed in the table above to indicate the current status of cleanup automation. The graph of this measure however, represents the status of a port using the numeric equivalents only.

In case of Hyper-V and Hyper-V VDI components, the Disk Space test reports metrics for an additional Total descriptor. For this descriptor, the test reports the total disk capacity and space usage across all the disk partitions of the monitored Hyper-V host.

Configuring Automation Clean-up Rules

To save the time and effort involved in cleaning up the unwanted files/folders from the drives, eG Enterprise offers an easy-to-use auto-configure option in the form of an encircled plus icon that is given against the Automation Configuration Rules parameter. Note that this parameter will appear only if you set the Automation flag to Yes.

To configure the automation clean-up rules, do the following:

  1. Click on the encircled plus icon given against the Automation Configuration Rules parameter (see Figure 1).

    Figure 1 : Configuring Automation parameter

  2. The configuration of automation clean-up rules window will then appear (see Figure 2).

    Figure 2 : Configuring clean-up rules

  3. In Figure 2, specify the following for defining rules for one or more drives:

    • Choose the drive for which you wish to define clean-up rules from the Drive name drop-down list.
    • Next, enter the utilization percentage of the specified drive in the Drive utilization percentage text box. When the drive utilization reaches/exceeds the value specified in this text box, the clean-up process will be triggered for the chosen drive.
    • If you select a drive in which the operating system files are stored from the Drive name drop-down list, then the Configured default files and folder to be cleaned text box will appear. This text box will display a recommended list of files and folders to be cleaned from the system drive. This list is pre-configured in the eg_tests.ini file. However, you can edit this list, if required, as follows:

      • Edit the eg_tests.ini file in the <EG_INSTALL_DIR>\manager\config directory.
      • In the [Automation_Default_Values] section of the file, absolute paths to files and folders in the root drive of the Windows operating system will be given as a semi-colon separated list against the DiskSpaceTest.Windows.path parameter as shown below:

        DiskSpaceTest.Windows.path=%allusersprofile%\Adobe\Setup\*.*;%allusersprofile%\Microsoft\WindowsDefender\Definition Updates\*.*;%allusersprofile%\Microsoft\Windows Defender\Scans\*.*;;%allusersprofile%\Microsoft\Windows\WER\*;%systemdrive%\MSOCache\Users;%systemdrive%\Temp\*.*;%systemdrive%\Windows.old;%systemroot%\Downloaded Program Files\*.*;%SystemRoot%\memory.dmp;%SystemRoot%\Minidump.dmp;%systemroot%\Temp\*.*;

        You can also predefine the list of files and folders for non-Windows operating systems by specifying your list against the DiskSpaceTest.Non_Windows.path parameter.

      • Save the file after making the required changes.

      Note that this text box will not appear if you choose a non-system drive from the Drive Name drop-down list.

    • Next, specify full path to a file/folder or a list of files and folders that are not included in the predefined list in the Files and folders to be cleaned text box . This text box is common for all drives on the target host. For non-system drives, you can configure the list of files/folders to be cleaned-up by specifying full path to the same in the Files and folders to be cleaned text box (see Figure 3). You can clean-up more than one file/folder by configuring the full path to the files/folders in a semi-colon separated list. The full path to the files/folders should be specified as follows based on your requirement:

      1. To clean-up a specific file from the chosen drive or its folders/subfolders, specify the full path as <drive>/<folder&sub-folders>/<fileToBeDeleted>. For example, E/test.doc, E/misc/sample.txt, E/test.doc;E/misc/sample.txt.
      2. To clean-up a specific folder and its content from the chosen drive, specify the full path as <drive>/<folders&subfolders>/<folderToBeCleaned>. For example, E/misc/old.
      3. To clean-up all contents of specific folder, specify the full path as <drive>/<folders&subfolders>/<contentsOfTheFolderToBeCleaned>/*. For example, E/misc/old/*. In the process, the contents of the specified folder will be cleaned up but the folder will exist in the drive.
      4. To clean-up all files available in a specific folder, specify the full path as <drive>/<folders&subfolders>/<contentsOfTheFolderToBeCleaned>/*.*. For example, E/misc/old/*.*. In the process, all files available in the specified folder will be cleaned up but the folder and its sub-solders (if any) will exist in the drive.
      5. To clean-up files with specific pattern/name, specify the full path as <drive>/<folders&subfolders>/log*.*.

      Figure 3 : Configuring automation rules for non-system drive

  4. You can add more rules for different drives in the Automation Configuration Rules page by clicking on the Add more button. Note that you cannot add the system drive for more than one time. However, you can add more than one rule for non-system drives. To remove a specification that pre-exists, just click on the encircled minus icon that corresponds to it (see Figure 4). Upon clicking the Clear button, you can remove all the specifications that you configured.

    Figure 4 : Adding more automation rules

  5. Finally, click the Update button to save the configurations.