HPEL トレース構成の設定

このページを使用して、High Performance Extensible Logging (HPEL) トレース設定を構成します。

サポートされる構成 サポートされる構成: このページには、サーバーが HPEL ログおよびトレース・モードを使用するよう構成されている場合のみアクセスできます。sptcfg

この管理コンソール・ページを表示するには、「トラブルシューティング」 >「ログおよびトレース」> 「server_name」 >「HPEL トレースの構成」とクリックします。

ディレクトリーへのトレース

トレース・レコードがサーバーによって作成されたら、トレース・システムがそれらのトレース・レコードをトレース・ディレクトリーに書き込むことを指定します。

ログ・レコードのバッファリングを使用可能にする

トレース・レコードが作成されるたびにトレース・システムがそのレコードをディスクに書き込まないことを指定します。トレース・システムは、多数のトレース・レコードを保持できるバッファーを作成し、そのバッファーが満杯になったらバッファー中のイベントを書き出します。さらに、バッファーがいっぱいになっていない場合でも、トレース・システムは数秒経過したら、バッファーされたイベントを書き込みます。

この設定を選択すると、トレースのパフォーマンスが大幅に向上します。ただし、予期しないサーバー停止があると、内容がトレース・リポジトリーに書き込まれない可能性があります。

ベスト・プラクティス ベスト・プラクティス: ほとんどすべてのケースで、トレース・レコードのバッファリングを使用可能にしてください。トレース・レコードのバッファリングを使用不可にするのは、サーバーで予期しない障害が発生していて、バッファーに入れられた内容を停止前にサーバーがディスクに書き込めない場合のみにしてください。bprac

毎日 <time> 時に新規ログ・ファイルを開始する

指定された時刻にトレース・フレームワークがトレース・ファイルをクローズし、新しいファイルを開始することを指定します。ファイルをクローズすることによって、そのファイルをアーカイブにコピーすることが簡単になります。

ベスト・プラクティス ベスト・プラクティス: トレース・ファイルが自動的に アーカイブに保存されるようにする場合、新規ファイルが開始するように構成した時刻より後にファイルをコピーするようにバックアップ・プログラムをセットアップしてください。新規ファイルが開始するよう構成した時間から最低 10 分後にバックアップが実行されるように構成します。これによって、サーバーが前のファイルを確実に閉じることができます。bprac

最も古いレコードのクリーンアップを開始する

トレース・クリーンアップ設定が使用されて、最も古いトレース・レコード、または、構成されたスペースに収まらなくなったトレース・レコードがトレース・リポジトリーから自動的に消去されることを指定します。

「ログ・サイズが最大に達した場合」を選択すると、トレース・リポジトリーの合計サイズが構成された最大サイズに達したときに、自動トレース・ファイル・クリーンアップが始まるように構成できます。

「最も古いレコードが存続期間制限に達した場合」を選択すると、トレース・コンテンツが指定した存続期間制限に達したときに、自動トレース・ファイル・クリーンアップが開始するよう構成できます。

「存続期間またはサイズの制限が満たされた場合」を選択すると、前述の条件のいずれかが満たされたときに、自動トレース・ファイル・クリーンアップが始まるように構成できます。

どれを選択するのかに関わらず、レコードはトレース・リポジトリーに書き込まれた順序でトレース・リポジトリーから 削除されます。

ログ・レコード存続期間限度

トレース・レコードがトレース・リポジトリー内に存在可能な存続期間を時間数で指定します。これを過ぎると、トレース・レコードは自動的にサーバーによって削除 できるようになります。トレース・リポジトリーの最も古いレコードが、指定された存続期間制限を超えて維持された場合、これらのレコードはサーバーによる削除の対象になります。

最大ログ・サイズ

サーバーがトレース・リポジトリーに許容する全体サイズの最大値を、メガバイトで指定します。トレース・リポジトリーがこのサイズ制限に達すると、サーバーは最も古いレコードをトレース・リポジトリーから削除し、新規トレース・レコードのためのスペースを作ります。

スペース不足時のアクション

トレース・リポジトリーへ内容を追加できなくなった場合に サーバーがどのような処置を実行するのかを指定します。

「サーバーの停止」を選択すると、トレース・リポジトリーへの書き込みができなくなった場合にサーバーを停止するよう指定します。

「古いレコードのパージ」を選択すると、サーバーは実行を継続し、トレース・リポジトリーに書き込めなくなった場合に、最も古いトレース・レコードが即座に削除されることを指定します。

「ロギングの停止」を選択すると、サーバーは実行を継続しますが、トレース・リポジトリーに書き込みできなくなった場合、トレースへの書き込みは継続されないことを指定でします。

トレースをメモリー・バッファーに書き込む

トレース・システムがトレース・レコードをメモリー・バッファーに書き込むことを指定します。

ランタイム・タブから、メモリー・バッファーの内容をトレース・ディレクトリーに書き込むことができます。

メモリー・バッファー・サイズ

トレース・レコードを収容するためにサーバー内でトレース・システムが割り振るメモリーの量を指定します。

新しいトレース・レコードが作成されたときにメモリー・バッファーが満杯の場合、スペースを作るために最も古いエントリーが削除されます。

「ダンプ」ボタン

トレース・メモリー・バッファーの内容をトレース・ディレクトリーに書き込むには、このボタンを使用します。

ダンプ後、トレース・システムはメモリー・バッファーをリセットします。 メモリー・バッファーのダンプ後、トレース・システムはメモリー・バッファーへのトレース・レコードの書き込みを続けます。

トレースおよびメモリー・バッファーのダンプに使用するディレクトリー

トレース・ファイルの書き込み先となるディレクトリーを指定します。サブディレクトリー (トレース・データ) がこのディレクトリー内に作成され、 そこにトレース・ファイルが書き込まれます。

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

ランタイム変更も構成に保存する

稼働中のサーバーの動的状態とサーバー構成の両方に変更が加えられることを指定します (サーバー構成への変更は次に再始動したときに有効になります)。このチェック・ボックスを選択しないと、サーバーは設定をサーバー構成にコピーしません。



ファイル名: utrb_confHPELTrace.html