Logfile Monitoring Monitor in CCMS

You can use this monitor to search any log files for the occurrence of text patterns of your choice. This is done using a CCMS agent that takes the required information about which text pattern it should search for in which files from one or more configuration files.

Integration

As the search for the text patterns is performed by a CCMS agent, this agent must be installed and active (see Installing and Registering the CCMS Agents) on the host that contains the desired log file (or at least on a host from which it can access the desired file).

Prerequisites

You must have created the configuration files that contain the information about the log files to be monitored and the text patterns for which the agent is to search (see Monitoring Log Files with CCMS Agents).

Features

The monitor creates a subtree for every monitored file. The name of the subtree consists of a prefix and the name of the file. You can use this prefix, which you set in the configuration file for the monitoring (see Structure of the Log File Template of the Log File Agent), to differentiate between different files with the same name that you want to monitor. Each subtree consists, at most, of the following monitoring tree elements (MTEs):

MTE (Suffix of the MTE Class)	Meaning
Complete Name (.ComplPath)	Complete name including file path of the monitored log file from the point of view of the monitoring CCMS agent You can also display the content of the monitored files in the Alert Monitor. To do this, double-click the Complete Name attribute in which the name of the monitored file is displayed.
Info[] (.ApplInfo)	If you are searching for search patterns with no alert value, the system displays the line that contains the search pattern APPL_INFO_ in the text attribute Info[>] (see Examples of Logfile Templates).
Monitored Patterns (.Patterns)	Search pattern with alert value (see Examples of Logfile Templates); you can monitor a file for multiple search patterns (the system displays these in the monitor separated by |)
Lines found for pattern (.MatchingL)	Lines of the log file that match the search pattern
Data Collection Check (.MatchingL)	Time of the last check of the log file; this status attribute is always colored green.
File Time Stamp (.TimeStamp)	Time of the last change of the monitored log attribute; this attribute is only created if you specify the parameter MONITOR_LAST_FILE_MODIF=1 in the log file template
New Lines in Log File (.NewLines)	Growth of the monitored log file in lines per minute; this attribute is created only if you specify the parameter SHOWNEWLINES=1 in the log file template
Log File Size (.FileSize)	Size of the log file; this attribute is created only if you specify the parameter MONITOR_FILESIZE_KB³0 in the log file template (if MONITOR_FILESIZE_KB>0, you also assign an alert threshold value to the attribute by setting)

The MTE class consists of the value of the parameter MTE_CLASS (which is set in the corresponding log file template) and the suffix specified in the table.

Activities

To start the monitor, follow the procedure below:

...

1. Start the Alert Monitor using transaction RZ20 or choose CCMS ® Control/Monitoring ® Alert Monitor.

2. On the CCMS Monitor Sets screen, expand the SAP CCMS Monitors for Optional Components set.

3. Start the Logfile Monitoring monitor from the list by double clicking it.