オートノミック・コンピューティング用汎用ログ・アダプター - リリース情報

既知の問題と予備手段

  1.0 汎用ログ・アダプターを継続して実行する場合、最終レコードが処理されない
  1.1 UNIX 上で WebSphere Application Server ログを構文解析する際の制限
  1.2 UNIX 上で WebSphere MQ エラー・ログを構文解析する際の制限
  1.3 runregex_showlog_example.bat/sh を使用してログ・ファイルを構文解析する際の問題
  1.4 一部のログを構文解析したときに誤ったタイム・ゾーン情報が生成される
  1.5 無効な拡張データ・エレメントが生成される
  1.6 汎用ログ・アダプターのスクリプトが z/OS 上で読み取れない
  1.7 汎用ログ・アダプターのロギング情報と制限
  1.8 ログ・ファイル・タイプの検査が行われない
  1.9 WebSphere Application Server の activity.log ファイルの構文解析の制限
  1.10 異なるロケールで生成されたログ・ファイルの構文解析の制限
  1.11 Windows XP の unzip ユーティリティーでの unzip の問題
  1.12 それぞれの静的パーサーを使用した WebSphere Application Server activity.log ファイルと IBM HTTP Server のエラー・ログ・ファイルのモニターの制限
  1.13 非固有 3 文字タイム・ゾーン記号を使用したログ・ファイルの構文解析は、イベントに対して誤った作成時刻を戻す場合がある

TPTP 汎用ログ・アダプターに関連する追加 README 情報は『TPTP V3.3 リリース情報』で入手できます。

1.0 汎用ログ・アダプターを継続して実行する場合、最終レコードが処理されない

汎用ログ・アダプターが継続してログ・ファイルをモニターしている場合、終了パターンが指定されていないと、最終レコードを処理しません。最終レコードは、汎用ログ・アダプターがシャットダウンした場合にのみ処理されます。

モニター中に最終レコードが必ず処理されるようにするには、汎用ログ・アダプターの構成ファイルにレコードの終了パターンを提供してください。

1.1 UNIX 上で WebSphere Application Server ログを構文解析する際の制限

汎用ログ・アダプターを使用して UNIX プラットフォーム上で WebSphere Application Server のバイナリーのアクティビティー・ログまたはサービス・ログを構文解析する場合、ユーザーは WebSphere Application Server のインストーラーと同等またはそれ以上の権限を持っている必要があります。

この制限を回避するには、ログを構文解析する前に、バイナリーのアクティビティー・ログまたはサービス・ログを、汎用ログ・アダプターのユーザーと同じ特権を持つディレクトリーに移動してください。

1.2 UNIX 上で WebSphere MQ エラー・ログを構文解析する際の制限

汎用ログ・アダプターを使用して UNIX プラットフォーム上で WebSphere MQ エラー・ログを構文解析する場合、ユーザーは WebSphere MQ のインストーラーと同等またはそれ以上の権限を持っている必要があります。

この制限を回避するには、ログを構文解析する前に、MQ エラー・ログを汎用ログ・アダプターのユーザーと同じ特権を持つディレクトリーに移動してください。

1.3 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.4 一部のログを構文解析したときに誤ったタイム・ゾーン情報が生成される

一部のログを構文解析したときに誤ったタイム・ゾーン情報が生成されます。

時間帯情報を含むタイム・スタンプを持つログ・ファイルだけが、正しい時間帯を持つ creationTime 値で構文解析済みデータを作成します。ログ・ファイルのタイム・スタンプに時間帯情報が含まれていない場合、汎用ログ・アダプターは誤った時間帯情報で creationTime 値を生成します。

1.5 無効な拡張データ・エレメントが生成される

汎用ログ・アダプターは、名前または型のいずれの値にも一致するルールがない場合、ログ・レコードに対して無効な extendedDataElement 共通ベース・イベント・エレメントを生成します。ログ・レコードから構文解析された名前または型がない場合、 extendedDataElement は生成されませんが、汎用ログ・アダプターは値フィールドのみを持つものを生成します。

この問題を回避するには、必ず extendedDataElement の 3 つすべてのフィールド (名前、値、型) が一致するルールを提供してください。

1.6 汎用ログ・アダプターのスクリプトが z/OS 上で読み取れない

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

1.7 汎用ログ・アダプターのロギング情報

汎用ログ・アダプターは Eclipse 環境の外で実行されると、 hgla.log という名前のファイルにメッセージとエラーを記録します。スタンドアロン・モードで実行すると、hgla.log ファイルは現行作業ディレクトリーに作成されます。ログおよびトレース・アナライザーを使用してリモート・ログのインポート操作の一部として実行した場合、hgla.log ファイルは Agent Controller 構成ファイル serviceconfig.xmlSYS_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 ファイルをログおよびトレース・アナライザーにインポートして、ログ・ファイルの構文解析中に汎用ログ・アダプターが検出した問題を診断することができます。

1.8 ログ・ファイル・タイプの検査が行われない

汎用ログ・アダプターは、構文解析中のログ・ファイルのタイプがアダプター・ファイル構成に一致するかどうかを判別するための検査を行いません。 例えば、アダプター・ファイルのセンサー構成に指定されたログ・ファイルが、パーサー構成の抽出構成および置換規則の設計対象のタイプでない場合、予期しない結果になることがあります。 構文解析はエラーなしで成功する可能性がありますが、結果の共通ベース・イベント・データが誤りになります。 構文解析は、誤ったデータを検出したことを示すエラー・メッセージを表示して失敗する可能性があります。

この問題を回避するには、センサー・コンポーネント構成に指定されたログ・ファイルが正しいタイプであることを確認してください。

1.9 WebSphere Application Server の activity.log ファイルの構文解析の制限

バイナリーの WebSphere Application Server のアクティビティー・ログ・ファイルを英語以外のマシン上で runregex_showlog_example.bat/sh を使用して構文解析すると、ログ・レコード・データが共通ベース・イベントに正しくマップされません。  代わりに、いくつかのログ・レコード・データが共通ベース・イベントの誤ったフィールドに表示されることがあります。

1.10 異なるロケールで生成されたログ・ファイルの構文解析の制限

汎用ログ・アダプターの実行に使用されているロケールと異なるロケールでタイム・スタンプを含むログ・ファイルを構文解析した場合、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

あるいは、関連したコンテキスト・インスタンス属性のタイム・スタンプ・ロケールに対して言語コードおよび国別コードを指定することにより、ルール・ベースのアダプターを変更します。

1.11 Windows XP の unzip ユーティリティーでの unzip の問題

汎用ログ・アダプターを Windows XP にインストールした場合、 Windows XP 固有の unzip ユーティリティーを使用して汎用ログ・アダプターの rules.zip ファイルを unzip するときに問題が発生します。 一部のディレクトリーおよびファイルが unzip されません。 この問題の結果、一部のログ・ファイル・タイプは汎用ログ・アダプターを使用して構文解析できません。この問題を回避するには、 Windows XP にインストールするときに、WinZip や UnZip など、ほかの unzip ユーティリティーを使用してください。

1.12 それぞれの静的パーサーを使用した WebSphere Application Server activity.log ファイルと IBM HTTP Server のエラー・ログ・ファイルのモニターの制限

それぞれの静的パーサーを使用した IBM WebSphere Application Server アクティビティー・ログと IBM HTTP Server のエラー・ログ・ファイルを継続的に構文解析すると、構文解析された出力からレコードの欠落が生じることがあります。特に、ログ・ファイルに新しいレコードが追加された場合、追加されたレコードの最初のレコードは構文解析されず、構文解析された出力に組み込まれません。 この問題は、コンテキスト・インスタンスがログの静的アダプター構成ファイル中で continuousOperation="true" で構成される場合に生じます。この問題を回避するには continuousOperation="false" でコンテキスト・インスタンスを構成することにより一度ログ・ファイルを構文解析するか、継続的なモニターに対してルール・ベースのアダプターを使用します。

1.13 非固有 3 文字タイム・ゾーン記号を使用したログ・ファイルの構文解析は、イベントに対して誤った作成時刻を戻す場合がある

ログ・アダプターを使用して 3 文字タイム・ゾーン記号を使用するログ・ファイルを CBE フォーマットに変換する場合、3 文字タイム・ゾーン記号が非固有であるとログ・イベントの作成時刻が不正確になる場合があります。例えば、3 文字記号「IST」は、イスラエル標準時間、インド標準時間、イラン標準時間、またはアイルランド夏時間と解釈されます。

メインの README ファイルに戻る

(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved. (C) Copyright IBM Japan 2005