Monitor Folder
The Monitor Folder object will
trigger a Policy when the folder that you specify or the files
within that folder have been changed.
This object uses a satellite
license. See
Objects that Require Satellite
Licenses for more information.
Note: This object has been replaced by
the updated
Monitor Folder object.
Please remove this object from your Policies and replace it with
the new one as soon as possible.
How it is used
The Monitor Folder object can be
used to monitor the size of log files within 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 will need to know 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
|
Folder
|
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 to monitor the files and
folders in sub-folders beneath the folder that you have specified.
|
|
Filters
|
The Filters button enables you to specify which files
in the folder and sub-folders to
include or exclude. For more information about configuring file
filters, see File Filters
below.
|
|
Trigger Options
|
Select the condition that the
Folder being monitored must meet to
trigger the Policy:
|
•
|
Trigger
each time a file is modified - Whenever any file in the
folder and sub-folders that matches a
filter criteria is modified in the following ways:
|
|
•
|
Security or attributes
changes.
|
|
•
|
Trigger
when the size is - Specify whether the folder must be higher
than or lower than and then
specify the size. The size of the folder is determined by adding
the sizes of all the files that match the filters in the folder
and sub-folders.
|
|
•
|
Trigger
when the number of files is - Specify whether the number of
files must be higher than or
lower than and then specify the number.
The number of files is determined by all the files that match the
filters in the folder and sub-folders.
|
|
|
Trigger after a disk idle time
of
|
To run the Monitor Folder
object only when the disk is idle, configure the amount of time in
minutes or seconds that the Monitor Folder object will wait before
activating. To run the Monitor Folder object without waiting for
for the disk to become idle, type 0 (zero) in the number field.
|
File Filters
The file filters enable you to
explicitly include or exclude files from being monitored. The files
in the folder and sub-folders will be put through the filter and,
if the file matches the filter, it will be included. The filters
are processed from top to bottom. For example, you include '*.txt',
'*.log', then exclude 'temp.log' in that order.
The filter will include any files
with the extension 'txt' or 'log' except for any files with the
name 'temp.log'.
Tip: For
best results with the file filters, put all the include filters at
the top and then use exclude filters to filter out any exceptional
files.
To configure the file
filters:
|
1.
|
Click Filters. The File
Filters dialog appears.
|
|
2.
|
Type the name of the
File that you are excluding or
including. You can use the '*' and '?' wildcards to specify the
filename. These wildcards behave in the same way as the Windows
Command Prompt.
|
|
3.
|
Click Add to add the filter to the bottom of the
list.
|
|
4.
|
Select a filter and click the
Up and Down
buttons to change the order of the filters.
|
|
5.
|
Select a filter and click
Remove to delete the filter.
|
|
6.
|
Select a filter and click
Invert to change an exclude filter to
an include filter or to change an include filter to an exclude
filter.
|
Available Published Data
|
Name
|
Description
|
|
Number of new files
|
The number of new files added
to the folder.
|
|
Number of modified files
|
The number of files within the
folder that were modified.
|
|
Number of new and modified
files
|
The total number of files that
were either added or modified.
|
|
Number of deleted files
|
The number of files within the
folder that were deleted.
|
|
Folder size
|
The aggregate size of the
folder and all files within the folder.
|
|
For each file added, modified,
or deleted
|
|
Name and path of the file
|
The full path of the
file.
|
|
File size
|
The size of the file.
|
|
File Last access time
|
The last time the file was
accessed.
|
|
File last modification
time
|
The last time the file was
modified.
|
|
File creation time
|
The date and time the file was
created.
|
|
File owner
|
The owner of the file.
|
|
File extension
|
The extension of the
file.
|
|
File name
|
The name of the file.
|
|
File folder
|
The full path of the folder
that contains the file.
|
|
Name and path of the file
relative to the origin
|
The relative path of the file
relative to the base folder.
|
|
Subfolder relative to the
|
The path of the sub-folder that
contains the file, relative to the base folder.
|
|
File state
|
The state of file as detected
by the Monitor Folder object - added, modified, or deleted.
|
The filter will include any files with the extension 'txt' or 'log' except for any files with the name 'temp.log'.Tip: For best results with the file filters, put all the include filters at the top and then use exclude filters to filter out any exceptional files.To configure the file filters: