Directory Test

This test monitors one or more directories on a server.

Target of the test : Any host

Agent deploying the test : An internal agent

Outputs of the test : One set of results for every directory being monitored.

Configurable parameters for the test
Parameter Description

Test Period

How often should the test be executed.

Host

The IP address oh the host for which the test is to be configured.

Port

The port on which the specified host listens.

TargetDirs

Specify a comma-separated list of directory names to be monitored

Recursive

This flag indicates if the test must check the target directories recursively or not. If this flag is set to True, then all the sub-directories of each target directory are also checked.

Use New API

By default, this test uses the NIO JAVA APIs to collect the required metrics. To this effect, this flag is set to Yes also indicating that the test uses the latest nio.java package to collect the metrics. Set this flag to No if the latest version of NIO JAVA APIs cannot be accessed in your environment.

Minimum File Size

Specifying a value against this parameter helps in identifying the number of files in the target directory that are well within the specified value. For example, if this value is set to 1000 KB, then, the information of all files in the target directory that are below 1000 KB are collected and reported. By default, this value is set to none.

Maximum File Size

Specifying a value against this parameter helps in identifying the number of files in the target directory that are well within the specified value. For example, if this value is set to 1000 KB, then, the information of all files in the target directory that are above 1000 KB are collected and reported. By default, this value is set to none.

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

Total files

Indicates the total number of files in a target directory.

Number

 

Total sub directories

Indicates the total number of sub-directories in a target directory.

Number

 

Modified files

Indicates the number of files in the target directory that were modified in the last measurement period.

Number

 

Directory size

Indicates the total size of all the files in the target directory.

MB

If the value of this measure is found to be alarmingly high, then ensure that unnecessary files occupying large amounts of directory space are immediately identified and removed.  This is essential in order to ensure optimum use of the available disk space.

Minimum size files

Indicates the number of files in the target directory whose file size is less than the value configured against the Minimum File Size parameter.

Number

This measure will not appear if the Minimum File Size parameter is set to none in the test configuration page.

The detailed diagnosis of this measure lists the name of each file, full path to each file and the size of each file.

Large size files

Indicates the number of files in the target directory whose file size is more than the value configured against the Maximum File Size parameter.

Number

This measure will not appear if the Maximum File Size parameter is set to none in the test configuration page.

The detailed diagnosis of this measure lists the name of each file, full path to each file and the size of each file.