使用 Java 注解的自定义检测
使用 Java 注释,APM Insight 提供了一种更简单的方法来自定义检测您的应用程序类和方法。Java 注释的使用使您能够为事务定义自定义名称并分配自定义组件。
此功能在代理版本 2.2 中可用。
Java 代理的配置步骤
- 作为先决条件,需要从您的 Site24x7 帐户下载apminsight-javaagent.zip 。它由代理 jar 及其关联文件和apminsight-javaagent-api.jar 组成
- 将apminsight-javaagent-api.jar文件包含到项目构建路径中,并确保该文件与应用程序的其他库一起导出。
- Java 代理 API 库提供了两个注释,可在您的应用程序中使用它们来跟踪您的自定义类和方法的性能。
- @ApmTracker:可用于任何类和方法,它们将被检测并包含在跟踪中。
- @ApmRootTracker: 只能在方法上使用,这些方法很可能是事务的入口点方法(背景)。
@ApmTracker
属性:
- component- 可选属性
为带注释的类/方法定义自定义组件。
- name- 可选属性
注释元素的自定义名称,将添加到实际方法名称之前。
方法参数可用于自定义名称,方法是使用前缀“$”提及参数索引(从 1 开始)。
可以在 Traces 下查看检测的方法及其自定义名称。
@ApmRootTracker
属性
- component- 可选属性
为带注释的方法定义自定义组件。
- name- 可选属性
注释元素的自定义名称,将添加到实际方法名称之前。
方法参数可用于自定义名称,方法是使用前缀“$”提及参数索引(从 1 开始)。
- txnName- 强制
定义后台事务的名称,仅当该方法是事务的入口点时,否则它将作为通用方法被跟踪并添加到跟踪中。
事务根据为属性txnName 指定的值命名。