帮助手册 APM APM -Java 使用 Java 注解的自定义检测

使用 Java 注解的自定义检测

使用 Java 注释,APM Insight 提供了一种更简单的方法来自定义检测您的应用程序类和方法。Java 注释的使用使您能够为事务定义自定义名称并分配自定义组件。

此功能在代理版本 2.2 中可用。

Java 代理的配置步骤

  1. 作为先决条件,需要从您的 Site24x7 帐户下载apminsight-javaagent.zip 。它由代理 jar 及其关联文件和apminsight-javaagent-api.jar 组成
  2. apminsight-javaagent-api.jar文件包含到项目构建路径中,并确保该文件与应用程序的其他库一起导出。
  3. Java 代理 API 库提供了两个注释,可在您的应用程序中使用它们来跟踪您的自定义类和方法的性能。
  • @ApmTracker:可用于任何类和方法,它们将被检测并包含在跟踪中。
  • @ApmRootTracker: 只能在方法上使用,这些方法很可能是事务的入口点方法(背景)。

@ApmTracker

属性:

  • component- 可选属性

为带注释的类/方法定义自定义组件。

  • name- 可选属性

注释元素的自定义名称,将添加到实际方法名称之前。
方法参数可用于自定义名称,方法是使用前缀“$”提及参数索引(从 1 开始)。 

Input params

可以在 Traces 下查看检测的方法及其自定义名称。

Final Output

@ApmRootTracker

属性

  • component- 可选属性

为带注释的方法定义自定义组件。

  • name- 可选属性

注释元素的自定义名称,将添加到实际方法名称之前。
方法参数可用于自定义名称,方法是使用前缀“$”提及参数索引(从 1 开始)。

  • txnName- 强制

定义后台事务的名称,仅当该方法是事务的入口点时,否则它将作为通用方法被跟踪并添加到跟踪中。

Input params

事务根据为属性txnName 指定的值命名

Final Output



帮助手册 APM APM -Java 使用Java Annotations 自定义检测