Systemwalker Centric Manager 使用手引書 監視機能編 - UNIX共通 - - Microsoft(R) Windows NT(R)/Microsoft(R) Windows(R) 2000/Microsoft(R) Windows Server(TM) 2003 -

2.1.3.2 監視するログファイルを登録する

アプリケーションがログファイルに出力したテキスト形式のメッセージを監視イベントとして扱います。アプリケーションが出力するログファイルを監視する場合、監視対象のログファイルを設定する必要があります。また、ファイル名が途中で変わるログファイルも監視することができます。

設定方法は“イベント監視の定義例”を参照してください。

■呼び出し方法

1. Systemwalkerコンソールの[ツリー選択]ボックスから、環境定義を行う対象が存在するツリー(ノード一覧、ノード管理、業務管理)を選択します。
2. ノード管理ツリーまたは業務管理ツリーを選択した場合は、[ファイル]メニューから[監視ツリーの選択]を選択し、[監視ツリーの選択]ダイアログボックスに表示されるツリーの中から目的のツリーを選択します。
3. 選択したツリーの中から環境定義を行う対象のフォルダまたはノードを選択した後、[ポリシー]メニューから[ポリシーの定義]-[イベント]-[フォルダ]または[ノード]を選択し、[イベント監視の条件定義]ウィンドウを表示します。
4. [イベント監視の条件定義]ウィンドウで[環境設定]メニューから[監視ログファイル設定]を選択し、[監視ログファイル設定]ダイアログボックスを表示します。

監視ログファイル名を追加する

[監視ログファイル設定]ダイアログボックスの[追加]ボタンをクリックし、[監視ログファイル設定(追加)]ダイアログボックスを表示します。[監視ログファイル設定]ダイアログボックスでは、以下の情報を設定します。

• 監視ファイル名
• 監視するメッセージに付加するラベル名
• 監視するメッセージに付加するエラー種別

監視するメッセージにラベル、エラー種別を付加しない場合は、“ラベル、エラー種別を付加する(A)”のチェックボックスをはずしてください。

監視ログファイルを変更する

ファイル監視一覧で、変更する監視ログファイルを選択した後、[更新]ボタンをクリックし、[監視ログファイル設定(更新)]ダイアログボックスを表示して、設定内容を変更します。

監視ログファイルを削除する

ファイル監視一覧で、削除する監視ログファイルを選択した後、[削除]ボタンをクリックし、選択した監視ログファイルを削除します。

■途中でファイル名が変わるログファイルを監視する

ファイル名が途中で変わるログファイルを監視することができます。

項番	操作	状況
1)	以下のコマンドを使用して、ログファイル監視を一時停止します。 ログファイル監視の場合: opafmonext 共有ディスクログファイル監視の場合: opashrfmonext	ファイル監視機能が一時的にすべて停止します。
2)	監視対象ファイル名を変更します(監視ファイル名格納ファイルを編集します)。
3)	以下のコマンドを使用して、ログファイル監視を再開します。 ログファイル監視の場合: opafmonext 共有ディスクログファイル監視の場合: opashrfmonext	1)で一時的に停止していたファイル監視機能を再開します。

必要な定義

ファイル名が途中で変更するログファイルの監視を行う場合は、次のように定義します。

1. 通常、監視対象ファイル名を定義する個所に、ファイル名の最後が“.+@”の任意ファイル（監視ファイル名格納ファイル）を定義します。
2. 定義した監視ファイル名格納ファイルの1行目に、実際に監視を行うファイル名を記述します。監視ファイル名格納ファイルの形式の詳細は、“Systemwalker Centric Manager リファレンスマニュアル”を参照してください。

使用例

毎日0時にログファイルが切り替わるアプリケーションのローカルディスク上のログファイルを監視する定義を追加する場合、以下のようにします。

1. 監視ファイル名格納ファイル(/app/hogehogefile.+@)を作成し、アプリケーションのログファイルを記述します。

   （ログファイル名） /app/app/log20030404.txt

2. ファイル監視定義に以下の定義を追加し、必要に応じてサービス等の再起動を行います。

   /app/hogehogefile.+@ （←監視ファイル名格納ファイル）

3. 以下の作業を行うシェルを作成します。
   • ファイル監視の一時停止
   • 監視ファイル名格納ファイルの書き換え
   • ファイル監視の再開
4. 3.で作成したシェルスクリプトをcrontabに登録します。

   その際、少し余裕をみて毎日0時15分に上記シェルが動作するようにしておきます。

以上で、毎日0時に監視対象ファイルが切り替わるログファイルを監視することができます。

UNIX用シェルスクリプトの例

上記の項番(3.)のシェルスクリプトの作成例を記載します。

毎日変更されるログ	/app/applog1.+@ /app/applog2.+@
毎月1日に変更されるログ	/app/applog3.+@

#!/bin/sh

/opt/systemwalker/bin/opafmonext -p
# daily
echo `date '+app1_LOG%y%m%d.txt'` > /app/applog1.+@
echo `date '+app2_LOG%y%m%d.txt'` > /app/applog2.+@
# monthly
day=`date '+%d'`
if [ $day = "01" ]
then
 echo `date '+app3_LOG%y%m.txt'` > /app/applog3.+@
fi
/opt/systemwalker/bin/opafmonext -s

上記シェルをcrontabに日付変更後動作するように登録します。

Windows Server 2003用バッチファイルの例

上記の項番(3.)のバッチファイルの作成例を記載します。

毎日変更されるログ	c:\app\applog1.+@ c:\app\applog2.+@
毎月1日に変更されるログ	c:\app\applog3.+@

@echo off

SET YY=%DATE:~2,2%
SET MM=%DATE:~5,2%
SET DD=%DATE:~8,2%

opafmonext -p

rem daily
echo app1_LOG%YY%%MM%%DD%.txt > c:\app\app_log1.+@
echo app2_LOG%YY%%MM%%DD%.txt > c:\app\app_log2.+@
rem monthly
if "%DD%" == "01" (
 echo app3_LOG%YY%%MM%.txt > c:\app\app_log3.+@
)

opafmonext -s

ファイル監視機能を一時的に停止したり、監視を再開するコマンドを以下に示します。ファイル監視機能を一時停止しても、syslog/イベントログ監視等は停止しません。

	ログファイル監視	共有ディスクログファイル監視	備考
ファイル監視機能を一時的に停止	opafmonext -p	opashrfmonext -p	本オプションはSystemwalker動作中のみ有効
	opafmonext -x (注)	opashrfmonext -x (注)
一時停止していたファイル監視を再開	opafmonext -s	opashrfmonext -s	本オプションはSystemwalker一時停止中(-p,-xオプション)のみ有効
どのファイルを監視しているかの確認	opafmonext -f <filename>	opashrfmonext -f <filename>	本オプションはSystemwalker動作中のみ有効

注) 一時停止機能(-pオプション)を実行すると、監視対象ファイルの読込み処理が行われます。監視対象ファイルに大量にログが出力されている場合、読込み処理がすぐには終わらず一時停止に時間がかかる場合があります。この場合、“- x”オプションを指定することで、一時停止時の読込み処理を行なわずに一時停止することができます。

共有ディスクログファイル監視で本機能を使用する場合、監視一時停止、開始コマンドは運用系システムで実行してください。

◆注意事項／制限事項

• 本機能はログファイル監視機能、共有ディスクログファイル監視機能のどちらに対しても有効ですが、コマンドは別なものを使用するため、各オプションが有効な範囲はそれぞれの機能に対してのみ有効です。
• 情報初期化対象のファイルに監視の一時停止を行なってから、初期化されるまでの間に書き込まれた内容は監視（通知）されません。それ以外のファイルについては監視再開時に読み込まれます。
• 監視ファイル名格納ファイルに記述されたファイルの監視はSystemwalkerの再起動、または監視開始コマンド実行時に有効となります。
• 監視ファイル名格納ファイルは、バックアップリストアや移行の対象外です。
• 監視の一時停止は60分間で終了します。
• リモートシステムのログファイル監視は、サポートしていません。リモートシステムのログファイルを監視対象から外して下さい。

監視のしくみについて

ログファイルを定期的に確認し、ログファイルの増加分を監視します。ログ増加分から改行までを1メッセージとして切り出します。また、ログファイルのサイズが減少した場合、ファイルが一度クリアされた後、再度メッセージが追加されたと判断し、全てのファイルの内容を増分として処理します。

メッセージ発生日時は、ログファイルからメッセージを読み込んだ日時となります。また、ログファイルの増分を監視する間隔は、『通信環境定義』の『ファイル監視間隔』の定義に従います。初期値は30秒です。

監視ログファイルの形式について

• 改行コードまでを1メッセージとして処理します。
• Systemwalkerでは、監視ログファイル設定で“ラベル、エラー種別を付加する”設定を行った場合、ログファイルに出力されたメッセージを以下の形式に変換して監視します。区切り文字は、“: ”(コロン＋空白)です。ラベルおよびエラー種別を付加した合計の長さが2047バイト以下になるようにしてください。

  ラベル: エラー種別: メッセージ

  • ラベル: 監視ログファイル設定画面で設定したラベル名
  • エラー種別: 監視ログファイル設定画面で設定したエラー種別
  • メッセージ: ログファイルに書き込まれたメッセージ
• バイナリデータを含むファイルは監視できません。

  監視ログファイルの形式の詳細については、オンラインヘルプを参照してください。

監視ログファイル設定でラベルを指定する場合の注意事項

ラベル名には、以下の文字列を使用しないでください。ラベル名に下記文字列を指定した場合、メッセージ監視（フィルタリング）が正しくできない場合があります。

• INFO,情報,Information
• WARNING,警告,Warning
• ERROR,エラー,Error
• HALT,停止,Stop

^[EE]

Systemwalker Centric Manager Enterprise Editionでは、監視ログファイルとして共用ディスク上のファイルを指定しないでください。

共有ディスク上のファイルを監視する場合は、共有ディスクのファイル監視の設定を行ってください。設定方法については、各クラスタシステムの“運用管理ガイド”を参照してください。"