Directory Updates Test

This test monitors specific directories for files that are older than a configured duration.

Target of the test : Any host

Agent deploying the test : An internal agent

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

Configurable parameters for the test
Parameter Description

Test Period

How often should the test be executed.

Host

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

Port

The port at which the specified host listens.

Directory List

This text box takes a comma separated list of directory paths that are to be monitored. For example, if you want to monitor a directory called temp in the C drive, then you need to specify, c:\temp. If you would like to monitor a directory named root which is a sub-directory of temp, then your specification should be: c:\temp\root. To monitor both the temp and root directories in our example, specify the following in the Directory List text box: c:\temp,c:\temp\root. Alternatively, your specification can also be of the following format: DisplayName@DirPath. For instance, to monitor the c:\temp directory, your specification can be: Temp@c:\temp. In this case, the DisplayName Temp will appear as the descriptor of the test. You can also monitor multiple directories using the same format. For instance, to monitor the temp and root directories in the C drive, your specification can be: Temp@c:\temp,Root@c:\root. In this case, Temp and Root will be the descriptors of the test.

Hours Older

This test reports the number of old files in the configured directories. In the Hours Older text box therefore, you need to specify how old the files in the specified directory have to be, so that they are considered for monitoring by this test. For example, if the Directory List contains c:\temp, and the Hours Older text box contains the value 2, then the test will report the number of files in the temp directory that were last modified over (i.e., greater than) 2 hours before. For every directory specification in the Directory List, you can specify a corresponding value in the Hours Older text box - i.e., if 3 directories are configured in the Directory List, then the Hours Older can also contain a comma-separated list of 3 values - say, 2,3,4. In this case, the test will report the following:

  • For the first directory in the Directory List, the test will report the number of files in the directory that were last modified over 2 hours ago.
  • For the second directory in the Directory List, the test will report the number of files in the directory that were last modified over 3 hours before.
  • For the third directory in the Directory List, the test will report the number of files in the directory that were last modified over 4 hours ago.

Alternatively, you can also specify a single value in the Hours Older text box. This value will automatically apply to all the directories configured in the Directory List. In other words, the number of values that you specify in the Hours Older text box should either be 1 or should be equal to the number of directories configured in the Directory List.

Detailed Diagnosis

To make diagnosis more efficient and accurate, the eG Enterprise suite 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

Number of old files

Indicates the number of old files in this directory.

Number

In the event that the host runs out of space, you might want to check the value of this measure to figure out if there are too many old files. If so, then you can use the detailed diagnosis of this test to identify the old files, determine whether you still need the files, and if found useless, remove the files so as to make space in the directory.