安装、配置和使用 EPAgent › 创建自定义插件并在 EPAgent 中使用 › EPAgent 事件和事务跟踪

EPAgent 事件和事务跟踪

您可以选择“跟踪视图”选项卡，在事件查看器中将 EPAgent 事件作为事务跟踪来查看。

当 EPAgent 发送的事件中包含时间信息时，跟踪视图会比较容易理解。 要包含时间信息，请在 <event> 和 <calledComponent> 标记上使用 startTime 和 offset 属性。

startTime 属性是绝对时间。 其格式是 java.util.Date.parse() 可以解析的任何格式。 不需要在 <event> 元素中指定 startTime－如果没有该属性，那么根据 Java 方法 System.currentTimeMillis() 或 new Date() .getTime() 的指定，起始时间默认为当前时间值。 如果在 <calledComponent> 元素中忽略 startTime ，时间会默认为包含元素的时间。因此，如果没有在任何位置指定 startTime 属性，所有起始时间都将默认为当前时间。

offset 属性是整数值。 它解释为以毫秒为单位的时间，可添加至 startTime 属性（无论 startTime 是默认时间还是显式指定的时间）以生成 <event> 或 <calledComponent> 的实际报告时间。

示例 1

<event resource="自定义 Web 服务器" startTime="123456789" duration="500">
<calledComponent resource="Web 服务器模块" offset="300" duration="100"/>
</event>

该事件跟踪视图的“自定义 Web 服务器”从 1234567879 开始，“Web 服务器模块”从 123457089 (123456789 + 300) 开始。 在各元素中指定持续时间将生成有用的跟踪视图，其中显示：

• “自定义 Web 服务器”运行 300 毫秒
• “Web 服务器模块”由“自定义 Web 服务器”调用并运行 100 毫秒
• “自定义 Web 服务器”在“Web 服务器模块”返回后又运行 100 毫秒

示例 2

<event resource="自定义 Web 服务器" duration="500">
<calledComponent resource="Web 服务器模块" offset="300" duration="100"/>
</event>

本示例与示例 1 类似，除了“自定义 Web 服务器”从当前时间开始，“Web 服务器模块”从 300 毫秒后开始。 请注意为何本示例中没有任何部分需要 EPAgent 脚本来获知当前时间。

示例 3

<event resource="自定义 Web 服务器" startTime="123000000" offset="1000" duration="5000">
<calledComponent resource="Web 服务器模块" startTime="123003000" duration="200"/>
</event>

这里的“自定义 Web 服务器”从 123001000 (123000000 +1000) 开始，“Web 服务器模块”从 123003000 开始。

请再次注意如何指定持续时间可提升可读性和可用性。 错误指定“起始时间”、“偏移量”和“持续时间”会使跟踪视图难以读取，因此在使用时务必小心。 特别是开始时间（通过添加 <calledComponent> 元素的 startTime 和 offset 来计算）应该始终在其包含的 <event> 或 <calledComponent> 的起始时间之后，并且 <calledComponent> 的（开始时间 + 持续时间）应该总在其包含的 <event> 或 <calledComponent> 的（开始时间 + 持续时间）之前。