1.0 ログおよびトレース・アナライザー
1.1 ビュー
1.2 ログのインポート
1.2.1 リモート・ログ・ファイルをインポートする際の問題
1.2.2 Linux および AIX でのログ・ファイルのインポート
1.2.3 WebSphere Application Server の trace.log のインポート
1.2.4 一部のログ・ファイルが IBM Agent Controller V5 を使用してインポートできない
1.2.5 メモリー不足例外
1.2.6 Linux GTK ドライバーで、ログ・ファイルのインポート・ウィザードを使用してログ・ファイルを追加しているときに、索引の境界外エラーが発生する
1.2.7 DB2® Diagnostic ログ用に表示された共通ベース・イベントが仕様と合っていない
1.2.8 ログ・ファイルのインポートでのエラーが表示されない
1.2.9 WebSphere の activity.log ファイルのインポートの制限
1.2.10 異なるロケールで生成されたログ・ファイルのインポートの制限
1.2.11 InvocationTargetException メッセージを表示してインポートが失敗する
1.2.12 空のログをインポートした場合の NullPointerException
1.3 データベース・サポート
1.4 その他
1.4.1 Linux GTK ドライバーで、新規ログ相関ウィザードが正しく表示されない
1.4.2 ワークベンチを最初に始動した後、プラグインのロギング・レベルへの変更が有効にならない
1.4.3 Windows XP の unzip ユーティリティーでの unzip の問題
1.4.4 IBM JVM を搭載した Red Hat Linux v8.0 でのサンプル作成時の破損
1.4.5 ロギング・ユーティリティー XML ログ・ファイルを表示するためのブラウザー制限事項
1.4.6 TPTP フォーマット症状データベースしかログ・ナビゲーター・ツールバーおよびポップアップ・メニューから作成できない
2.0 プロファイル作成ツール
2.1 エージェントおよびプロセス相互作用ビューがシーケンス図ビューからサポートされない
2.2 プロファイル・ナビゲーターのビューの更新コマンドが相互作用トレースで機能しない
2.3 Sun JDK 1.4.x を使用した Windows でのプロファイル作成は Microsoft® エラー・レポートで終了する場合がある
TPTP ログおよびトレース・アナライザーと関連する追加 README 情報は、『TPTP V3.3 リリー ス情報』で入手できます。
リモート・ログ・ファイルをインポートすると (「ファイル」>「インポート...」>「ログ・ファイル」)、プロファイル・モニターのビューを更新 (「プロファイル」>「ビューの更新」)した後、ログ・ビューにログ・エントリーが表示されないか、あるいは 30 秒待機した後、ローカル・クライアントがリモート・ログ・パーサーのモニターを開始していないことを 伝える「ロギング・メッセージ」ダイアログが表示されます。
この問題はネットワークの待ち時間が原因であり、 Agent Controller がローカル・クライアントによるリモート・ログ・パーサーのモニター 開始を待機する時間を増やすことによって修正できます。この問題を回避するには、以下のステップ を試行してください。
<Application configuration="default" executable="RemoteLogParserLoader" extends="default" location="%SYS_TEMP_DIR%" path="%JAVA_PATH%"> ... <Parameter position="prepend"value="-Dorg.eclipse.hyades.logging.parsers.maxWaitTimeInMillis=xxxxx"/> ... </Application>ここで、xxxxx は最大待ち時間 (ミリ秒単位) です (30000 より大)。
Linux および AIX® プラットフォーム上で一部のログ・ファイルのインポートがまったく機能しません。
これは、ユーザーがログ・ファイルにアクセスするための適切な許可を 持っていない場合に発生します。この問題を解決するには、ログ・ファイルを ユーザーのホーム・ディレクトリーにコピーし、そこからインポートしてください。
1.2.3 WebSphere Application Server の trace.log のインポートWebSphere Application Server の trace.log ファイルをインポートすると、内部相関が作成されます。
これらの相関には対応するエージェントの内部構造に関連した情報が含まれているため、 ユーザーはこれらの相関を削除しないでください。
1.2.4 一部のログ・ファイルが IBM Agent Controller V5 を使用してインポートできないactivity.log 以外のリモート・ログ・ファイルは、V5 IBM Agent Controller を 使用してインポートできません。ログ・ファイルをリモート側でインポートする場合、リモート・マシン上の Agent Controller はオートノミック・コンピューティングの ログおよびトレース・アナライザーと同一あるいはそれ以上のレベルでなければなりません。
この制限を回避するには、リモート・マシン上にログおよびトレース・アナライザー と共に出荷された IBM Agent Controller をインストールしてください。
1.2.5 メモリー不足例外25MB までのログ・ファイルはワークスペースにインポートして、 ログおよびトレース・アナライザーで開くことができます。ログ・ファイルを 開く時間はファイル内のログ・レコードの数によって決まるため、「メモリー不足」例外を受け取ることがあります。
この問題を回避するには、大規模ログ・サポート・フィーチャーを使用 してください。
1.2.6 Linux GTK ドライバーで、ログ・ファイルのインポート・ウィザードを使用してログ・ファイルを追加しているときに、索引の境界外エラーが発生するログ・ファイルのインポート中、ログ・ファイルの追加ウィザードで 「 OK」をクリックしようとすると、「索引の境界外 エラー (Index out of bounds error) 」が表示されます。これは追加中のログ・ファイルでバージョンが 選択されていないことが原因です。
ログ・ファイルの追加ウィザードの「詳細」タブの「バージョン」 プルダウン・リストで有効なバージョン・オプションが選択されていることを確認してください。
DB2 診断ログをインポートする場合、ログおよびトレース・アナライザ ーに表示される共通ベース・イベントは、一部の共通ベース・イ ベント仕様に従いません。これは、DB2 診断ログを共通ベース・イベントに変換するた めに使用する db2diag.exe ユーティリティー中のバグが原因です。これは操作に影響しません。db2diag.exe が修 正されるまで既知の次善策はありません。
インポートされるログ・ファイルについて、ログおよびトレース・アナライザー による検査は行われません。ログ・ファイル をインポートする際に、インポートするログ・ファイルに対して正しいログ・タイプとバージョンが選択されていることを確認してください。インポート中に問題が生じた場合、ログ・ビューには、レコードが表示されないか、または誤ったレコードが表示され、またエラー・メッ セージが表示されます。エラーに関する詳細情報については、エラー・ダイアログの詳 細を参照するか、ファイル .metadata¥.plugins¥org.eclipse.hyades.logging.adapter¥hgla.log が workspace ディレクトリーにある場合は、そのファイルを調べてください。このファイルには、ログ・ファイルの構文解析中に生じたエラー に関する情報が含まれている場合があります。
ログ・ファイルのインポートでエラーが発生した場合、エラー・メッセー ジが表示され、ログ・ビューにレコードが表示されないか、または誤ったデータがログ・ビューのレコードに表示されます。
WebSphere Application Server のアクティビティー・ログ・ファイルを 英語以外のマシンから、あるいは英語以外のマシン上でインポートすると、 ルール・ベースのログ・ファイル・パーサーが正常にログ・レコード・データを 共通ベース・イベントにマップしません。代わりに、いくつかのログ・レコード・データが 共通ベース・イベントの誤ったフィールドに表示されることがあります。
この問題を回避するには、WebSphere Application Server のアクティビティー・ログ・ファイルを 英語以外のマシンからインポートするとき、あるいは英語以外のマシン上でインポートするときに、 静的ログ・ファイル・パーサーを使用してください。
ログおよびトレース・アナライザーの実行に使用されているロケールと異なる ロケールのタイム・スタンプが含まれたログ・ファイルをインポートすると、 ルール・ベースのログ・ファイル・パーサーがタイム・スタンプとその他のログ・レコード・データを正しく構文解析しないことがあります。例えば、英語の IBM HTTP Server のアクセス・ログ・ファイルを日本語マシンで実行されているログおよびト レース・アナライザーにインポートすると、結果の共通ベース・イベントの creationTime 値がゼロの値を持ち、共通ベース・イベントのメッセージ・フ ィールドがブランクになります。
この問題を回避するためには、現行マシンのロケールと異なるタイム・スタンプが含まれたログ・ファイルをインポートするときに、静的ログ・ファイル・パーサーがあればそれを使用してください。
ログおよびトレース・アナライザーが正しくインストールされておらず、そのファイルの一部が欠落している場合は、ログ・ファイルをインポートすると、 失敗して、以下のロギング・メッセージが表示されることがあります。
java.lang.reflect.InvocationTargetException
この問題を回避するには、ログおよびトレース・アナライザーを再インストールしてください。注: Windows XP にインストールするときには、Windows XP 固有の unzip ユーティリティーを使用しないでください。 詳しくは、下記の『Windows XP の unzip ユーティリテ ィーでの unzip の問題』を参照してください。
空のログをインポートするか、すべてのログ・イベントを除外するようなインポート・フィルターを使用すると、ログ・ビューの表示が空になり、NullPointerException (XMLLoader.endElement 中) がスローされることがあります。ログ・ファイルを確認するか、いくつかのイベントの読み込みを許可する別のフィルターを試してください。
N/A
新規ログ相関ウィザードで、使用可能なログのリストだけが表示され、 そのリストが空です。これはウィザード・ページの左方の部分しか表示されていないことが原因です。
この問題を回避するには、選択済みログのリストとアクション・ボタンが表示されるように、 ウィザード・ページのサイズ変更を試行してください。代替の予備手段としては、 「新規ログ相関」ボタンをクリックする前に、ログ・ナビゲーター・ビューで相関の ためのログ・ファイルを選択することができます。
1.4.2 ワークベンチを最初に始動した後、プラグインのロギング・レベルへの変更が有効にならない
ワークベンチを初めて始動した後、(com.ibm.etools.common.logging.commonLoggingOptions または com.ibm.etools.logging.util.loggingOptions 拡張ポイントから) plugin.xml ファイルで プラグインのロギング・レベルを変更した場合、それ以降のワークベンチの起動でその変更は有効になっていません。プラグインの plugin.xml ファイルに指定されたロギング・レベルは、ワークベンチの第 1 回目の始動時に Eclipse ランタイムによって キャッシュされます。後続のワークベンチの始動では、plugin.xml ファイルの変更に関係なく、プラグインのロギング・レベルのキャッシュされた値を使用します。
この問題を回避するには、-clean コマンド行引数を使用してワークベンチを再始動してください。このオプションが、バンドル依存関係解決と Eclipse 拡張レジストリー・データを保管するために使用するキャッシュをクリーンにし、これらのキャッシュを再初期化するよう Eclipse に強制します。<ワークベンチ・インストール・ディレクトリー>¥eclipse¥ac.bat (Windows) ま たは <ワークベンチ・インストール・ディレクトリー>/eclipse/ac.sh (Linux) の eclipse.exe の後にオプションを追加します。あるいは、「ロギング設定」ページ (「ウィンドウ」>「設 定」>「ロギング」) でプラグインのロギング・レベルを変更してから、ワークベンチを再始動することもできます。
Windows XP にログおよびトレース・アナライザーをインストールする場合、 Windows XP 固有の unzip ユーティリティーを使用したログおよび トレース・アナライザーのランタイム・ファイルの unzip で問題があります。一部のディレクトリーおよびファイルが unzip されません。 この問題のため、ログおよびトレース・アナライザーを使用して一部のログ・ファイル・タイプをインポートできません。
この問題を回避するには、Windows XP にインストールするときに、WinZip や UnZip など、ほかの unzip ユーティリティーを使用してください。
サンプル作成ウィザード (「新規」>「サンプル」) を使用してログおよびトレース・アナライザーでサンプルを作成すると、ワークベンチが破損します。これは、サンプル作成ウィザードが作成ステップの一部として readme.html ファイル を開こうとしたときに発生します。この問題は、IBM JVM を搭載した Red Hat Linux v8.0 で 検出される、SWT のバグ ( https://bugs.eclipse.org/bugs/show_bug.cgi?id=76515) です。
この問題を回避するには、-Xj9 を JVM 引数として ac.sh に追加して、IBM J9 JVM を使用して起動してください (例えば、./eclipse -vmargs -Xj9 -Xmx500m)。Red Hat Linux v8.0 上で稼働する SWT について詳しくは、『SWT FAQ (http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/platform-swt-home/faq.html) 』を参照してください。
注:『Eclipse 参照プラットフォーム・テーブル (http://www.eclipse.org/eclipse/development/eclipse_project_plan_3_0.html#TargetOperatingEnvironments)』 に記載されているように、次の Linux システムだけがサポートされます: GTK+ ウィジェット・ツールキット のバージョン 2.2.1 および関連ライブラリー (GLib、Pango); SWT HTML ビューアーには Mozilla 1.4GTK2 が必要です。他の Linux システム上の Motif: Open Motif 2.1 (組み込み済み)、SWT HTML ビューアーには Mozilla 1.4GTK2 が必要です。
ワークベンチにより生成された CommonBaseEvents.log ファイルは、ロギング・ツ ールで提供されるログ・ビューの使用で最適に表示されます。あるいは、XML 使用可能化ブラウザ ーを使用してログ・ファイル (すなわち、インストール・ディレクトリーの workspace¥.metadata サブディレ クトリーの CommonBaseEvents.log_Viewer.xml ファイル) の XML 文書フォーマットを表示できます。このファイルは、Microsoft Internet Explorer V6.0.28 以 降を使用しなければ表示できません。
TPTP の制限事項により、ユーザーはログ・ナビゲーター・ツールバー・ボタンおよびコンテキスト・メニューから両方のタイプの症状データベースを作成することはできません。 これを回避するには、ワークベンチ・メニューから「ファイル」>「 新規 」>「 その他」>「プロファイルおよびロギング 」と選択し、作成する症状データベースのタイプを選びます。
エージェント相互作用ビューとプロセス相互作用ビューは、 ログ・ファイルのシーケンス図ビューからサポートされません。
現在のところ、この問題の予備手段はありません。
2.2 プロファイル・ナビゲーターのビューの更新コマンドが相互作用トレースで機能しないプロファイル・ナビゲーターのビューの更新コマンドは、 相互作用トレースには機能しません。しかし、トレース相互作用は、定期的に自身で自動的に 更新を行っています。
この予備手段としては、プロファイル・ツリーで別のノードを選択し、 再び前のノードを選択してください。
2.3 Sun JDK 1.4.x を使用した Windows でのプロファイル作成は Microsoft エラー・レポートで終了する場合があるBugzilla 障害: 103058
プロファイル作成またはアプリケーションは、次のメッセージ「java.exe has encountered a problem and needs to close. We are sorry for the inconvenience. (問題が発生したため java.exe を終了します。ご不便をおかけして申し訳ありません。)」 を表示して終了します。メッセージには、情報と Microsoft へのエラー・レポートを送信するための選択項目が含まれています。メッセージの画面捕そくについては bugzilla 103058 を参照してください。
この問題は、時間分析 (「表示インスタンス」あり、またはなし)、メモリー分析、およびこれらのモードの組み合わせなど、多くのモードで見られます。JIT をオフにして、プロファイル作成またはアプリケーションを再実 行することで問題を回避することができます (JVM 引数として「-Djava.compiler=NONE」とする)。この問題は、Windows 用に構築された SUN JDK 1.4.2_08-b03 で発生しています。
©Copyright IBM Corporation 2000, 2005. All Rights Reserved.