Show TOC

Select the Files that Are to Be MonitoredLocate this document in the navigation structure

Use

You can use SAP NetWeaver management agents to monitor files, for example, for their size, their existence, their last change date, or their content. You define all of this in Log File-Templates , along with information about which files are to be monitored. You do this by setting appropriate parameters in the log file template. These parameters are described below.

A separate subtree is created in the alert monitor for every file that fulfills this naming condition in the log file template. If the condition does not apply to any files, a subtree is also created. However, an alert is only generated in this case if you have set the parameter CHECK_EXISTENCE_ONLY (see below).

Features

You can use the following parameters of the log file template to determine which files are to be monitored:

DIRECTORY="<directory>" (required parameter)

Directory that contains the files that you want to monitor

FILENAME="<file name>" (required parameter)

Name of the files that are to be monitored; the file name can contain wildcards You can set the maximum number of files that are to be monitored for each file name pattern with the parameter MONITOR_NEWEST_FILES (see below).

Note

Note also that you can always set the monitoring settings for one monitored file with only ein log file template. Therefore, if there is a file with a name that fulfills the FILENAME parameter requirements in several log file templates, only the monitoring settings that apply are those from the log file template that the agent processes first.

IGNORE_FILE="<file name>" (Default: not set)

Name of the files that are not to be monitored - even if the log file meets the FILENAME condition; this file name can also contain wildcards

Example

If you want to monitor the trace files of the work process dev_w* , but do not want to monitor the previous version of these trace files, dev_w*.old , set FILENAME=dev_w* and IGNORE_FILE=dev_w*.old .

CHECK_EXISTENCE_ONLY=[0,1] (Default: =0 )

You can use this parameter to define that only the existence of the monitored file is to be monitored ( 1 ). In this case, all parameters for monitoring search patterns (more information: Select the File Content that Is to Be Monitored ) are ignored.

Note

Set this parameter if you want to make sure that an alert is generated if no file exists for which the name corresponds to the parameter FILENAME .

EXISTENCE_VALUE=RED (Default: not set)

You can use this parameter to have an alert generated if the file specified above exists. This parameter therefore extends the previous parameter CHECK_EXISTENCE_ONLY , with which an alert is generated if the file specified above does not exist.

MONITOR_NEWEST_FILES=<number> (Default: =20 )

If you specify a file name pattern for the FILENAME parameter that multiple files match, this parameter specifies the maximum number of files that are simultaneously monitored. If more files fulfill the condition, exactly the specified number of files are monitored. The files with the newest change times are those monitored.

Note

This means that different files are monitored over time. If a file is removed from monitoring because other files have a newer change date, its monitoring tree is deleted, and its alerts are reset to avoid storing an unnecessary amount of data in the monitoring infrastructure.

ENCODING=UTF-16 (Default: not set)

As of Patch 2007/5, you can monitor files that were created in UTF-16 format on Microsoft Windows platforms. To do this, you require a Unicode agent. To monitor files that were created in UTf-16 format, you need to set the keyword ENCODING=UTF-16 in the log file template.

Activities

If you want to use file monitoring with SAP NetWeaver management agents, create one or more log file templates. Specify this log file template in Configuration File SAPCCMSR.INI .

Note

If you create a log file template, take account of the information in Structure of the Log File Templates for Monitoring Files , which contains a short summary of all possible parameters. Other parameters of log file templates are described by topic in the following sections:

· Select the File Content that Is to Be Monitored

· Select the General File Properties that Are to Be Monitored

· Select the Time Periods for the File Monitoring

· Defining the Node Properties for File Monitoring

Example

More information: Example Log File Templates