上一主题: 将自定义 BlamePointTracer 跟踪器用于常用度量标准下一主题: 常用的跟踪器名称和示例


跟踪器语法中使用的指令名称和参数

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

<directive>: [arguments]

其中,[arguments] 是一个列表,且特定于指令。

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

<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 Workstation 中显示。

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

metric-name-度量标准直接显示在代理节点内。

resource:metric-name-度量标准显示在代理节点下的一个资源(文件夹)内。

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