1.0 汎用ログ・アダプター
1.1 汎用ログ・アダプターを継続して実行しているときに最終レコードが処理されない
1.2 汎用ログ・アダプター構成ファイルを呼び出す際の問題
1.3 UNIX 上で WebSphere
Application Server ログを構文解析する際の制限
1.4 UNIX 上で WebSphere
MQ エラー・ログを構文解析する際の制限
1.5 runregex_showlog_example.bat/sh を使用してログ・ファイルを構文解析する際の問題
1.6 DB2
診断ログのルール・パーサーによって誤ったデータが戻される
1.7 一部のログを構文解析したときに誤った時間帯情報が生成される
1.8 無効な拡張データ・エレメントが生成される
1.9 汎用ログ・アダプターのスクリプトが z/OS 上で読めない
1.10 * 汎用ログ・アダプター AIX
errpt サンプル・スクリプト runregex_errpt_example.sh が AIX 上で機能しない
1.11 静的パーサーでのログ・ファイルの継続的なモニターはサポートされない
1.12 汎用ログ・アダプターのロギング情報と制限
1.13 ログ・ファイル・タイプの検査が行われない
1.14 WebSphere Application Server の activity.log ファイルの構文解析の制限
1.15 異なるロケールで生成されたログ・ファイルの構文解析の制限
1.15 静的パーサー・アダプター・ファイルを実行したときにエディター・ペインが空になる
1.17 Windows XP の unzip ユーティリティーでの unzip の問題
汎用ログ・アダプターが継続してログ・ファイルをモニターしている場合、 終了パターンが指定されていないと、最終レコードを処理しません。最終レコードは、 汎用ログ・アダプターがシャットダウンした場合にのみ処理されます。
モニター中に最終レコードが必ず処理されるようにするには、 汎用ログ・アダプターの構成ファイルにレコードの終了パターンを提供してください。
1.2 汎用ログ・アダプター構成ファイルを呼び出す際の問題汎用ログ・アダプターの構成ファイルは、gla.bat バッチ・ファイルを使用して 呼び出された場合、正しく起動されません。
これは構成ファイルの絶対パスを使用することによって解決できます。 例: gla.bat c:¥mypathname¥static.adapter。
1.3 UNIX 上で WebSphere Application Server ログを構文解析する際の制限汎用ログ・アダプターを使用して UNIX プラットフォーム上で WebSphere Application Server のバイナリーの アクティビティー・ログまたはサービス・ログを構文解析する場合、 ユーザーは WebSphere Application Server のインストーラーと 同等またはそれ以上の権限を持っている必要があります。
この制限を回避するには、ログを構文解析する前に、 バイナリーのアクティビティー・ログまたはサービス・ログを、 汎用ログ・アダプターのユーザーと同じ特権を持つディレクトリーに移動してください。
1.4 UNIX 上で WebSphere MQ エラー・ログを構文解析する際の制限汎用ログ・アダプターを使用して UNIX プラットフォーム上で WebSphere MQ エラー・ログを構文解析する場合、 ユーザーは WebSphere MQ のインストーラーと同等またはそれ以上の 権限を持っている必要があります。
この制限を回避するには、ログを構文解析する前に、MQ エラー・ログを 汎用ログ・アダプターのユーザーと同じ特権を持つディレクトリーに移動してください。
1.5 runregex_showlog_example.bat/sh を使用してログ・ファイルを構文解析する際の問題runregex_showlog_example.bat および runregex_showlog_example.sh を使用して WebSphere Application Server アクティビティー・ログの構文解析を試行した場合、 WebSphere Application の showlog ユーティリティーが検出されません。
この問題を回避するには、regex_showlog_example.adapter ファイルを ルール・エディターで編集して、センサー・コンバーターのプロパティーが WebSphere Application Server の 正しいディレクトリー・ロケーションを指すように更新してください。
1.6 DB2 診断ログのルール・パーサーによって誤ったデータが戻されるルール・ベースのアダプター構成で DB2 診断ログ・ファイルを構文解析すると、 構文解析された出力のログ・ファイルのメッセージに余分なコロンが入ります。
現在のところ、この問題の予備手段はありません。
1.7 一部のログを構文解析したときに誤った時間帯情報が生成される一部のログを構文解析したときに誤った時間帯情報が生成されます。
時間帯情報を含むタイム・スタンプを持つログ・ファイルだけが、 正しい時間帯を持つ creationTime 値で構文解析済みデータを作成します。ログ・ファイルの タイム・スタンプに時間帯情報が含まれていない場合、汎用ログ・アダプターは 誤った時間帯情報で creationTime 値を生成します。
1.8 無効な拡張データ・エレメントが生成される汎用ログ・アダプターは、名前または型のいずれの値にも一致するルールがない場合、 ログ・レコードに対して無効な extendedDataElement 共通ベース・イベント・エレメントを 生成します。ログ・レコードから構文解析された名前または型がない場合、 extendedDataElement は生成されませんが、汎用ログ・アダプターは 値フィールドのみを持つものを生成します。
この問題を回避するには、必ず extendedDataElement の 3 つすべてのフィールド (名前、値、型) が一致するルールを提供してください。
1.9 汎用ログ・アダプターのスクリプトが z/OS 上で読めないz/OS 上で runtime.zip および rules.zip を unzip すると、 読めないスクリプト・ファイルが作成されることがあります。
この問題を回避するには、runtime.zip および rules.zip を z/OS システムで unzip する ときに、必ず以下の手順に従ってください。
unzip -a runtime.zip* 1.10 汎用ログ・アダプター AIX errpt サンプル・スクリプト runregex_errpt_example.sh が AIX 上で機能しない
unzip -a rules.zip
unzip -o rules.zip *.adapter
汎用ログ・アダプター AIX errpt サンプル・スクリプト runregex_errpt_example.sh は AIX システム上で機能しません。
この問題を回避するためには、AIX errpt サンプル・アダプター・ファイル GenericLogAdapter¥config¥AIX¥syslog¥v4¥regex_errpt_example.adapter を、 汎用ログ・アダプター構成エディターで編集して以下の変更を行ってください。
注: この問題は V6.0.0.1 で修正されました。
1.11 静的パーサーでのログ・ファイルの継続的なモニターはサポートされない静的 Java パーサー・クラスで継続してログ・ファイルを モニターすることはできません。ルール・ベースのパーサーがある場合は、それを使用して これらのログ・ファイルを継続してモニターしてください。
1.12 汎用ログ・アダプターのロギング情報と制限汎用ログ・アダプターは Eclipse 環境の外で実行されると、 hgla.log という名前のファイルにメッセージとエラーを記録します。 スタンドアロン・モードで 実行すると、hgla.log は現行作業ディレクトリーに作成されます。 ログおよびトレース・アナライザーを 使用してリモート・ログのインポート操作の一部として実行した 場合、hgla.log は UNIX または Linux システムで 実行したときにはリモート・システムの /tmp ディレクトリーに 配置され、Windows システムで実行したときには c:¥Documents and Settings¥userid¥Local Settings¥Temp に配置されます。 汎用ログ・アダプターはロギング・レベル 10、20、30、50 および 60 でイベントを記録します。 hgla.log ファイルをログおよびトレース・アナライザーにインポートして、 ログ・ファイルの構文解析中に汎用ログ・アダプターが検出した問題を診断することができます。
Eclipse 環境で、例えばログおよびトレース・アナライザーを使用して ローカル・ログのインポート操作の一部として実行した場合、 汎用ログ・アダプターは hgla.log ファイルに、 または他のどのロケーションにもメッセージを記録しません。
1.13 ログ・ファイル・タイプの検査が行われない汎用ログ・アダプターは、構文解析中のログ・ファイルのタイプが アダプター・ファイル構成に一致するかどうかを判別するための検査を行いません。 例えば、 アダプター・ファイルのセンサー構成に指定されたログ・ファイルが、 パーサー構成の抽出構成および置換規則の設計対象のタイプでない場合、 予期しない結果になることがあります。 構文解析はエラーなしで成功する可能性がありますが、 結果の共通ベース・イベント・データが誤りになります。 構文解析は、 誤ったデータを検出したことを示すエラー・メッセージを表示して失敗する可能性があります。
この問題を回避するには、センサー・コンポーネント構成に指定された ログ・ファイルが正しいタイプであることを確認してください。
1.14 WebSphere Application Server の activity.log ファイルの構文解析の制限バイナリーの WebSphere Application Server のアクティビティー・ログ・ファイルを 英語以外のマシン上で runregex_showlog_example.bat/sh を使用して構文解析すると、 ログ・レコード・データが共通ベース・イベントに正しくマップされません。 代わりに、いくつかのログ・レコード・データが共通ベース・イベントの 誤ったフィールドに表示されることがあります。
1.15 異なるロケールで生成されたログ・ファイルの構文解析の制限汎用ログ・アダプターの実行に使用されているロケールと異なるロケールで タイム・スタンプを含むログ・ファイルを構文解析した場合、creationTime の置換規則に 時刻形式属性を使用するよう構成されているルール・ベースのアダプター・ファイルを使用したときに、 タイム・スタンプとその他のログ・レコード・データが正しく構文解析されないことがあります。 例えば、 英語版の IBM HTTP Server アクセス・ログ・ファイルを日本語のマシンで config¥IHS¥access¥v1.3.19.3¥runregex_example.bat/sh を使用して構文解析すると、 結果の共通ベース・イベントの creationTime 値はゼロの値を持ち、 共通ベース・イベントのメッセージ・フィールドがブランクになります。
この問題を回避するには、以下の JVM パラメーターを Java コマンドに追加して runregex_example.bat/sh ファイルを変更してください。
-Duser.language=2-char-language-code -Duser.region=2-char-country-code
ここで、言語コードと国別コードは、タイム・スタンプに使用される ロケールのものです。 前述の例では、JVM パラメーターは次のようになります。
-Duser.language=en -Duser.region=US1.16 静的パーサー・アダプター・ファイルを実行したときにエディター・ペインが空になる
静的パーサー・アダプター・ファイルを汎用ログ・アダプター構成エディターで実行すると、 抽出結果ペインとフォーマッター結果ペインが空になります。 この理由は、静的パーサー・アダプターに抽出およびフォーマッター・コンポーネントが 含まれていないためです。ただし、静的パーサー・アダプター・ファイルが正しく構成されていると、 センサー結果ペインにはデータが含まれます。静的パーサー・センサーの出力は、 構文解析されたログ・レコードを示す共通ベース・イベントです。センサー結果ペインには、 共通ベース・イベントがストリング・フォーマットで含まれます。「アダプターの再実行」ボタン をクリックした後にセンサー結果ペインが空の場合は、 抽出結果ペインの上部にあるツールバーの「ログの表示」ボタンをクリックして、 センサー結果ペインにセンサー出力を表示してください。
1.17 Windows XP の unzip ユーティリティーでの unzip の問題汎用ログ・アダプターを Windows XP にインストールした場合、 Windows XP 固有の unzip ユーティリティーを使用して 汎用ログ・アダプターの rules.zip ファイルを unzip するときに問題が発生します。 一部の ディレクトリーおよびファイルが unzip されません。 この問題の結果、 一部のログ・ファイル・タイプは汎用ログ・アダプターを使用して構文解析できません。この問題を 回避するには、Windows XP にインストールするときに、 WinZip や UnZip など、ほかの unzip ユーティリティーを使用してください。
メインの README ファイルに戻る