トレーサをグループに関連付けたり、グループを有効化/無効化する単純なキーワードのほかに、PBD ファイルにはトレーサの定義が含まれています。 Introscope でトレーサを認識および処理できるようにするには、カスタム トレーサを作成するときに特定の構文を使用する必要があります。 トレーサは、ディレクティブと、追跡するメソッドまたはクラスについての情報を、以下の形式で指定して構成します。
<ディレクティブ>: [arguments]
ここで、[arguments] はディレクティブ固有のリストです。
注： 使用するディレクティブによっては、これらのパラメータのサブセットだけが必要な場合もあります。
最も一般的に使用するディレクティブは以下の追跡ディレクティブです。
指定されたクラスの指定されたメソッドを追跡します。
指定されたクラスのすべてのメソッドを追跡します。
指定されたクラスまたはインターフェースの、すべての直接サブクラス、または直接インターフェースのすべての実装で、1 つのメソッドを追跡します。
指定されたクラスまたはインターフェースの、すべての直接サブクラス、または直接インターフェースのすべての実装で、すべてのメソッドを追跡します。
指定されたクラスが、TurnOn キーワードによって有効化されたトレーサ グループに含まれている場合、1 つのメソッドを追跡します。
指定されたクラスが、TurnOn キーワードによって有効化されたトレーサ グループに含まれている場合、すべてのメソッドを追跡します。
注： 具象メソッドが実装された場合のみ、追跡対象となり、実行中にメトリック データをレポートできます。 カスタム トレーサで抽象メソッドを指定しても、メトリック データはレポートされません。
トレース ディレクティブ用の構文は通常、以下の引数から構成されます。
トレーサが関連付けられているグループ。
追跡するクラスまたはインターフェースの完全修飾名。 クラスの完全修飾名には、名前だけでなくクラスの完全なアセンブリ名が含まれます。たとえば、以下のようになります。
[MyAssembly]com.mycompany.myassembly.MyClass
アセンブリ名は [] かっこで囲む必要があります。
メソッド名（MyMethod など）
または
戻り値の型およびパラメータが指定された完全なメソッド シグネチャ（たとえば、myMethod;[mscorlib]System.Void([mscorlib]
System.Int32)。 メソッド シグネチャの詳細については、「シグネチャの区別」を参照してください）。
使用するトレーサのタイプを指定します。 たとえば、BlamePointTracer となります。 トレーサ名の説明については、以下のトレーサ名の表を参照してください。
収集されたデータを Introscope Workstation に表示する方法を制御します。
以下の例は、メトリック ツリーのさまざまなレベルにあるメトリックの名前および場所を指定する 3 つの方法を示します。
metric-name - メトリックは エージェント ノードのすぐ内側に表示されます。
resource:metric-name - メトリックは、エージェント ノード の下の 1 つのリソース（フォルダ） 内に表示されます。
resource|sub-resource|sub-sub-resource:metric-name - メトリックは、エージェント ノード の 1 レベル下よりも深いリソース（フォルダ）に表示されます。 リソースを区切るには、パイプ文字（|）を使用します。
|
Copyright © 2013 CA.
All rights reserved.
|
|