2.5. JMC 代理插件属性

JMC 控制台以按钮、下拉列表、文本字段等形式支持许多属性。您可以使用特定的 JMC Agent 属性来配置代理。

下表概述了可用于配置 JMC 代理的属性类别,以便您可以使用代理来监控特定于您的需要的 JFR 数据。

表 2.1. 用于 JMC 代理的配置属性列表。

属性描述

<allowconverter>

确定 JMC 代理是否可以使用转换器。启用转换器后,您可以将自定义数据类型或对象转换为 JFR 内容类型。然后,JFR 可以与自定义事件一起记录这些类型。

<allowtostring>

决定 JMC 代理是否可以将数组和对象参数作为字符串记录。

注: 检查 toString 方法支持 JMC Agent 数组元素和对象。否则,toString 方法的行为可能会导致 JMC 代理出现问题。

<classPrefix>

决定注入的事件的前缀。例如:_ _JFR_EVENT

<config>

包含 JMC 代理的配置选项。

<jfragent>

开始事件定义。& lt;jfragent > 属性是所有其他配置属性的父属性。

表 2.2. 用于 JMC 代理的事件类型属性列表。

属性描述

<class>

定义从方法接收事件类型的类。

<description>

描述事件类型。

<events>

列出代理注入定义的方法的一组事件。事件标签需要 ID。JFR 将 event 标签用于自定义事件。

<label>

定义事件类型的名称。

<location>

决定接收注入事件的方法中的位置。例如: ENTRY,EXIT,WRAP 等等。

<path>

指向存储自定义事件位置的路径。此路径与 JMC 控制台上的 JVM 浏览器 导航面板下列出的任何事件相关。

<method>

定义接收注入的事件的方法。method 属性要求您定义以下两个值:

  • 名称 :方法的名称
  • 描述符 :正式方法描述符.采用 (ParameterDescriptors) ReturnDescriptor的形式

<stacktrace>

确定事件类型是否记录堆栈追踪。

表 2.3. 与 JMC 代理一起使用的自定义 caption 属性列表。

属性描述

<converter>

将属性转换为 JFR 数据类型的转换器类的合格名称。

<contenttype>

定义 converter 属性接收的 JFR 内容类型。

<description>

自定义 caption 属性的描述。

<parameters>

可选属性。根据分配给参数标签的索引值列出方法参数。

<name>

自定义 caption 属性的名称。

表 2.4. 用于 JMC 代理的字段捕获属性列表。

属性描述

<description>

要捕获的字段的描述。

<expression>

定义一个表达式,代理分析以定位已定义的字段。

<fields>

决定 JMC Agent 使用任何定义的事件类型捕获和发出的类字段值。

<name>

class 字段捕获属性的名称。