Administration Console オンライン ヘルプ

  前 次 前/次ボタンと目次ボタンとの区切り線 目次  

SAF エージェントの JMS メッセージのログ ローテーションのコンフィグレーション

始める前に


SAF エージェントを作成した後には、ログ ファイルのデフォルト名を変更できると共に、古いログ メッセージを別のファイルに移動 (ローテーション) するための条件をコンフィグレーションできます。SAF エージェントのログ ファイルには、メッセージの生成、消費、および削除など、JMS メッセージが通過する基本的なイベントが含まれます。ただし、この SAF エージェントに対象指定されている JMS モジュール内のインポート済み送り先で、ロギングが有効になっている必要があります。

メッセージ ログの内容には、常にメッセージ ID と相関 ID が含まれますが、特定の送り先に関するメッセージ タイプやユーザ プロパティなどの情報もコンフィグレーションできます。

SAF エージェントのログ ファイル パラメータをコンフィグレーションするには、次の手順に従います。

  1. まだ行っていない場合、Administration Console のチェンジ センタで [ロックして編集] をクリックします (チェンジ センタの使用を参照)。
  2. Administration Console で、[サービス｜メッセージング] を展開して [ストア アンド フォワード エージェント] を選択します。
  3. [ストア アンド フォワード エージェントの概要] ページで、コンフィグレーションする SAF エージェントをクリックします。
  4. [ロギング] タブをクリックします。
  5. デフォルトのログ ファイル名を変更するには、[ログ ファイル名] フィールドで SAF エージェント ログのパスとファイル名を入力します。

    絶対パス名か、またはサーバのルート ディレクトリを基準にした相対パス名を入力します。ノード マネージャを使用して管理対象サーバを起動した場合、ルート ディレクトリはノード マネージャ プロセスをホストするコンピュータに存在します。詳細については、サーバのルート ディレクトリを参照してください。

  6. 現在のログ ファイルが指定のサイズに達したときに古いメッセージを別のログ ファイルに移動する場合は、次の手順に従います。
    1. [ローテーションの種類] リスト ボックスで、[サイズ] を選択します。
    2. [ローテーション ファイル サイズ] フィールドに、SAF エージェントがログ メッセージを別のファイルに移動するきっかけとなるファイル サイズを入力します。ログ ファイルが指定のサイズに達した後、次に SAF エージェントがファイル サイズをチェックしたときに、現在のログ ファイルの名前が変更されます。ファイル名が変更されると、以後のメッセージは filename.log という新しいファイルに蓄積されます。
    3. 古いログ メッセージを格納するために SAF エージェントが作成するログ ファイルの数を制限するには、[保存するログ ファイル数の制限] チェック ボックスを選択します。次に、[保存するファイル数] フィールドに、ファイルの最大数を入力します。最後のログ ファイルが容量制限に達した後に SAF エージェントがログ メッセージを受け取ると、JMS サーバは最も古いログ ファイルを上書きします。
  7. 古いメッセージを指定の間隔で別のログ ファイルに移動するには、次のオプションを定義します。
    1. [ローテーションの種類] リスト ボックスで、[時間] を選択します。
    2. [ローテーション開始時刻] フィールドに、開始時刻を入力します。

      hh:mm というフォーマットを使用します。hh は 24 時間形式の時間、mm は分数です。指定された時刻になると、現在のログ ファイルがローテーションされます。指定した時刻がすでに過ぎている場合、SAF エージェントは即座にファイルのローテーションを開始します。以後、[ローテーション間隔] で指定した間隔でログ ファイルがローテーションされます。

    3. [ローテーション間隔] フィールドには、SAF エージェントが古いメッセージを別のファイルに保存する間隔を入力します。
    4. 古いログ メッセージを格納するために SAF エージェントが作成するログ ファイルの数を制限するには、[保存するログ ファイル数の制限] チェック ボックスを選択します。次に、[保存するファイル数] フィールドに、ファイルの最大数を入力します。最後のログ ファイルが容量制限に達した後に SAF エージェントがログ メッセージを受け取ると、JMS サーバは最も古いログ ファイルを上書きします。

    各フィールドの詳細については、コンフィグレーション オプションを参照してください。

  8. [ログ ファイル ローテーションのディレクトリ] フィールドには、ローテーションされるログ ファイルを格納するディレクトリの場所を入力します。

    絶対パス名か、またはサーバのルート ディレクトリを基準にした相対パス名を入力します。デフォルトでは、ローテーションされたファイルはログ ファイルと同じディレクトリに格納されます。

    詳細については、サーバのルート ディレクトリを参照してください。

  9. SAF エージェントが起動サイクル中にログ ファイルをローテーションするかどうかを指定するには、[起動時にログ ファイルをローテーションする] チェック ボックスを選択します。
  10. 必要に応じて、[詳細] をクリックして [ロギングの実装] フィールドにアクセスします。このフィールドでは、SAF エージェントのロギングを、Log4j 実装ベースで行うかどうかを選択できます。デフォルトの WebLogic ロギングでは、JDK の一部である Java ロギング API をベースとした実装が使用されます。
  11. [保存] をクリックします。
  12. これらの変更をアクティブにするには、Administration Console のチェンジ センタで [変更のアクティブ化] をクリックします。
    すべての変更が即座に有効になるわけではありません。再起動が必要なものもあります (チェンジ センタの使用を参照)。

完了した後に

[ログ ファイル名]、[ログ ファイル ローテーションのディレクトリ]、または [起動時にログ ファイルをローテーションする] を変更した場合は、サーバを再起動する必要があります。

 

Skip navigation bar ページの先頭