診断トレース・サービス設定

トレース出力の書き込み先を指定します。トレース出力は、出力ファイルに直接書き込むか、またはメモリーに保管し、 ランタイム・ページにある「ダンプ」ボタンを使用して、要求に応じてファイルに書き込むことができます。

異なるコンポーネントが、エントリーごとに異なる量のトレース出力を作成することがあります。例えば、ネーミングおよびセキュリティー・トレースは、Web コンテナー・トレースよりもはるかに多くのトレース出力を作成します。メモリー割り振りおよび出力設定を構成する場合、収集されるデータのタイプを考慮してください。

なし

このオプションを選択すると、トレース・データはどこにも記録されません。他のすべてのハンドラー (アプリケーションが登録したハンドラーを含む) は、 これまでと同様にこれらのトレースを処理することができます。

メモリー・バッファー

トレース出力をメモリー内の循環バッファーに書き込むように指定します。 このオプションを選択した場合は、以下のパラメーターを指定しなければなりません。

最大バッファー・サイズ

バッファー内のキャッシュに入れられるエントリー数を千単位で指定します。 この数値を超過すると、より古いエントリーは、新しいエントリーで上書きされます。

ファイル

自己管理ログ・ファイルにトレース出力を書き込むように指定します。自己管理ログ・ファイルは、 指定した最大ファイル・サイズに達するまで、ファイルにメッセージを書き込みます。 ファイルが指定したサイズに達すると、ロギングは一時的に中断され、ログ・ファイルがクローズされて、 名前が変更されます。 新しい名前は、そのファイルのオリジナル名が基になり、 それに名前変更の発生した時間を示すタイム・スタンプ修飾子が付きます。 名前変更が完了すると、オリジナル名を持った新規の空のログ・ファイルが再度開かれ、ロギングが再開します。 ロールオーバーの結果、単一メッセージが 2 つのファイルに分割されるような場合はあっても、なくなることはありません。このオプションを選択した場合は、以下のパラメーターを指定しなければなりません。

最大ファイル・サイズ

出力ファイルを拡大できる最大サイズを MB 単位で指定します。 この属性が有効なのは、「File Size」属性が選択されている場合だけです。 ファイルは、このサイズに達すると、前述したようにロールオーバーされます。

ヒストリー・ファイルの最大数

保持するロールオーバー・ファイルの最大数を指定します。

ファイル名

トレース出力を書き込むファイルの名前を指定します。

トラブルの回避: このファイルはサーバー間で共有できません。 2 つ以上のサーバーが同じファイルを使用しようとした場合に検出できるよう、サーバーは .owner 拡張子 を付けたファイルを作成します。gotcha

トレース出力の形式を指定します。

ランタイム変更を構成に保存 (Save runtime changes to configuration)

ランタイム・タブ上で行われたランタイムの変更を、トレース構成にも保存します。 このボックスを選択すると、ランタイム・トレースの変更をトレース構成設定にもコピーします。 これらの変更をトレース構成に保存すると、アプリケーションが再始動されても、変更は存続します。

トレース出力の書き込み先を指定します。トレース出力は、出力ファイルに直接書き込むか、またはメモリーに保管し、 ランタイム・ページにある「ダンプ」ボタンを使用して、要求に応じてファイルに書き込むことができます。

なし

このオプションを選択すると、トレース・データはどこにも記録されません。他のすべてのハンドラー (アプリケーションが登録したハンドラーを含む) は、 これまでと同様にこれらのトレースを処理することができます。

メモリー・バッファー

トレース出力をメモリー内の循環バッファーに書き込むように指定します。 このオプションを選択した場合は、以下のパラメーターを指定しなければなりません。

最大バッファー・サイズ

バッファー内のキャッシュに入れられるエントリー数を千単位で指定します。 この数値を超過すると、より古いエントリーは、新しいエントリーで上書きされます。

ダンプ・ファイル名

メモリー・バッファーがダンプされた場合に書き込まれるファイルの名前。 このオプションは、ランタイム・タブからのみ使用可能です。

ファイル

自己管理ログ・ファイルにトレース出力を書き込むように指定します。自己管理ログ・ファイルは、 指定した最大ファイル・サイズに達するまで、ファイルにメッセージを書き込みます。 ファイルが指定したサイズに達すると、ロギングは一時的に中断され、ログ・ファイルがクローズされて、 名前が変更されます。 新しい名前は、そのファイルのオリジナル名が基になり、 それに名前変更の発生した時間を示すタイム・スタンプ修飾子が付きます。 名前変更が完了すると、オリジナル名を持った新規の空のログ・ファイルが再度開かれ、ロギングが再開します。 ロールオーバーの結果、単一メッセージが 2 つのファイルに分割されるような場合はあっても、なくなることはありません。このオプションを選択した場合は、以下のパラメーターを指定しなければなりません。

最大ファイル・サイズ

出力ファイルを拡大できる最大サイズを MB 単位で指定します。 この属性が有効なのは、「File Size」属性が選択されている場合だけです。 ファイルは、このサイズに達すると、前述したようにロールオーバーされます。

ヒストリー・ファイルの最大数

保持するロールオーバー・ファイルの最大数を指定します。

ファイル名

トレース出力を書き込むファイルの名前を指定します。

表示

「ファイル名」パラメーターで指定されたファイルを表示します。これは、ご使用の構成には適用されません。

トラブルの回避: 複数の管理対象サーバーに同じファイル名を指定しないでください。 サーバーは、出力に特定のファイル名を使用できるサーバーを追跡するために、拡張子が .owner のファイルを作成します。gotcha