Agents Administration - Tests
 

Default Parameters for AppFileStatusTest

This test reports whether configured files are available or not, and if available, reports the size of the individual files.

This page depicts the default parameters that need to be configured for the AppFileStatusTest.

  • The TEST PERIOD list box helps the user to decide how often this test needs to be executed.

  • Provide a comma-separated list of the full path of the files that are to be monitored in FILENAME text box. For instance, on a Unix host, your specification can be: opt/usr/alert.log,opt/tmp/error.log. On a Windows host, your specification can be: C:\eGurkha\agent\logs\agentout.log,C:\eGurkha\agent\logs\agenterr.log.

    Also, if you want to monitor files with names that include a date, then your filename specification should indicate the date format used for naming the files. For instance, to monitor all files that are named error, but which end with dates that are of the format DDMMYY, your filename specification should be: C:\logs\errorDDMMYY. As per this specification, files such as error21082015, error22082015, and error24082015 will be monitored.

    Your filename specification can include file names with dates and without dates – for eg., C:\eGurkha\agent\logs\agentout.log,C:\eGurkha\agent\logs\agenterr.log, C:\logs\errorDDMMYY,C:\errorlogs\MMDDYYYY_error

    If you wish to monitor the latest file in a folder that consists of too many files with the same extension, say for example .log, then your FILENAME specification should be : C:\Temp\*.log.

    Note:

    Wildcard characters are not supported while entering the full path of the files in the FILENAME text box. So, provide the exact path of the files in the same.
  • Using this test, you can also monitor all files with names that include a date. If your filename specification above includes files with dates, then set the DATE PATTERN flag to Yes. If this is done, then the test will look for date patterns in your filename specification. If your filename specification does not include DATE PATTERN, set this flag to No. If this is done, then the test will not look for date patterns in your filename specification. Say that you include a file name that embeds a date pattern in your filename specification – eg., C:\logs\errorMMDDYYYY - and set the date pattern flag to No. In this case, the test will disregard the date pattern MMDDYYYY, and will instead search for a file with the name, errorMMDDYYYY.

  • Specify the time duration in hours in the MAX AGE IN HOURS text box beyond which this test should report whether/not the file configured against the FILENAME is updated. By default, this parameter is set to none.

  • Once the above value is provided, click on the Update button to register the changes made.

When changing default configurations of tests, the values with “$” indicate variables that will be replaced by the eG system according to the specific server being managed - for instance, $hostName is the host/nickname of the target host, $port is the port number of the server being monitored. E.g., for a server xyz:80, $hostName will be changed automatically by the eG manager to “xyz” and $port will be changed to “80” when configuring a test.