TPTP 汎用ログ・アダプターに関連する追加 README 情報は『TPTP V3.3 リリース情報』で入手できます。
汎用ログ・アダプターが継続してログ・ファイルをモニターしている場合、終了パターンが指定されていないと、最終レコードを処理しません。最終レコードは、 汎用ログ・アダプターがシャットダウンした場合にのみ処理されます。
モニター中に最終レコードが必ず処理されるようにするには、 汎用ログ・アダプターの構成ファイルにレコードの終了パターンを提供してください。
汎用ログ・アダプターを使用して UNIX® プラットフォーム上で WebSphere Application Server のバイナリーのアクティビティー・ログまたはサービス・ログを構文解析する場合、ユーザーは WebSphere Application Server のインストーラーと同等またはそれ以上の権限を持っている必要があります。
この制限を回避するには、ログを構文解析する前に、 バイナリーのアクティビティー・ログまたはサービス・ログを、汎用ログ・アダプターのユーザーと同じ特権を持つディレクトリーに移動してください。
汎用ログ・アダプターを使用して UNIX プラットフォーム上で WebSphere MQ エラー・ログを構文解析する場合、ユーザーは WebSphere MQ のインストーラーと同等またはそれ以上の権限を持っている必要があります。
この制限を回避するには、ログを構文解析する前に、MQ エラー・ログを 汎用ログ・アダプターのユーザーと同じ特権を持つディレクトリーに移動してください。
runregex_showlog_example.bat および runregex_showlog_example.sh を使用して WebSphere Application Server アクティビティー・ログの構文解析を試行した場合、 WebSphere Application の showlog ユーティリティーが検出されません。
この問題を回避するには、regex_showlog_example.adapter ファイルを ルール・エディターで編集して、センサー・コンバーターのプロパティーが WebSphere Application Server の 正しいディレクトリー・ロケーションを指すように更新してください。
一部のログを構文解析したときに誤ったタイム・ゾーン情報が生成されます。
時間帯情報を含むタイム・スタンプを持つログ・ファイルだけが、 正しい時間帯を持つ creationTime 値で構文解析済みデータを作成します。ログ・ファイルの タイム・スタンプに時間帯情報が含まれていない場合、汎用ログ・アダプターは 誤った時間帯情報で creationTime 値を生成します。
汎用ログ・アダプターは、名前または型のいずれの値にも一致するルールがない場合、ログ・レコードに対して無効な extendedDataElement 共通ベース・イベント・エレメントを生成します。ログ・レコードから構文解析された名前または型がない場合、 extendedDataElement は生成されませんが、汎用ログ・アダプターは 値フィールドのみを持つものを生成します。
この問題を回避するには、必ず extendedDataElement の 3 つすべてのフィールド (名前、値、型) が一致するルールを提供してください。
z/OS 上で runtime.zip および rules.zip を unzip すると、 読めないスクリプト・ファイルが作成されることがあります。
この問題を回避するには、runtime.zip および rules.zip を z/OS システムで unzip するときに、必ず以下の手順に従ってください。
unzip -a runtime.zipunzip -a rules.zipunzip -o rules.zip *.adapterunzip -o runtime.zip *.xsd
汎用ログ・アダプターは Eclipse 環境の外で実行されると、 hgla.log という名前のファイルにメッセージとエラーを記録します。スタンドアロン ・モードで実行すると、hgla.log ファイルは現行作業ディレ クトリーに作成されます。ログおよびトレース・アナライザーを 使用してリモート・ログのインポート操作の一部として実行した 場合、hgla.log ファイルは Agent Controller 構成ファイル serviceconfig.xml の SYS_TEMP_DIR 変数に指定されたように、リモート・システムの一時ディレ クトリーに配置されます。例えば、hgla.log ファイルは、 UNIX または Linux™ システムで実行したときは /tmp または /var/tmp ディレクトリーに配置され、 Windows システムで実行したときは c:¥Documents and Settings¥userid¥Local Settings¥Temp に配置されます。
Eclipse 環境で、例えばログおよびトレース・アナライザーを使 用してローカル・ログのインポート操作の一部として実行した場合、汎用ロ グ・アダプターは Eclipse ワークスペース・ディレクトリー中の .metadata¥.plugins¥org.eclipse.hyades.logging.adapter ディレクトリーの hgla.log ファイルに、メッセージおよびエ ラーを記録します。
汎用ログ・アダプターはロギング・レベル 10、20、30、 50、および 60 でイベントを記録します。hgla.log ファイルをログおよびトレース・アナライザーにインポートして、ログ・ファイルの構文解析中 に汎用ログ・アダプターが検出した問題を診断することができます。
汎用ログ・アダプターは、構文解析中のログ・ファイルのタイプがアダプター・ファイル構成に一致するかどうかを判別するための検査を行いません。 例えば、 アダプター・ファイルのセンサー構成に指定されたログ・ファイルが、パーサー構成の抽出構成および置換規則の設計対象のタイプでない場合、予期しない結果になることがあります。 構文解析はエラーなしで成功する可能性がありますが、 結果の共通ベース・イベント・データが誤りになります。 構文解析は、 誤ったデータを検出したことを示すエラー・メッセージを表示して失敗する可能性があります。
この問題を回避するには、センサー・コンポーネント構成に指定されたログ・ファイルが正しいタイプであることを確認してください。
バイナリーの WebSphere Application Server のアクティビティー・ログ・ファイルを 英語以外のマシン上で runregex_showlog_example.bat/sh を使用して構文解析すると、 ログ・レコード・データが共通ベース・イベントに正しくマップされません。 代わりに、いくつかのログ・レコード・データが共通ベース・イベントの誤ったフィールドに表示されることがあります。
汎用ログ・アダプターの実行に使用されているロケールと異なるロケールで タイム・スタンプを含むログ・ファイルを構文解析した場合、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=US
あるいは、関連したコンテキスト・インスタンス属性のタイム・スタン プ・ロケールに対して言語コードおよび国別コードを指定することにより、 ルール・ベースのアダプターを変更します。
汎用ログ・アダプターを Windows XP にインストールした場合、 Windows XP 固有の unzip ユーティリティーを使用して汎用ログ・アダプターの rules.zip ファイルを unzip するときに問題が発生します。 一部の ディレクトリーおよびファイルが unzip されません。 この問題の結果、 一部のログ・ファイル・タイプは汎用ログ・アダプターを使用して構文解析できません。この問題を回避するには、 Windows XP にインストールするときに、WinZip や UnZip など、ほかの unzip ユーティリティーを使用してください。
それぞれの静的パーサーを使用した IBM WebSphere Application Server アクティビティー・ログと IBM HTTP Server のエラー ・ログ・ファイルを継続的に構文解析すると、構文解析された出力からレコ ードの欠落が生じることがあります。特に、ログ・ファイルに新しいレコードが追加された 場合、追加されたレコードの最初のレコードは構文解析されず、構文解 析された出力に組み込まれません。 この問題は、コンテキスト・インスタンスがログの静的アダプター構成ファイル 中で continuousOperation="true" で構成される場合に生じます。この問題を回避するには continuousOperation="false" でコンテキスト・インスタンスを構成することにより一度ログ・ファイルを構文解析するか、継続的なモニターに 対してルール・ベースのアダプターを使用します。
ログ・アダプターを使用して 3 文字タイム・ゾーン記号を使用するログ・ファイ ルを CBE フォーマットに変換する場合、3 文字タイム・ゾーン記号が非固有であるとログ ・イベントの作成時刻が不正確になる場合があります。例えば、3 文字記号「IST」は、イスラエル 標準時間、インド標準時間、イラン標準時間、またはアイルランド夏時間と解釈されます。
©Copyright IBM Corporation 2000, 2005. All Rights Reserved.