Monitor Folder

The Monitor Folder object triggers a Policy when the folder that you specify, or the files within that folder, have been changed.

Note: This object replaces the Monitor Folder Legacy object. For more information, see the Legacy topic.

How it is used

Use the Monitor Folder object to monitor the size of log files in a folder. If the files grow too large, the Monitor Folder object can trigger a Policy that will archive, backup, and then purge the log files to clean up the folder.

Configuration

To configure the Monitor Folder object you need to know the name of the folder that you are monitoring and what condition will trigger the Policy. Optionally, you may need to know what file types you want to monitor.

Details Tab

 

Path	Type the path to the folder that you are monitoring. You can use the ellipsis button (...) to browse for the folder.
Include sub-folders	Select this option to monitor the files and folders in sub-folders below the folder that you specified.
Filters	Create filters with custom criteria for the files that you want to monitor. Perform the following for each filter that you want to create: 1. Click Add. The Select Filter dialog appears. 2. From the Name drop-down list, select the criteria that you want to use. The Relation and Value items change and present custom options according to the criteria that you select from the Name drop-down list. 3. Select options from the Relation and Value items. 4. Click OK.

Triggers Tab

 

Number of files is	Select this option to trigger the Monitor Folder object if the number of files is greater than, equal to, or less than the value that you provide. Select the criteria from the drop-down list and type the value in the field.
Total file size is	Select this option to trigger the Monitor Folder object if the total file size of the folder is greater than or less than the value that you provide. Select the criteria from the first drop-down list, type the value in the field, and select the unit of measure from the last drop-down list.

Authentication Tab

 

Username	Type the username required to access the folder if it is on a remote computer.
Password	Type the password required to access the folder if it is on a remote computer.

Available Published Data

 

Name	Description
Include sub-folders	Indicates whether the Include sub-folders check box was checked or not.
Trigger if number of files changed	Indicates whether the Number of files is check box was checked or not.
Trigger if total file size changed	Indicates whether the Total file size is check box was checked or not.
Number of files	The number of files given to evaluate the Number of files is option.
Number of files relation	The relation that was used to evaluate the Number of files is option.
Number of files limit
Folder	The folder that was monitored.
Total file size measure	The unit of measure selected to evaluate the Total file size is option.
Total file size relation	The relation that was used to evaluate the Total file size is option.
Total file size limit
Total file size number	The number given to evaluate the Total file size is option.
Username	The username used to access the folder if it was on a remote computer.

Common Published Data