使用 ProbeBuilder 指令 › 创建自定义跟踪器 › 跟踪器语法

跟踪器语法

除用于将跟踪器关联到组或启用/禁用组的简单关键字外，PBD 文件还包含跟踪器定义。 要使 Introscope 能够识别并处理跟踪器，必须在构建自定义跟踪器时使用特定的语法。 跟踪器由指令和有关要跟踪的方法或类的信息组成，格式如下：

<directive>: [arguments]

其中，[arguments] 特定于列表和指令。 跟踪指令中使用的参数包括 <Tracer-Group>、<class>、<method>、<Tracer-name> 和 <metric-name>。

注意：根据所使用的指令，仅需要这些参数中的一部分。

<directive>

有六个主要指令可用于自定义跟踪：

• TraceOneMethodOfClass－跟踪指定类中的指定方法。
• TraceAllMethodsOfClass－跟踪指定类中的所有方法。
• TraceOneMethodIfInherits－跟踪指定类的所有直接子类或指定接口的所有直接接口实施中的一个方法。
• TraceAllMethodsIfInherits－跟踪指定类的所有直接子类或指定接口的所有直接接口实施中的所有方法。

注意：只能跟踪已实施的具体方法，只有此类方法会在运行时报告度量标准数据。 在自定义跟踪器中指定抽象的方法将导致无法报告度量标准数据。

• TraceOneMethodIfFlagged－如果指定的类包含在已使用 TurnOn 关键字启用的跟踪器组中，则跟踪一个方法。
• TraceAllMethodsIfFlagged－如果指定的类包含在已使用 TurnOn 关键字启用的跟踪器组中，则跟踪所有方法。

<Tracer-Group>

与跟踪器相关联的组。

<class>

要跟踪的完全限定类或接口名称。 完全限定类包括类的完整程序集名称以及类名称，例如：

[MyAssembly]com.mycompany.myassembly.MyClass

注意：程序集名称必须括在方括号 [] 内。

<method>

• 方法名称（例如 MyMethod）

或者

• 包含返回类型和参数的完整方法签名（例如 myMethod;[mscorlib]System.Void([mscorlib]System.Int32）。 有关方法签名的更多信息，请参阅区分签名。

<Tracer-name>

指定要使用的跟踪器类型。 例如，BlamePointTracer。 请参阅跟踪器名称了解跟踪器名称以及跟踪内容。

<metric-name>

控制所收集的数据如何在 Introscope 工作站中显示。

以下示例介绍了三种在度量标准树中的不同级别上指定度量标准名称和位置的方法。

• metric-name－度量标准直接显示在代理节点内。
• resource:metric-name－度量标准显示在代理节点下的一个资源（文件夹）内。
• resource|sub-resource|sub-sub-resource:metric-name－度量标准显示在代理节点下的多个资源（文件夹）级别中。 使用管道字符 (|) 分隔资源。