jcfallogstart

〈このページの構成〉

機能
形式
実行権限
格納先ディレクトリ
引数
戻り値
使用例1
使用例2

機能

リモート監視ログファイルトラップを起動します。

このコマンドを実行すると，監視対象ホストのログファイルを収集し，リモート監視ログファイルトラップ動作定義ファイルで指定した条件に合うログの1行をJP1イベント化して，イベントサーバに登録します。

-fオプションを指定した場合，新規にリモート監視ログファイルトラップのプロファイルを追加したあと，プロセスを起動します。指定した監視対象ホストに同じ監視名のプロファイルがすでに存在する場合，プロファイルが停止中であれば，リモート監視ログファイルトラップ動作定義ファイルを上書きしたあと，リモート監視ログファイルトラップのプロセスを起動します。プロファイルが稼働中だった場合，動作定義ファイルを上書きして，サーバに保存したあとにエラーメッセージが出力され，処理を中断します。このとき，プロファイルは上書きされる前の動作定義で稼働しています。-fオプションを指定しない場合，既存のリモート監視ログファイルトラップのプロファイルのプロセスを起動します。

データの形式が異なるログファイルは同時に扱えません。この場合は，新たに別のリモート監視ログファイルトラップを起動してください。

なお，同時に実行できるコマンドの数は5個までです。

このコマンドを実行するための条件を次に示します。

IM構成管理サービスが起動している
リモートの監視対象ホストが，リモート監視構成下にある
リモートの監視対象ホストが，ホスト情報を収集済みである
SSHで通信する場合，対象のリモートの監視対象ホストと公開鍵暗号方式でSSH認証できる
NetBIOS（NetBIOS over TCP/IP）で通信する場合，監視するログファイルが共有されている

ページの先頭へ

形式

jcfallogstart
        -a 監視名
        -o 監視対象ホスト名
        [-h 論理ホスト名]
        [-f リモート監視ログファイルトラップ動作定義ファイル名
          -c 文字コード
          [-filter フィルター]
          [-m イベント化するデータの最大長（バイト）]
          [-p ログデータ出力元プログラム名]
          [-r]
          [-t ファイル監視間隔（秒）]
          ログファイル名1 […ログファイル名32]]

ページの先頭へ

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

ページの先頭へ

格納先ディレクトリ

Windowsの場合: Managerパス\bin\imcf\
UNIXの場合: /opt/jp1imm/bin/imcf/

ページの先頭へ

引数

-a 監視名

リモート監視ログファイルトラップを識別する監視名を指定します。

監視名は30バイト以内の文字列で指定します。使用できる文字は英数字，ハイフン，およびアンダーラインで，先頭の文字は必ず英数字を指定します。大文字，小文字は区別されません。

なお，監視名と監視対象ホストの組は一意である必要があり，jcfallogstartで指定したほかの監視名と監視対象の組との重複はできません。ただし，JP1/Baseのjevlogstartで指定される監視名との重複はできます。

-o 監視対象ホスト名

起動したいリモート監視ログファイルトラップの監視対象ホスト名を指定します。

-h 論理ホスト名

このコマンドを実行させたい論理ホスト名を指定します。省略した場合は，環境変数JP1_HOSTNAMEに指定されている論理ホスト名が設定されます。JP1_HOSTNAMEに論理ホスト名が設定されていない場合は，物理ホスト名が設定されます。

-f リモート監視ログファイルトラップ動作定義ファイル名

動作定義ファイル名は，フルパスまたはカレントディレクトリからの相対パスで，256バイト以下で指定します。相対パスを指定する場合は，ディレクトリ名を補ったフルパス名が256バイト以下になるように指定してください。

動作定義ファイルは任意のディレクトリに配置し，任意のファイル名を指定できます。

このオプションを指定した場合，新規にリモート監視ログファイルトラップを作成して起動します。このオプションを省略した場合は，既存のリモート監視ログファイルトラップを起動します。

-c 文字コード

ログファイルの文字コードを指定します。-fオプションを指定したときだけ指定できます。

指定できる文字コードは次のとおりです。

表1‒9　文字コード
監視対象OS	日本語の場合	英語の場合	中国語の場合
AIX	SJIS SJISを指定した場合，SJIS/Ja_JPが設定されます。 SJIS/Ja_JP SJIS/Ja_JP.IBM-932 EUC EUCを指定した場合，EUC/ja_JPが設定されます。 EUC/ja_JP EUC/ja_JP.IBM-eucJP UTF-8 UTF-8を指定した場合，UTF-8/JA_JPが設定されます。 UTF-8/JA_JP UTF-8/JA_JP.UTF-8 C	C	GB18030 GB18030を指定した場合，GB18030/Zh_CN.GB18030が設定されます。 GB18030/Zh_CN.GB18030 GB18030/Zh_CN UTF-8 UTF-8を指定した場合，UTF-8/ZH_CNが設定されます。 UTF-8/ZH_CN UTF-8/ZH_CN.UTF-8 C
HP-UX	SJIS SJISを指定した場合，SJIS/ja_JP.SJISが設定されます。 SJIS/ja_JP.SJIS SJIS/japanese EUC EUCを指定した場合，EUC/ja_JP.eucJPが設定されます。 EUC/ja_JP.eucJP EUC/japanese.euc UTF-8 UTF-8を指定した場合，UTF-8/ja_JP.utf8が設定されます。 UTF-8/ja_JP.utf8 C	C	GB18030 GB18030を指定した場合，GB18030/zh_CN.gb18030が設定されます。 GB18030/zh_CN.gb18030 UTF-8 UTF-8を指定した場合，UTF-8/zh_CN.utf8が設定されます。 UTF-8/zh_CN.utf8 C
Linux	SJIS/ja_JP.sjis^※1 SJIS/ja_JP.SJIS^※1 UTF-8 UTF-8を指定した場合，UTF-8/ja_JP.UTF-8が設定されます。 UTF-8/ja_JP.UTF-8 UTF-8/ja_JP.utf8 C	C	GB18030 GB18030を指定した場合，GB18030/zh_CN.gb18030が設定されます。 GB18030/zh_CN.gb18030 UTF-8 UTF-8を指定した場合，UTF-8/zh_CN.utf8が設定されます。 UTF-8/zh_CN.utf8 C
Solaris	EUC EUCを指定した場合，EUC/jaが設定されます。 EUC/ja EUC/japanese EUC/ja_JP.eucJP SJIS SJISを指定した場合，SJIS/ja_JP.PCKが設定されます。 SJIS/ja_JP.PCK UTF-8 UTF-8を指定した場合，UTF-8/ja_JP.UTF-8が設定されます。 UTF-8/ja_JP.UTF-8 C	C	GB18030 GB18030を指定した場合，GB18030/zh_CN.GB18030が設定されます。 GB18030/zh_CN.GB18030 GB18030/zh_CN.GB18030@pinyin GB18030/zh_CN.GB18030@radical GB18030/zh_CN.GB18030@stroke UTF-8 UTF-8を指定した場合，UTF-8/zh.UTF-8が設定されます。 UTF-8/zh.UTF-8 UTF-8/zh_CN.UTF-8 UTF-8/zh_CN.UTF-8@pinyin UTF-8/zh_CN.UTF-8@radical UTF-8/zh_CN.UTF-8@stroke C
Windows	SJIS	SJIS^※2 C	GB18030

注※1: 監視対象OSがSUSE Linuxの場合だけ有効です。
注※2: 英語OSの場合，文字コードにSJISを指定してもCで動作します。

-filter フィルター

事前フィルターによって，リモートの監視対象ホスト側で取得したログファイルをフィルタリングする場合に，フィルターを正規表現で指定します。

このオプションを指定すると，指定した正規表現と一致したログデータだけがマネージャーに転送されます。これによって，リモートの監視対象ホストからマネージャーに転送されるログファイルのデータ量を抑制できます。

このオプションは，-fオプションを指定したときだけ指定できます。

このオプションは，リモートの監視対象ホストがUNIXの場合だけ有効です。前提条件として，SSH接続でgrepコマンドが実行できる必要があります。リモートの監視対象ホストがWindowsの場合は，このオプションを指定しても無視されます。

指定できる正規表現の形式は，リモートの監視対象ホストのgrepコマンドの-Eオプションに指定できる拡張正規表現の形式と同一です。環境変数は使用できません。

正規表現は128バイト以内の文字列で指定します。使用できる文字列は，「'」，「"」，「<」，「>」，および制御文字を除く半角英数字，半角スペース，記号です。文字列に半角スペースが含まれている場合は，前後をダブルクォーテーション「"」で囲む必要があります。

grepコマンドのパス例を次に示します。詳細は，各OSのgrepコマンドのマニュアルを参照してください。

Linuxの場合：/bin/grep
Solarisの場合：/usr/xpg4/bin/grep
Linux，Solaris以外の場合：/usr/bin/grep

-m イベント化するデータの最大長（バイト）

ログファイルの1行を，先頭から何バイト読み込むかを指定します。指定できるバイト数は1〜1,024です。このオプションを省略した場合は512が設定されます。

行の終了文字は終了記号「\0」に変更されます。ログファイルの1行がこのオプションで指定されたバイト数を超える場合，最後の1バイトが「\0」に変更されます。

このオプションで指定した値は，入力したログファイルの1行の有効範囲を示します。したがって，リモート監視ログファイルトラップ動作定義ファイルのMARKSTRパラメーターの正規表現とACTDEFパラメーターの正規表現をチェックするのは，ここで指定した範囲内です。つまり，有効範囲を超えたカラムに対応する正規表現があっても，それらはチェックの対象にはなりません。

-p ログデータ出力元プログラム名

ログデータを出力するプログラム名を指定します。指定した名前はJP1/IM - Viewの［イベントコンソール］画面に表示されます。

表示される名称は次のとおりです。

Windowsの場合: /HITACHI/JP1/NT_LOGTRAP/ログデータ出力元プログラム名
UNIXの場合: /HITACHI/JP1/UX_LOGTRAP/ログデータ出力元プログラム名

このオプションを省略すると，Windowsの場合は「/HITACHI/JP1/NT_LOGTRAP」，UNIXの場合は「/HITACHI/JP1/UX_LOGTRAP」と表示されます。

-r

このオプションを指定すると，次の場合に，ログが収集できるようになるまで，-tオプションで指定した間隔で収集を試みます。

リモート監視ログファイルトラップの起動時に，リモートの監視対象ホストにアクセスできない場合
リモート監視ログファイルトラップの稼働中に，リモートの監視対象ホストにアクセスできなくなった場合
リモート監視ログファイルトラップの起動時に，監視対象のログファイルにアクセスできない場合
リモート監視ログファイルトラップの稼働中に，監視対象のログファイルにアクセスできなくなった場合

-rオプションは，次の場合に指定してください。

リモート監視ログファイルトラップの起動後に，リモートの監視対象ホストにアクセスできるようになる場合
リモート監視ログファイルトラップの起動後に，監視対象のログファイルが作成される場合
リモートの監視対象ホストにアクセスできなくでも監視を継続したい場合

このオプションを省略した場合，次の動作となります。

リモート監視ログファイルトラップを起動した時点で，監視対象のログファイルの収集ができない場合，起動を中止し処理を終了します。
稼働中に監視対象のログファイルの収集ができなくなった場合，リモート監視ログファイルトラップ動作定義ファイルに指定したリトライ回数および間隔でリトライします。

-t ファイル監視間隔（秒）

ファイルの監視間隔を指定します。指定できる値は60〜86,400（単位：秒）です。省略した場合は300が設定されます。

WRAP2形式のログファイルを監視する場合

ラップアラウンドする頻度が高い場合や監視間隔を長く指定した場合に，リモート監視ログファイルトラップがデータを読み込む前に上書きされてしまい，データの読み込み漏れが発生するおそれがあります。データの読み込み漏れの予防策として，次の監視間隔の見積もり式を参考にしてください。

ログファイルサイズ（バイト）×ログファイル数>1秒当たりの出力サイズ（バイト）×監視間隔（秒）

ログファイル名1 […ログファイル名32]

監視するログファイル名を指定します。ログファイル名は256バイト以内の文字列で指定します。監視対象ホストがWindowsの場合は，ホスト名を除いたネットワークパス名で指定します。UNIXの場合はフルパスで指定します。なお，ワイルドカードを使用して，監視するログファイルを指定することはできません。

監視対象ホストがUNIXの場合，監視対象ファイルパスに半角英数字および「-」，「_」，「.」，「/」を含むログファイルを監視できます。それ以外の文字を含むファイルパスについては，正常に監視できない場合があります。

指定できるファイル数は32以下で，指定できるファイル形式は次の形式です。

シーケンシャルファイル(SEQ)
シーケンシャルファイル(SEQ2)
ラップアラウンドファイル(WRAP2)

ページの先頭へ

戻り値

0	起動成功
4	引数不正
6	サーバに接続できない
7	ホスト情報が不正
8	指定した監視名は稼働済み
9	プロファイルの各種制限値を超過
10	排他編集権取得エラー
11	動作定義ファイル不正
12	認証情報定義ファイル不正
13	通信エラー
14	DB不正
17	権限不正
18	I/Oエラー
21	同時実行数の上限に達した
255	内部エラー
その他の値	その他のエラー

ページの先頭へ

使用例1

host1のmonitoringNameのリモート監視ログファイルトラップを起動する場合

jcfallogstart -a monitoringName -o host1

ページの先頭へ

使用例2

リモート監視ログファイルトラップ動作定義ファイルを新規作成し，起動する場合

jcfallogstart -a monitoringName -o host2 -f actionDefinition.conf -c SJIS -filter ".*-E" /log/sample.log

ページの先頭へ