JP1/Base 運用ガイド
形式
retry-times=リトライ回数(イベントサービスへの接続用)
retry-interval=リトライ間隔(イベントサービスへの接続用)
open-retry-times=リトライ回数(ログファイルのオープン用)
open-retry-interval=リトライ間隔(ログファイルのオープン用)
read-retry-times=リトライ継続回数のしきい値(ログファイルの読み込み用)
hold-count=JP1イベントの保留件数
keep-event={ OLD | NEW }
FILETYPE={ SEQ | SEQ2 | WRAP1 | WRAP2 | HTRACE }
RECTYPE={VAR{’¥n’|’1行の終了文字’|’1行の終了記号’}|FIX レコード長}
HEADLINE=ヘッダーの行数
HEADSIZE=ヘッダーのサイズ
MARKSTR=[!]"正規表現"
[!]"正規表現n"※
ACTDEF=[{EXIT}][<重大度>]イベントID [!]"正規表現"
[!]"正規表現n"※
- 注※ 「正規表現n」は複数個の指定を表します。
ファイル名
任意
格納先ディレクトリ
任意
次に示すディレクトリにjevlog.confの名称のログファイルトラップ動作定義ファイルを作成した場合は,jevlogstartコマンドの-fオプションの指定を省略できます。
- Windowsの場合
- インストール先フォルダ\conf\
- UNIXの場合
- /etc/opt/jp1base/conf/
任意のディレクトリに任意のファイル名でログファイルトラップ動作定義ファイルを作成した場合は,jevlogstartコマンドの-fオプションにディレクトリ名を補ったファイル名を指定する必要があります。
説明
監視するログファイルの形式や,監視失敗時のリトライなどを設定しておくファイルです。ログファイルトラップ動作定義ファイルは初期設定では提供されません。ユーザーが作成する場合と,定義配布機能によって作成される場合があります。
定義の反映時期
jevlogstartコマンドまたはjevlogreloadコマンドを実行すると,設定が有効になります。jevlogstartコマンドおよびjevlogreloadコマンドの詳細については,「13. コマンド」の「jevlogstart」,「jevlogreload」を参照してください。
記述内容
ログファイルトラップ動作定義ファイルには,次に示す規則があります。
- 行の先頭に#(0x23)を指定すると,その行はコメント行になります。
- 1カラム目から入力します。
- パラメーターと値は「=」でつなぎます。パラメーターと「=」との間には空白を入れてもかまいませんが,「=」と値の間には空白を入れないでください。また,一つのパラメーターに対して複数の値を指定する場合,値と値の間には空白を入れます。空白とは,一つ以上の半角スペース,またはタブのことです。次に例を示します。
(例)FILETYPE△△=SEQ
(例)ACTDEF=0△message
(凡例)△:1個の空白
- 値の後ろ(値が複数ある場合は最後の値)と改行の間にはコメントを記入することはできません。空白以外は入れないでください。
- retry-times=リトライ回数(イベントサービスへの接続用)
- 一時的な通信障害で,イベントサービスへの接続に失敗した場合に行うリトライの回数を指定します。値は,0〜86,400(回)の10進数で指定します。このパラメーターを省略すると,リトライは行われません。
- なお,リトライ回数とリトライ間隔の指定に関係なく,リトライを開始してから86,400秒(24時間)経過するとエラーとなります。
- retry-interval=リトライ間隔(イベントサービスへの接続用)
- 一時的な通信障害で,イベントサービスへの接続に失敗した場合に行うリトライの間隔を指定します。リトライ回数を1以上に設定した場合に有効となります。リトライ間隔は,イベントサービスへの接続に失敗してから次にイベントサービスへの接続を試みるまでの間隔です。イベントサービスへの接続処理に掛かる時間は含みません。値は,1〜600(秒)の10進数で指定します。このパラメーターを省略すると,10秒が仮定されます。
- なお,リトライ回数とリトライ間隔の指定に関係なく,リトライを開始してから86,400秒(24時間)経過するとエラーとなります。
- open-retry-times=リトライ回数(ログファイルのオープン用)
- ログファイルトラップの開始時に,一時的にログファイルをオープンできなかった場合に行うリトライの回数を指定します。値は,1〜3,600(回)の10進数で指定します。このパラメーターを省略すると,1回が仮定されます。
- なお,リトライ回数とリトライ間隔の指定に関係なく,リトライを開始してから3,600秒(1時間)経過するとエラーとなります。
- open-retry-interval=リトライ間隔(ログファイルのオープン用)
- ログファイルトラップの開始時に,一時的にログファイルをオープンできなかった場合に行うリトライ間隔を指定します。リトライ間隔は,ログファイルのオープンに失敗してから,次にログファイルのオープンを試みるまでの間隔です。値は,1〜600(秒)の10進数で指定します。このパラメーターを省略すると,1秒が仮定されます。
- なお,リトライ回数とリトライ間隔の指定に関係なく,リトライを開始してから3,600秒(1時間)経過すると,エラーとなります。
- read-retry-times=リトライの継続回数のしきい値(ログファイルの読み込み用)
- 一時的にログファイルの読み込みに失敗した場合に行うリトライの,継続回数のしきい値を指定します。リトライの継続回数のしきい値とは,10ミリ秒間隔で5回行うリトライを1セットとしてカウントした回数です。10ミリ秒間隔で5回行うリトライが,このパラメーターに指定した回数を超えると,エラーとなります。値は,1〜1,000(回)の10進数で指定します。このパラメーターを省略すると,100回が仮定されます。
- hold-count=JP1イベントの保留件数
- リトライ処理中に保留できるJP1イベントの件数を指定します。値は,1〜1,000(件)の10進数で指定します。このパラメーターを省略すると,100件が仮定されます。
- リトライ処理をする場合,リトライ処理中に変換されたJP1イベントを保留するためのリソースが必要となります。リトライ処理をする場合に必要なメモリー所要量を次に示します。
- JP1イベントの保留件数 × 1キロバイト
- keep-event={ OLD | NEW }
- リトライ処理中に保留されたJP1イベントが保留件数を超過した場合,超過したJP1イベントは消去されます。超過した場合に,古いJP1イベントと新しいJP1イベントのどちらを残すかを指定します。このパラメーターを省略すると,OLDが仮定されます。
- OLD
- 古いJP1イベントを残したい場合に指定します。この場合,hold-countパラメーターに指定したJP1イベントの保留件数までJP1イベントを保留し,以降に発生したJP1イベントは保留されずに消去されます。
- NEW
- 新しいJP1イベントを残したい場合に指定します。この場合,JP1イベントの保留件数を超過すると,古いJP1イベントから消去されます。
- FILETYPE={ SEQ | SEQ2 | WRAP1 | WRAP2 | HTRACE }
- 読み込むログファイルのデータ出力形式を指定します。このパラメーターを省略すると,SEQが仮定されます。
- SEQ
- シーケンシャルファイル(一つのログファイルに追加書き込みし続けるファイル,またはログファイルが一定の容量に達すると,別のファイル名で新たにログファイルを作成して書き込むファイル)の場合に指定します。
- SEQ2
- 次のようなファイルの場合に指定します。
- Windowsの場合
同一ボリューム内でファイル名を変更したあと,変更前のファイル名と同じ名称のファイルを作成して新たにログを書き込むファイルです。
- UNIXの場合
ファイル名を変更,またはファイルをいったん削除したあと,変更/削除前のファイル名と同じ名称のファイルを作成して新たにログを書き込むファイルです。
- 注意事項
- SEQ2で監視する場合,監視間隔の間にログファイルが1回切り替わると,切り替わる前のファイル内から前回読み込んだデータ以降に蓄積されたデータを読み込んだあと,新たなファイル内のデータを読み込みます。そのため,監視間隔の間に2回以上切り替わると,切り替わる直前のファイルからのデータしか読み込めません。ログファイルが切り替わる頻度を考慮してjevlogstartコマンドの-tオプション(監視間隔)を設定してください。
- WRAP1
- ラップアラウンドファイル(ラップアラウンドして,再び先頭からデータを上書きするファイル)の場合に指定します。
- WRAP1の場合,読み込むログファイルのコピーを作成して,そのコピーと現在のログファイルを比較して読み込み位置を決定するため,監視するファイルの容量と同じサイズのディスク容量が必要です。
- 注意事項
- WRAP1で大容量のファイルを監視する場合,書き込んでいるデータ位置がファイルの最後の方にあると,最初のJP1イベントが発生するまでに時間が掛かります。
- WRAP2
- ラップアラウンドファイル(ラップアラウンドするとき,データを削除して再び先頭からデータを書き込むファイル)の場合に指定します。
- 統合トレースログを監視する場合はWRAP2を適用してください。
- ファイルを削除または名称を変更して作成し直す運用の場合は,SEQ2を指定してください。
- 注意事項
- WRAP2の場合,データをすべて読み込む前にラップアラウンドしてデータが削除されると,読み込めないデータが発生します。監視間隔を長くすると,一度に読み込むデータの量が多くなるため,jevlogstartコマンドの-tオプション(監視間隔)の指定に注意してください。
- JP1/Baseは,ラップアラウンドしたことを,ファイルのサイズが小さくなったことで検知しています。ラップアラウンド前とラップアラウンド後のファイルのサイズが同じである場合やラップアラウンド後のファイルのサイズが大きい場合,ラップアラウンドしたと判断しないため注意が必要です。
- HTRACE
- マルチプロセス対応トレースファイル(複数のプロセスが一組のトレースファイルを共有し,メモリマップドファイルを使用した固定サイズのファイル)の場合に指定します。
- ログファイルへの書き込み方法はWRAP1と同様で,ログファイルが一定の容量に達するとラップアラウンドして,再び先頭からデータを上書きします。
- RECTYPE={ VAR { ’\n’| ’1行の終了文字’ | ’1行の終了記号’} | FIX レコード長 }
- 読み込むログファイルのレコード形式を指定します。このパラメーターを省略すると,RECTYPE=VAR ’\n’が仮定されます。つまり,可変長で「\n」が1行の区切りというレコード形式の指定になります。
- VAR
- 可変長のレコード形式の場合に,1行の終了文字,または1行の終了記号を指定します。C言語でのキャラクター1文字の指定と同じように「’’」で囲み,エスケープシーケンスでも指定できます。
- FIX
- 固定長のレコード形式の場合に,レコード長を1行の区切りとして指定します。レコード長は,1〜9,999,999(バイト)の10進数で指定します。
- HEADLINE=ヘッダーの行数
- 読み込むログファイルの先頭にヘッダーがある場合,ヘッダーの行数を,0〜99,999(行)の10進数で指定します。このパラメーターを省略すると,0行が仮定されます。
- HEADSIZE=ヘッダーのサイズ
- 読み込むログファイルの先頭にヘッダーがあり,かつそのヘッダーが行数で指定できない場合,ヘッダーのサイズを,0〜9,999,999(バイト)の10進数で指定します。行数で指定できないヘッダーとは,バイナリーデータや,レコード形式がログデータと異なっているヘッダーなどです。HEADLINEパラメーターを指定しているときには,このパラメーターは無効になります。このパラメーターを省略すると,0バイトが仮定されます。
- MARKSTR=[!]"正規表現"
- ログデータ以外のデータなど,監視の対象外にしたいデータを正規表現で指定します。正規表現は「" "」で囲んでください。ログデータ以外のデータとは,一定間隔でログファイル中に出力されるデータなどです。ログデータ以外のデータの例を次に示します。
(例)"==== 13:00:00 JP1/Base Event ===="- 「!」を「" "」の前に付けた場合,除外条件となり,指定した正規表現に一致しないデータを監視の対象外とします。
- 一つのMARKSTRパラメーターには,複数の正規表現を指定できます。複数の正規表現を指定した場合,AND条件となり,「!」の指定も含むすべての正規表現の条件に一致するデータだけを監視対象外とします。なお,複数の正規表現を指定する場合は,正規表現の間を改行で区切ってください。2行目からは値だけを指定します。この場合,2行目以降の値の前に一つ以上の空白を入れてください。次に,「====」および「MARK」を含むデータを監視の対象外に指定する場合の例を示します。
(例)MARKSTR="===="(改行) △△△△△"MARK" (凡例)△:空白- このパラメーターは複数指定できます。指定できる個数に制限はありません。複数指定した場合,OR条件となり,それぞれの指定に一致するデータをすべて監視対象外とします。
- このパラメーターに指定した正規表現がチェックされるのは,入力したログデータのうち,先頭からjevlogstartコマンドの-mオプションで指定した長さまでの間だけです。このパラメーターを省略すると,ログデータ以外のデータはないと仮定されます。
- ACTDEF=[{EXIT}][<重大度>]イベントID [!]"正規表現"
- JP1イベントに変換するログデータの正規表現と,対応するJP1イベントのイベントIDおよび重大度を指定します。正規表現に一致するログがあると,指定したイベントIDでJP1イベントを発行します。なお,「=」,「{EXIT}」,「<重大度>」,および「イベントID」の間にはスペースまたはタブを入れないでください。入れた場合は文法エラーになります。
- {EXIT}
- 複数のACTDEFパラメーターを指定した場合に,「{EXIT}」を指定した条件に一致した時点で,そのログデータの監視を終了します。
- 複数のACTDEFパラメーターを指定した場合,一つのログデータが複数のACTDEFパラメーターの条件に一致すると,一致した数だけJP1イベントが発行されます。「{EXIT}」を指定しておくと,「{EXIT}」を指定した条件のイベントIDでJP1イベントが発行され,以降の監視は行われません。
- 「{EXIT}」を指定した場合,および指定しない場合の処理の違いを次の図に示します。
図14-5 ログファイルトラップ動作定義ファイル指定例
- <重大度>
- JP1イベントの拡張属性の重大度を「< >」で囲んで指定します。重大度とイベントIDは,対にして指定します。指定できる値を次に示します。
- Emergency
- Alert
- Critical
- Error
- Warning
- Notice
- Information
- Debug
- 指定を省略した場合はNoticeが仮定されます。
- イベントID
- イベントサーバにJP1イベントを登録する際のイベントIDを指定します。イベントIDは上位4バイト(基本コード)と下位4バイト(拡張コード)をコロン「:」で区切り,16進数で記述します。A〜Fは大文字で記述してください。なお,下位4バイトまたはコロン以下の下位4バイトは省略できます。この場合,省略値には0を仮定します。また,上位下位とも8桁に満たない場合は前から補われます。ユーザーが指定できる範囲の値,0:0〜1FFF:0および7FFF8000:0〜7FFFFFFF:0を指定してください。なお,拡張コードには0を指定してください。イベントIDの表記例を次に示します。
- (例)次に示す3通りの表記は同じ意味になります。
0000011A:00000000 11A:0 11A
- "正規表現"
- JP1イベントに変換するログデータを正規表現で指定します。正規表現は「" "」で囲んでください。「!」を一つ目の「" "」の手前に付けた場合,除外条件となり,指定した正規表現に一致しないデータを変換対象とします。
- 一つのACTDEFパラメーターには,複数の正規表現を指定できます。複数の正規表現を指定した場合,AND条件となり,「!」の指定も含むすべての正規表現の条件に一致するデータだけをJP1イベントに変換します。なお,複数の正規表現を指定する場合は,正規表現の間を改行で区切ってください。2行目からは正規表現だけを指定します。この場合,2行目以降の値の前に一つ以上の空白を入れてください。次に,「jp1base」および「error」を含むデータを,イベントID「00000333」でJP1イベントに変換する場合の指定例を示します。
(例)ACTDRF=00000333 "jp1base"(改行) △△△△△"error" (凡例)△:空白- このパラメーターは複数指定できます。指定できる個数に制限はありません。複数指定した場合,OR条件となり,それぞれの指定に一致するデータをすべてJP1イベントに変換します。
- このパラメーターに指定した正規表現がチェックされるのは,入力したログデータのうち,先頭からjevlogstartコマンドの-mオプションで指定した長さまでの間だけです。
- このパラメーターは省略できません。
注意事項
- MARKSTR,およびACTDEFパラメーターで指定できる正規表現は,OSによって異なります。また,Linuxの場合,MARKSTR,およびACTDEFパラメーターで指定する正規表現に日本語を指定できません。.(ピリオド)2個が日本語文字1個にマッチするなどの動作になります。正規表現の文法の詳細については,「付録F 正規表現の文法」を参照してください。
- 次の誤りがある場合は,jevlogstartコマンド実行時にKAVA3646-Eのメッセージが標準エラー出力に出力され,ログファイルトラップの起動に失敗します。
なお,jevlogstartコマンドに-rオプションを指定して実行した場合は,ログファイルトラップは,監視対象のログファイルが作成されるまで待機します。ファイル形式の指定に上記の誤りがある場合は,ログファイルが作成されたあとにKAVA3646-Eのメッセージがsyslog,イベントログ,および統合トレースログに出力され,ログファイルトラップが停止します。
- ログファイルがマルチプロセス対応トレースであるが,ログファイルトラップ動作定義ファイルのファイル形式にHTRACEが指定されていない
- ログファイルがマルチプロセス対応トレース以外であるが,ログファイルトラップ動作定義ファイルのファイル形式にHTRACEが指定されている
このエラーメッセージが出力された場合は,ログファイルトラップ動作定義ファイルのファイル形式を指定し直してからjevlogstartコマンドを再度実行してください。
このほかのケースでファイル形式の指定を誤った場合は,ログファイルトラップの起動後,ログファイルが一定量に達して切り替わったときに,エラーメッセージおよびJP1イベント(00003A22)で通知します。JP1イベントの詳細については,「15.3(6) イベントID:00003A22の詳細」を参照してください。
JP1イベント(00003A22)が通知された場合は,エラーメッセージで示されるログファイルの状態を確認し,ログファイルトラップ動作定義ファイルのデータ出力形式(FILETYPE)を正しく定義してください。
また,形式を誤った状態のままで運用を継続しても正しく監視されません。データ出力形式を正しく定義したあと,ログファイルトラップを再起動してください。
JP1イベント(00003A22)が通知されるケースを,ログファイルの形式ごとに示します。
表14-10 ファイル形式ごとのJP1イベントが通知されるケース
ログファイルトラップ動作定義ファイルに指定したファイル形式 異常となるケース SEQ
- ログファイルが削除された場合
- ログファイルのサイズが小さくなった場合
- ログファイルが削除されたあと,同じ名称で再作成された場合※
SEQ2
- リネームして再作成される前に,ログファイルのサイズが小さくなった場合
WRAP1
- ログファイルが削除された場合
- ログファイルのサイズが小さくなった場合
- ログファイルが削除されたあと,同じ名称で再作成された場合※
WRAP2
- ログファイルが削除された場合
- ログファイルが削除されたあと,同じ名称で再作成された場合※
HTRACE
- ログファイルが削除された場合
- ログファイルが削除されたあと,同じ名称で再作成された場合
注※ ログファイルの形式がSEQ2の可能性があるため,ログファイルトラップ動作定義ファイルに指定したファイル形式を見直してください。
定義例
- MARKSTRパラメーターおよびACTDEFパラメーターの定義例
次に示すログデータを基に,MARKSTRパラメーターおよびACTDEFパラメーター部分の定義例を説明します。
定義例1
ログファイルトラップの条件を左に,ログファイルトラップ動作定義ファイルの定義例を右に示します。
定義例2
定義例1とは異なるログファイルトラップの条件を左に,ログファイルトラップ動作定義ファイルの定義例を右に示します。
定義例3
ログファイルトラップの条件を左に,ログファイルトラップ動作定義ファイルの定義例を右に示します。
All Rights Reserved. Copyright (C) 2009, 2011, Hitachi, Ltd.