Java 应用程序的基于上下文的监控

假设您的应用程序服务器上运行着三个 Java 应用程序。 

默认情况下，来自同一应用服务器的所有应用程序事务将在 APM Insight 的网络事务选项卡下统一显示。

在下图中，ZYLKER 是应用程序监视器名称，travel、cafe 和 tourism 是在同一应用服务器上运行的三个上下文。

这三个应用程序的事务列在网络事务选项卡中。

通过基于上下文的监控，您可以分别监控在同一应用服务器上运行的所有独立应用程序的性能，从而以更精细的粒度分析应用程序性能。

这意味着，启用基于上下文的监控后，可以分别查看 travels、tourism 和 cafe 的事务。

请继续阅读，了解以下内容： 

• 如何启用基于上下文的监控
• 如何重命名或分组上下文
• 如何禁用基于上下文的监控

如何启用基于上下文的监控

1. 登录 Site24x7。
2. 如尚未安装，请下载并安装 APM Insight Java Agent。
3. 在 apminsight.conf 文件中添加以下键： 
   • "context.monitoring.enabled=true"
4. 重启服务器。
5. 在各上下文中执行一些事务，让代理将其识别为独立的监视器。

注意： 每个上下文名称将以配置文件中提供的应用程序名称作为前缀。

示例：如果配置文件中提供的应用程序名称为 ZYLKER，各上下文名称分别为 tourism、cafe 和 travels，则各独立上下文在 APM Insight 客户端中将如下所示：

ZYLKER/Tourism

ZYLKER/Cafe

ZYLKER/Travels

如何重命名或分组上下文名称

  重命名上下文的步骤：

1. 对于 Java Agent 7.0.0 以下版本，在 Agent 安装目录中新建一个名为 context_naming_patterns.conf 的文件。对于 7.0.0 及以上版本，该文件应放置在 Agent 安装目录内名为 <appName>_<port> 的子目录中，具体对应需要启用基于上下文的监控的 APM 实例。
2. 使用 key=value 语法提供键值对，其中：
   • Key 表示精确的上下文名称或与上下文名称匹配的正则表达式。
   • Value 表示用于重命名上下文的新名称。

示例： 

1. 如需将上下文名称从 sampleapp 更改为 jpetstore，请将键值对设置为 sampleapp=jpetstore
2. 如果您有 /api/1、/api/2 等上下文，并希望将其作为单一应用程序进行监控，可通过 /api/\d+=/api 将它们分组

注意事项：

• 独立上下文不显示后台事务。由于无法确定哪个上下文触发了后台事务，后台事务在 JVM 级别捕获，数据在应用程序级别显示。
• 线程分析针对整个 JVM 进行，不区分具体上下文。无论从哪个上下文发起分析，均在整个 JVM 上执行，并推送至主 APM 应用程序（即配置文件中提供名称的应用程序）。

注意：此功能仅适用于 APM Insight Java Agent 4.4 及以上版本。 

禁用基于上下文的监控

禁用基于上下文的监控：

1. 在 apminsight.conf 文件中添加以下参数：
   • "context.monitoring.enabled=false"
2. 在 Agent 目录中，查找目录 "apminsight_monitors"，如存在则将其删除。
3. 重启应用服务器。