使用 HTTP 分析程序插件标识事务 › HTTP 分析程序插件概览

HTTP 分析程序插件概览

HTTP 分析程序插件包括软件开发工具包 (SDK)。 该 SDK 包括文档、示例插件的源代码以及用于定义插件 API 的 Java 接口。

API 用于定义 TIM 通过 HTTP 组件请求和响应数据来调用的插件方法。 这些方法将返回参数（名称/值对），TIM 会将这些参数添加到其内部参数列表中，然后与事务定义进行匹配。 插件方法还可能返回日志消息，并显示在 TIM 日志中。

CA CEM 使用 Plug-in 参数类型来标识在 HTTP 分析程序插件中定义的事务。 所有由插件生成的参数被自动指定为 Plug-in 参数类型。

Plug-in 参数类型可用于标识以下内容：

• 事务－使用组件标识参数
• 用户－标识正确的用户
• 会话－标识正确的会话
• 用户组－标识正确的用户组

当 TIM 监控 HTTP 组件请求和响应时，它会将请求和响应传递给插件。 TIM 将插件返回的所有参数添加到其类型为插件的内部参数列表中。

利用 HTTP 分析程序插件功能，您可以对 TIM 传递给插件的内容进行筛选。 您可以按服务器 IP 地址范围、端口号和 URL 筛选进行筛选。

Plug-in 参数显示在 CA CEM 缺陷的 HTTP 信息部分中。

一次可以启用多个插件，但最多只能启用 10 个插件。 如果请求与插件的筛选器匹配，那么 TIM 会将每个 HTTP 组件请求传递给每个启用的插件。 TIM 将使用来自所有插件的参数。

CemPluginApiV2 接口包括下列方法，TIM 会调用一次这些方法：

• initialize－当 TIM 启用插件时调用
• terminate－当 TIM 禁用插件或插件抛出异常时调用

TIM 按照下列顺序针对每个 HTTP 组件调用下列方法：

• newComponent－在每个 HTTP 组件的开头处调用一次
• requestHeader－为每个 HTTP 请求头调用
• endRequestHeader－在 HTTP 请求头的结尾处调用一次
• requestBody－如果请求包含正文，则调用一次或多次
• endRequest－不管组件是否包含正文，均在 HTTP 请求的结尾处调用一次；仅在请求正常完成时调用
• responseStart－在 HTTP 响应的开头处调用
• responseHeader－为每个 HTTP 响应头调用
• endResponseHeader－在 HTTP 响应头的结尾处调用一次
• responseBody－如果响应包含正文，则调用一次或多次
• endResponse－不管组件是否包含正文，均在 HTTP 响应的结尾处调用一次；仅在响应正常完成时调用
• endComponent－在组件的结尾处调用一次

上述方法（不包括 initialize 或 terminate）可能会返回 null 或 CemPluginOutput 实例。 CemPluginOutput 类包含两个字段，这两个或其中一个字段可能为 null：

• 由插件提供的、即将添加到 TIM 参数列表中的参数数组（名称/值对，即监控的内容）
• 要写入 TIM 日志的日志消息（即，刚发生的操作）

注意：通常，同一时间可能会有多个 HTTP 组件在运行（换言之，多个事务组件处于不同的状态）。 组件 ID 将传递给每个组件方法，以便插件可以同时处理多个组件。