HPEL テキスト・ログ構成の設定

テキスト・ログ・ファイルへのログ・レコードおよびトレース・レコードの書き込みを使用可能にします。

これは、ログ・レコードおよびトレース・レコードをバイナリー形式で書き込むことに加えて、ロギング・システムがテキスト形式でもそれらのレコードを書き込むことを指定します。基本モード SystemOut.log ファイルが使用する形式のどちらかでテキスト・ログがフォーマットされるように構成できます。

テキスト・ログ・ファイルには、 コントローラー・プロセスによって生成されるログ項目のみが含まれ、サーバントまたは付属プロセス からのログ項目は含まれません。したがって、z/OS ではアプリケーション・ログ・レコード はテキスト・ログに書き込まれません。すべてのアプリケーション・サーバー・プロセスのログまたは トレース・データを表示するには、LogViewer コマンド行ツールまたは 管理コンソールの HPEL ログ表示ツールを使用してください。

トラブルの回避: テキスト・ログに書き込まれるすべての内容は、ログ・リポジトリーまたはトレース・リポジトリーのどちらかにも書き込まれます。テキスト・ログを使用可能にすると、ログ項目またはトレース項目を頻繁に作成するアプリケーションのパフォーマンスが低下します。gotcha

ログ・ファイルの書き込み先となるディレクトリーを指定します。

テキスト・ログ・ファイル名の形式は、TextLog_<yy.mm.dd>_<hh.mm.ss> です。 ここで、「TextLog_」は固定の接頭部、<yy.mm.dd> はファイル中の先頭レコードの日付 (年、月、日)、<hh.mm.ss> は時刻 (時、分、秒) です。

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

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

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

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

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

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

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

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

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

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

選択した内容にかかわらず、テキスト・ログ・ファイルは、テキスト・ログ・ディレクトリーに書き込まれた順にディレクトリーから削除されます。

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

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

「古いレコードのパージ」を選択すると、サーバーは実行を継続し、テキスト・ログ・ディレクトリーに書き込めなくなった場合に、最も古いログ・レコードを含むファイルが即座に削除されることを指定します。

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

テキスト・ログ・ファイルで使用するフォーマットを指定します。

レコード当たり 1 行の、短いフォーマットを指定するには、「基本」を選択します。

「詳細設定」を選択すると、完全なロガー名と各レコードの詳細情報を含む長いフォーマットを指定できます。

ログ・レコードと同様に、トレース・レコードをテキスト・ログ・ファイルに含めるかどうかを指定します

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