4.17 FindFiles

Use this Knowledge Script to monitor the number of files that match a set of criteria. This Knowledge Script raises an event if the number of matching files crosses the threshold you specify.

This Knowledge Script is supported on: [Linux].

4.17.1 Resource Object

UNIX Machine folder

4.17.2 Default Schedule

The default interval for this script is Once Every 24 Hours.

4.17.3 Setting Parameter Values

Set the following parameters as needed:

Description

How to Set It

General Settings

Root folder to begin the search

Enter the root folder path from where you want to begin the search, The default is /usr.

File name(s) can use * or ? wildcards

Enter the file name that you want to search. You can use the wild card characters * or ? when entering the file name.

Search subfolders?

Select Yes to include sub-folders in the search. The default is unselected.

Event severity when job fails

Set the event severity level, from 1 to 40, to reflect the importance of the event that is raised when the FindFiles job fails. The default is 5.

Event detail format

Select the format in which to view the event detail. The default is HTML Table.

Enable debugging?

Select Yes to enable debugging. The default is unselected.

Raise event when AppManager fails to get metrics?

Select Yes to raise an event if AppManager fails to retrieve the metrics. The default is Yes.

Event severity

Set the event severity level, from 1 to 40, to indicate the importance of an event in which AppManager fails to retrieve the metrics. The default is 5.

Event Settings

Raise event if file count threshold is exceeded?

Select Yes to raise an event if the file count threshold is exceeded. The default is Yes.

File count threshold

Enter the file count threshold value with a maximum value of 99999. The default is 500.

Severity - Exceeded threshold

Set the severity level, from 1 to 40, to indicate the importance of an event when the number of files matched exceeds the threshold. The default is 15.

File Filters

Date Modified Filter

Apply date modified filter?

Select Yes to apply a date filter to the file. The default is unselected.

Begin date (ddmmyyhhmm)

Enter the begin date for the date modified filter. The default is blank.

End date (ddmmyyhhmm)

Enter the end date for the date modified filter. The default is blank.

File Size Filter

Apply file size filter?

Select Yes to apply the file size filter. The default is unselected.

File size

Enter the file size to apply to the filter. The default is 2.

File size scale

Set the file size scales to one of the following:

  • bytes

  • kilobytes

  • megabytes

  • gigabytes

  • terabytes

The default is megabytes.

File size operator

Select file size operator. Options include:

  • less than

  • greater than

  • equal to

The default is greater than.

Raise event if Folder size of matching files exceeds the threshold.

Select Yes to raise an event. The default is unselected

Severity - Exceeded threshold

Set the severity level, from 1 to 40, to indicate the importance of an event in which the folder size of the matched files exceeds the threshold. The default is 15.

Folder size threshold

Enter the folder size threshold level. The default is 10.

Folder size scale

Set the folder size scale to one of the following:

  • kilobytes

  • megabytes

  • gigabytes

  • terabytes

Folder size operator

Select folder size operator. Options include:

  • less than

  • greater than

  • equal to

The default is greater than.

Raise event if a folder cannot be accessed?

Select Yes to raise an event if a folder cannot be accessed. The default is unselected.

Severity - Folder not accessible

Set the severity level, from 1 to 40, to indicate the importance of an event in which the folder is not accessible. The default is 25.

Maximum number of entries per event report

Enter the maximum number of entries per event report, with a maximum to 4000. The default is 1000.

Data Collection

Collect file count data?

Select Yes to collect data for charts, graphs, and reports for file count data. When selected, this script returns the number of files matched. The default is unselected.

Collect folder size data?

Select Yes to collect data for charts, graphs, and reports for folder size data. When selected, this script returns the folder size of the matched files. The default is unselected.