トレースおよびログ

トレースおよびログには次の内容が含まれます。

トレース

トレースとは、Java コンソールでの任意の出力をトレースファイルにリダイレクトする機能です。

Java Plug-in

トレースは、プロパティー javaplugin.trace を有効にするとオンになります。ただし、これによって Java Plug-in 内部のすべてのトレース機能がオンになります。さらに詳細なトレースを有効にする場合は、 javaplugin.trace.option を使用します。前章で示したように、Java コンソールでトレースレベルオプション (0 ～ 5) を設定できます。これらのオプションには次の意味があります。

• 0 — オフ
• 1 — 基本
• 2 — ネットワーク、キャッシュ、および基本
• 3 — セキュリティー、ネットワークおよび基本
• 4 — 拡張機能、セキュリティー、ネットワーク、および基本
• 5 — LiveConnect、拡張機能、セキュリティー、ネットワーク、temp、および基本

これで、ただちにトレースを有効にすることができます。

詳細にトレースを設定するもう 1 つの方法は、Java コントロールパネルを使用することです。たとえば、すべてのトレースを有効にする (上記のオプション 5) 場合、「Java ランタイム パラメータ」テキストフィールドに次のように入力します。

-Djavaplugin.trace=true
-Djavaplugin.trace.option=basic|net|cache|security|ext|liveconnect|temp

コントロールパネルでトレースを設定した場合、Plug-in の起動時にトレースが有効になりますが、Plug-in の実行中にコントロールパネルで変更を加えても、再起動するまでトレースは有効にはなりません。

Java Web Start

Java Web Start アプリケーションの初回のトレースレベルを設定するには、配備プロパティーに deployment.trace.level を設定します。deployment.trace.level プロパティーには、次の値のいずれかを使用できます。

• basic
• cache
• net
• security
• ext
• liveconnect

すべてのトレースレベルを使用するには、deployment.trace.level を all に設定します。

ログ機能

トレースと同様に、ログとは Java コンソールでの任意の出力を、Java Logging API を使用してログファイルにリダイレクトする機能のことです。ログ機能を有効にするには、次の作業を行います。

• Java コントロールパネルを開きます。
• 「詳細設定」 タブをクリックします。
• 「デバッグ」オプションの「ログを有効にする」を選択します。

その他のオプション

ファイル名

トレースおよびログファイル名は次のようになります。

plugin<modified version number>.trace
plugin<modified version number>.log

<modified version number> には、メジャー、マイナー、およびパッチパージョン番号が含まれます (plugin142_06.trace または plugin150.log など)。

ファイルの位置

トレースとログファイルのデフォルト位置 (ディレクトリ) を次に示します。

• <user.home>/.java/deployment/log (Unix または Linux の場合)
• <User Application Data Folder>\Sun\Java\Deployment\log (Windows の場合)

<User Application Data Folder> はここに定義されています。

環境変数 USER_JPI_PROFILE が <user plugin home> に設定されている場合、トレースおよびログファイルは次の場所に書き込まれます。

• <user plugin home>/.java/deployment/log (Unix または Linux の場合)
• <user plugin home>\Sun\Java\Deployment\log (Windows の場合)