ディレクティブの一意のラベル。これは必須パラメータです。

Test:
  ...
Test2:
  ...
Test3:
  ...

モニターするクラスの名前。パッケージを含む完全なクラス名を指定する必要があります。

Test:  
  class_name: "com.oracle.apm.samples.servlet.OutboundTestServlet"

一致するクラスをモニターするための正規表現(regex)パターン。

正規表現パターンでは、パッケージに"."ではなく"/"を使用します。たとえば、a.b.c.d.ClassNameというクラスをモニターする場合、正規表現パターンはa/b/c/d/ClassNameに一致する必要があります。

class_name_regexとclass_nameの両方が指定されている場合、class_nameは無視されます。

Test:
  # Monitor all classes under the com.oracle.apm.test package
  class_name_regex: "com/oracle/apm/test/.*"

モニターするメソッドの名前。これにはメソッド・パラメータは含まれません。

method_nameが指定されていない場合、すべてのメソッドがモニターされます。

Test:
  class_name: "com.oracle.apm.samples.servlet.OutboundTestServlet"
  method_name "performHttpURLConnectionCall"

一致するメソッドをモニターするための正規表現パターン。

method_name_regexが指定されていない場合、すべてのメソッドがモニターされます。

method_name_regexとmethod_nameの両方が指定されている場合、method_nameは無視されます。

Test:
  class_name: "com.oracle.apm.samples.servlet.OutboundTestServlet"
  # Monitor all methods that start with "perform"
  method_name_regex: "perform.*"

モニターする注釈の完全なクラス名。指定された注釈を持つclassはすべてモニターされます。

Test:
  class_annotation: "javax.jws.WebService"

モニターする注釈の完全なクラス名。指定された注釈を持つmethodはすべてモニターされます。

Test:
  method_annotation: "javax.jws.WebMethod"

一致するクラス注釈をモニターするための正規表現パターン。

正規表現パターンでは、パッケージに"."ではなく"/"を使用します。また、値は"L"で始まり、";"で終わる必要があります。たとえば、a.b.c.d.Annotationという注釈をモニターする場合、正規表現パターンはLa/b/c/d/Annotation;に一致する必要があります。

class_annotation_regexとclass_annotationの両方が指定されている場合、class_annotationは無視されます。

Test:
  # Monitor all Path annotations in javax
  class_annotation_regex: "Ljavax/.*/Path;"
Test2:
  # Monitor all annotations that end with "Path"
  # The L in the beginning is not required since .* includes it
  class_annotation_regex: ".*/Path;"
Test3:
  # Monitor all annotations with the javax.jws package
  # The ; at the end is not required since .* includes it
  class_annotation_regex: "Ljavax/jws/.*"

一致するメソッド注釈をモニターするための正規表現パターン。

正規表現パターンでは、パッケージに"."ではなく"/"を使用します。また、値は"L"で始まり、";"で終わる必要があります。たとえば、a.b.c.d.Annotationという注釈をモニターする場合、正規表現パターンはLa/b/c/d/Annotation;に一致する必要があります。

method_annotation_regexとmethod_annotationの両方が指定されている場合、method_annotationは無視されます。

Test:
  # Monitor all Path annotations in javax
  method_annotation_regex: "Ljavax/.*/Path;"
Test2:
  # Monitor all annotations that end with "Path"
  # The L in the beginning is not required since .* includes it
  method_annotation_regex: ".*/Path;"
Test3:
  # Monitor all annotations with the javax.jws package
  # The ; at the end is not required since .* includes it
  method_annotation_regex: "Ljavax/jws/.*"

ターゲット・クラスのサブクラスをモニターする必要があるかどうかを指定します。デフォルトでは、これはfalseに設定されています。

Test:
  class_name: "com.oracle.apm.samples.servlet.OutboundTestServlet"
  method_name "performHttpURLConnectionCall"
  include_sub_classes: true

モニタリング中に作成されるスパンの名前。span_nameが指定されていない場合、デフォルトで"${class_name}.${method_name}"が使用されます。

対応する例のTestラベルの下に示されているように、スパンの名前を指定できます。モニターされるターゲットが呼び出されるたびに、これが使用されます。

span_nameパラメータを指定する場合、変数、${variable_name}および拡張変数を使用して、監視しているパラメータに関する追加情報を取得し、スパンの名前で表示することもできます。対応する例では、Test2ラベルの下のparam#変数が、モニターしているメソッドに対応するパラメータを示しています。

Test:
  ...
  # The same name will be used every time the target class/method is invoked
  span_name: "SpecialName"
Test2:
  ...
  # Use the toString result of the first parameter passed to the monitored method
  span_name: "${param1}"

スパンに含めるタグ(名前と値)。

span_nameパラメータの場合と同様に、tagsの値を指定するときに変数を使用して、モニターしているパラメータに関する追加情報を取得して表示できます。

指定したtagsは、トレース・エクスプローラ・ユーザー・インタフェースに「ディメンション」として表示されます。

タグ値の場合、オプションのタイプを指定できます。適切な構文およびキーワードを使用して、タイプString、Boolean、Integer、Long、FloatまたはDoubleのタグ値を指定できます(例を参照)。デフォルトのタグ値タイプは文字列です。タイプまたは互換性のないタイプが指定されている場合に使用されます。タグ値に互換性のない型が指定されている場合、その型はデフォルトのStringに戻され、非互換性に関するログ・メッセージが表示されます。スパン・ディメンション値は、トレース・エクスプローラで数値(該当する場合)を利用する集計を使用して問合せによって確認できます。

Test:
  ...
  tags:
    importantInfo: "${param1}"
    consistentTag: "AlwaysTheSame"
    returnValue: "${return}"
    #The below tag will have value of default type String since no type was specified
    defaultTagType: "${param1}"
    #The below tag will have value of type Integer
    integerTag: "${param1} | integer"
    #The below tag will have value of type String, because the actual value type String, and the specified type Double are incompatible. Therefore it will default to String.
    booleanTag: "${param2} | double"

スパンに含めるログ(名前と値)。

span_nameおよびtagsパラメータの場合と同様に、logsパラメータの値を指定するときに変数を使用して、モニターしているパラメータに関する追加情報を取得して表示することもできます。

指定したlogsは、トレース・エクスプローラ・ユーザー・インタフェースに「スパン・ログ」として表示されます。

Test:
  ...
  logs:
    importantInfoLog: "${param1}"
    consistentLog: "AlwaysTheSame"
    returnValueLog: "${return}"
  ...