2.4.1 Procedure for starting log file monitoring in JP1/IM

To use JP1/IM to monitor application log file records, you can use log file trapping, which is a JP1/Base function for converting log file records to events.

To set the log file trapping:

Use IM Configuration Management to create a log file trap action-definition file on the host to be monitored.
Use IM Configuration Management to start the log file trap on the host to be monitored.

This manual describes an example of setting the log file trap for log files on host 1 in the basic configuration system shown in 1.2.1 Overview of a basic configuration system. The target log files have the following format:

Records are sequentially added from the beginning of the file (sequential file).
A line of variable-length character string is stored as a record.

Sample log file:

-----------------------------------------------------

2014/03/07 12:00:00.001 AAAA1111-E "System Error" .....

2014/03/07 12:00:00.002 AAAA1112-I "Information" .....

2014/03/07 12:00:00.003 AAAA1113-I "Warning" .....

:

-----------------------------------------------------

If you want to set the log file trap for log files of a format other than described in this manual, see the descriptions of event conversion in the JP1/Base User's Guide, and check the log file format.

Organization of this subsection

(1) Settings of the the log file trap action-definition file
(2) Using IM Configuration Management to create a log file trap action-definition file on a host to be monitored
(3) Using IM Configuration Management to start the log file trap on the host to be monitored

(1) Settings of the the log file trap action-definition file

The following provides details about the settings specified in the log file trap action-definition file. The file is created in 2.4.1(2) Using IM Configuration Management to create a log file trap action-definition file on a host to be monitored.

Specification details

Specification	Description
`FILETYPE=SEQ` `RECTYPE=VAR '\n'`	Specifies the format of the log file that is the target of the log file trap. In this manual, the target is SEQ sequential files in which a variable-length record is stored per line.
`ACTDEF=<Error>00000111 "Error"`	Specifies the event conversion condition for records written in the log file, and the severity level and event ID of an event to be issued. In this manual, records containing character string `Error` are converted to events.

Specification

Description

FILETYPE=SEQ

RECTYPE=VAR '\n'

Specifies the format of the log file that is the target of the log file trap. In this manual, the target is SEQ sequential files in which a variable-length record is stored per line.

ACTDEF=<Error>00000111 "Error"

Specifies the event conversion condition for records written in the log file, and the severity level and event ID of an event to be issued. In this manual, records containing character string Error are converted to events.

The following shows an example of a record to be converted to an event, and an example of an event after conversion.

Record to be converted to an event:

2014/03/07 12:00:00.001 AAAA1111-E "System Error" .....

Event after conversion

Severity level: Error
Event ID: 00000111
Message: 2014/03/07 12:00:00.001 AAAA1111-E "System Error" .....

To Page Top

(2) Using IM Configuration Management to create a log file trap action-definition file on a host to be monitored

The following describes how to use IM Configuration Management to create a log file trap action-definition file in order to set the log file trap. Perform this procedure on the host to be monitored.

Prerequisites

The following conditions must be satisfied:

The basic configuration system is set up according to 2.1.1 Procedure for setting up a system by using IM Configuration Management.
Host information has been collected.

Procedure

From the Windows Start menu, select All Programs, JP1_Integrated Management - View, and then Configuration Management. The Login window appears.
Enter jp1admin for User name, jp1admin for Password, and admin for Host to connect, and then log in. The IM Configuration Management window appears.
Click the IM Configuration tab. Then, in the tree area on the IM Configuration page, select the hosts on which you want to monitor log files.
On the menu bar, select View, and then Display Profiles. The Display/Edit Profile window appears.
In the tree display area, select JP1/Base.
In the pop-up menu displayed by right-clicking, select Exclusive Editing Settings to obtain exclusive editing rights.
In the tree display area, select Log File Trapping.
In the pop-up menu displayed by right-clicking, select Add Profile to add a log file trap name.
Specify a log file trap name.

Enter a unique log file trap name in the text box that appears. Note that the log file trap is managed by the log file trap name entered here.
Click the OK button.

The added log file trap name appears in the tree display area. The contents of the log file trap definition file corresponding to the log file trap name appear in the node display area of the Display/Edit Profile window.

Note that immediately after the log file trap name is added, nothing is set in the log file trap action-definition file.
Edit the log file trap action-definition file as shown in the following figure.
When a dialog box asking you whether you want to apply the settings appears, click the Yes button.

Related topics

3.5.1 Setting the profiles on hosts in an agent configuration in the Configuration Guide
4.1.2 IM Configuration page in the manual GUI Reference
4.9 Display/Edit Profiles window in the manual GUI Reference
Descriptions about converting application program log files in the JP1/Base User's Guide
Descriptions of the log file trap action-definition file in the JP1/Base User's Guide

To Page Top

(3) Using IM Configuration Management to start the log file trap on the host to be monitored

The following describes how to use IM Configuration Management to start the log file trap in order to monitor application log file records with JP1/IM. Perform this procedure on the host to be monitored.

Prerequisites

The following conditions must be satisfied:

A log file trap action-definition file has been created on the host to be monitored.
Exclusive editing rights for profiles have been obtained forJP1/Base on the host to be monitored.
TheJP1/Base LogTrap service is running on the host to be monitored.

Procedure

In the tree display area of the Display/Edit Profile window, select the log file trap name for the log file trap you want to start.
Start the log file trap by using either of the following methods:
- On the menu bar, select Operation, and then Start Process.
- In the pop-up menu displayed by right-clicking, select Start Process.

Related topics

3.5.1 Setting the profiles on hosts in an agent configuration in the Configuration Guide
4.9 Display/Edit Profiles window in the manual GUI Reference
Descriptions of converting application program log files in the JP1/Base User's Guide

To Page Top