デフォルトの設定オブジェクトを編集する

1. 「Edit Trace Configuration」ページから、「Trace Enabled」ボックスをクリックしてトレースを有効にします。

   ---

   注 –

   このボックスの選択を解除するとトレースは終了しますが、設定はそのまま残ります。トレースしていたクラスを覚えておいて入力し直さなくても、トレースの有効と無効を切り替えられます。

   ---

2. トレースするクラス、パッケージ、またはメソッド名をテーブルに入力して指定します。

   たとえば、次のようにします。

   • waveset.repository パッケージ内にあるすべてのクラスをトレースするには、com.waveset.repository と入力します。

   • waveset.repository パッケージ内にある AbstractDataStore クラスをトレースするには、com.waveset.repository.AbstractDataStore と入力します。

   • waveset パッケージ内にある AbstractDataStore クラスのリストメソッドをトレースするには、 com.waveset.repository.AbstractDataStore#list と入力します。

   com.waveset クラスにはトレースを有効に設定しないでください。com.waveset クラスは冗長で多数のクラスがあるため、このクラスをトレースするとサーバーがハングすることがあります。

3. このテーブルの「Level」メニューから、「Method」または「Class」のトレースレベルを選択します。

   次の表で説明するように、それぞれのレベルで異なる種類の情報が取り込まれます。

   トレースレベル	説明
   0	最小デバッグ出力、トレース例外、およびエラー情報のみ
   1	トレースレベル 0 イベント + Public メソッドのエントリと終了
   2	トレースレベル 1 イベント + Public 以外のメソッドのエントリと終了
   3	トレースレベル 2 + 決定点と重要変数
   4	最大デバッグ出力

   ---

   注 –

   メソッド/クラスのトレースは予測できますが、場合によってはトレース出力が大量になることがあります。トレースするメソッドとクラスを指定するときは、できる限り明確に指定するようにしてください。

   ---

4. (オプショナル) 下位呼び出しのトレースを有効にするには、「Subcall Tracing」メニューからレベルを選択します。このメニューで使用されるトレース番号のレベルは、先の表で説明したものと同じです。

   ---

   注 –

   • デフォルトの下位呼び出しトレースレベルは、なしです。これにより、メソッド単位またはクラス単位での下位呼び出しトレースが無効になります。

   • 下位呼び出しトレースレベルは、先の手順で指定したメソッド/クラスのトレースレベルとは関係ありません。

   ---

   下位呼び出しトレースをサポートしている特定のメソッドに「下位呼び出しトレース」を有効にすると、このメソッドから呼び出されるメソッドにはトレースレベルが自動的に設定されるようになります。下位呼び出しトレースを使用すると、指定メソッドへのエントリとメソッドの終了により終了したエントリを契機に、短くても詳細なトレース出力のバーストが生成できます。

   たとえば、com.waveset.adapter.NewRes#init メソッドのトレース設定を作成した場合は、メソッド/クラスのトレースをレベル 1 に設定し、下位呼び出しトレースをレベル 3 に設定します。

   さらに、init メソッドが次のもう 2 つのメソッドを呼び出すとします。

   • NewRes#subcallA

   • NewRes#subcallB

     init メソッドが実行されると、com.waveset.adapter.NewRes#init メソッドは、 subcallA に達するまで、レベル 1 でトレース出力を生成します。subcallA の実行が開始されると、トレースレベルが 3 に変わり、subcallA が終了するまでこのレベルが継続されます。com.waveset.adapter.NewRes#init メソッドが init メソッドに戻り、トレースレベルを 1 に戻します。その後、init が subcallB を呼び出すと、subcallB が存在する限り、別のバーストのトレースレベル 3 の詳細が続きます。最後に、init が存在すれば、トレースレベル 1 が終了します。

5. トレース結果を指定ファイルの場所に送信するか、stdout に送信します。

   ファイルへの出力を選択すると、「Trace File」フィールドが表示されます。このフィールドから、別の場所を指定したり、トレース出力ファイルのファイル名を指定します。デフォルトの出力場所とファイル名は、次のとおりです。

   path_to_idm_install\export\pipeline\config\WSTrace.log

6. 格納する最大トレースファイル数を指定します (デフォルトは 2)。

7. 各ファイルの最大サイズを指定します (デフォルトは 512K)。

8. トレース出力ファイルを生成時に書き込むか (同期的)、そのデータをキューに入れておいてからトレースファイルに書き込むか (非同期的) を指定します。

9. 変更を保存します。