上一主题: 禁用 HTTP 分析程序插件下一主题: 监控多字节事务


HTTP 分析程序插件 SDK 故障排除

如果尚未在 CEM 控制台和 TIM 中验证 HTTP 分析程序插件,请参阅验证 HTTP 分析程序插件。

此表提供了一些症状和解决方案,可帮助您排除 HTTP 分析程序插件的故障。

事件和日志

症状:

系统事件显示在“系统”>“事件日志”中:HTTP 分析程序插件错误

您还可能会收到含有此系统事件消息的电子邮件。

解决方案:

这是由于插件中未捕获的程序异常引起的。 它还会在 TIM(不一定是所有 TIM)上禁用插件,而在 CEM 控制台中显示为已启用。

请参阅 TIM 日志堆栈跟踪以找出未捕获的异常的发生位置。

调试代码并进行更正。

请参阅禁用 HTTP 分析程序插件

请参阅部署 HTTP 分析程序插件的清单

症状:

系统事件 appSystem 事件显示在“系统”>“事件”日志中:

企业管理器无法访问 TIM

…,并显示如下说明:

Error retrieving http://<ip_address>/wily/cem/tim/tess/loadplugin?id=600000000000000020: Read time

您还可能会收到含有此系统事件消息的电子邮件。

解决方案:

在 TIM 上加载插件 JAR 文件时出错。

这通常是网络问题引起的。 验证 TIM 是否正在运行、已启用且可访问。

禁用并重新启用插件,然后确认该插件在每个 TIM 上都处于活动状态。

请参阅启用和禁用 TIM 监视器

请参阅部署 HTTP 分析程序插件的清单

症状:

系统事件显示在“系统”>“事件”日志中:

企业管理器无法访问 TIM

…,并显示如下说明:

Error retrieving http://<ip_address>/wily/cem/tim/tess/setpluginconfig: Read timed out

您还可能会收到含有此系统事件消息的电子邮件。

解决方案:

在 TIM 中加载插件配置文件时出错。

这通常是网络问题引起的。 验证 TIM 是否正在运行、已启用且可访问。

禁用并重新启用插件,然后确认该插件在每个 TIM 上都处于活动状态。

请参阅启用和禁用 TIM 监视器

请参阅部署 HTTP 分析程序插件的清单

症状:

应显示的日志消息未显示在 TIM 日志中。

解决方案:

验证插件在 CEM 控制台中已启用,且在 TIM 中处于活动状态。

症状:

插件填满了 TIM 日志。

解决方案:

更改插件,以使其不返回日志消息(或仅记录关键消息)。 在非生产环境中调试并测试插件。

请参阅启用和禁用 TIM 监视器

请参阅部署 HTTP 分析程序插件的清单

TIM 状态

症状:

正在执行的 Java 插件 ID 经常显示非零值。

此处显示的任何插件可能经常处于循环或等待状态,这阻止了 TIM 执行所有其他处理工作。

解决方案:

检查插件是否处于循环或等待状态。

请参阅禁用 HTTP 分析程序插件

请参阅部署 HTTP 分析程序插件的清单

症状:

正在执行的 Java 插件 ID 始终显示为 0。

这属于常见情况,通常不会引起关注。

解决方案:

“TIM 状态”页面仅在执行插件的那一刻显示插件 ID。 您可以尝试更新“自动刷新 (以秒为单位)”选项或以其他方式进行验证。 (“TIM 状态”页面可能显示得太快,而无法观察。)

症状:

TIM 插件状态不显示该插件。

在 CEM 控制台中保存插件配置时,该插件应显示在列表中。

解决方案:

验证该插件是否显示在插件列表中。 验证是否已在“设置”>“监视器”页面上启用 TIM 监视器。

症状:

TIM 插件状态显示该插件未处于活动状态。

启用插件后,该插件在 TIM 上应显示为活动状态。

解决方案:

验证是否已在“设置”>“监视器”页面上启用 TIM 监视器。

另请参阅下一个症状/解决方案。

症状:

TIM 插件状态显示插件未处于活动状态,但在 CEM 控制台的插件列表中显示为已启用。

解决方案:

这是由于插件中未捕获的程序异常引起的。 插件还会生成一个系统事件。

请参阅 TIM 日志堆栈跟踪以找出未捕获的异常的发生位置。

调试代码并进行更正。

请参阅禁用 HTTP 分析程序插件

请参阅部署 HTTP 分析程序插件的清单

症状:

所有 TIM 上的 TIM 插件状态并不相同。

每个启用的 TIM 上的插件状态应当同时发生变化。

解决方案:

确认所有 TIM 均已启用。

另请参阅上一个症状/解决方案。

注意:插件程序异常可能发生在一个 TIM 上,而不发生在另一个 TIM 上。

症状:

TIM 设备运行状况指示内存使用过于频繁。

插件是造成该问题的一个可能原因。

解决方案:

修改插件代码以改善内存使用。

请参阅禁用 HTTP 分析程序插件

请参阅部署 HTTP 分析程序插件的清单

事务标识

症状:

插件已启用并且事务正在运行,但是 TIM 无法识别它们。

解决方案:

验证业务事务是否已启用。

验证已应用到插件的筛选。 请参阅关于使用筛选来限制 HTTP 分析程序插件流量

症状:

业务事务已启用,并且事务正在运行,但 TIM 无法识别它们。

解决方案:

验证插件是否已启用且正在运行。 启用 TIM 组件参数跟踪(“TIM 系统设置”>“配置 TIM 踪迹选项”)。

查看 TIM 日志。 请参阅 TIM 日志堆栈跟踪。

症状:

记录功能不工作。

解决方案:

确认没有插件处于循环或等待状态。

症状:

事务监控功能似乎不工作。

解决方案:

确认您没有监控太大的事务子集。

症状:

事务监控正在工作,但 TIM 似乎落后于事务监控。

解决方案:

您必须选中筛选旁边的复选框,进行更改,然后单击“保存”。

用户界面

症状:

更改 IP 地址或端口筛选然后单击“保存”时不起作用。

解决方案:

您必须选中筛选旁边的复选框,进行更改,然后单击“保存”。

症状:

TIM 插件 JAR 文件命名为 600000000000000001.jar,但不确定它是哪个插件。

解决方案:

请转到“TIM 系统设置”>“查看 TIM 插件状态”查看 JAR 文件与插件名称的相关性。

症状:

现有的插件 JAR 文件命名为 [Plugin_Name]_1246906950581.jar。

解决方案:

如果您更新插件代码时未选择“覆盖现有文件”选项,便会发生这种情况。

这意味着新旧 JAR 文件都存储在企业管理器上。

在大多数情况下,您应当覆盖现有 JAR 文件。

代码和编译器

症状:

不确定 JAR 文件是否在企业管理器计算机上。

解决方案:

插件 JAR 文件存储在企业管理器的 /etc/wily/cem/tess/plugins/ 目录下。

不要更改此目录或其内容。

症状:

不确定 JAR 文件是否位于 TIM 计算机上。

解决方案:

插件 JAR 文件存储在 TIM 上的 /etc/wily/cem/tim/config/javaplugins/ 目录下。

不要更改此目录或其内容。

症状:

编译器错误。

解决方案:

CemJavaPlugin 类必须声明为公共类。