IBM Performance Management

Node.js 代理程序监视插件：运行时配置文件

您可以通过在每个 Node.js 监视插件的配置文件中更改其运行时配置来更改此插件的行为。

运行时配置文件

Node.js 监视插件代码位于插件文件夹中：install_dir/lx8266/nj/bin/plugin，其中，install_dir 是代理程序安装目录。针对 install_dir/lx8266/nj/bin/plugin/lib 文件夹中的每个监视插件都有一个运行时配置文件。监视插件每 2 分钟读取一次配置文件。更改配置文件的内容时，关联插件的行为会更改。

提示：运行时配置文件按 plugin_application port number_conf.json 格式进行命名。如果一个 Node.js 应用程序正在侦听多个端口号，那么会使用最小端口号。

配置文件中有两种类型的信息：

URL 过滤规则
插件日志记录参数

URL 过滤规则

将使用正则表达式将 URL 路径名映射到用户定制的路径名。可通过将 URL 映射到定制的路径名来满足以下需求：

您希望忽略静态文件的 URL 路径时。
例如，如果某个 Web 页面包括会生成单独的服务器下载请求的图像，您可能不想查看这些类型的请求的响应时间。
您希望将 URL 与类似的路径汇总时。例如，以下示例中所显示的类似 URL 路径。
```
/demo/poll/1
/demo/poll/2
/demo/poll/3
...
```
在 Web 服务器上，针对这些路径的请求很可能由共同的例程进行处理。在这种情况下，可按以下示例中所示，使用过滤器将路径汇总为单一 URL 类型。
```
"filters":
[
	{
		"pattern": "/demo/poll/.+",
		"to": "/demo/poll/"
	}
```
此过滤器会将针对诸如 "/demo/poll/xxx" 之类的 URL 路径的所有请求映射到 URL 路径类型 "/demo/poll"。然后，针对此类型 URL 路径的所有请求的响应时间会取平均值为单个值。以这种方式汇总可帮助您更高效地利用可用资源。

在配置文件中，有一个名为 filters 的 JSON 数组。此数组包含 URL 过滤规则，例如：

"filters":
[
    {
        "pattern": ".+\\.png$",
        "to": ""
    },
    {
        "pattern": ".+\\.jpg$",
        "to": ""
    },
    {
        "pattern": "GET /js/.+\\.js$",
        "to": ""
    },
    {
        "pattern": "GET /css/.+\\.css$",
        "to": ""
    }
]

数组中的每个成员都是一个过滤规则。插件接收到 HTTP 请求时，该插件会从该请求提取 URL 路径名，并将其与每个 "pattern" 进行比较。如果路径名匹配特定模式，那么会将该模式的 "to" 值用作 URL 路径名。当 "to" 值为空时，插件会忽略该请求。如果路径名不匹配 "pattern"，那么原始 URL 路径名会保留并用于度量。

插件日志记录参数

在配置文件中，有三个日志记录参数

跟踪日志文件名
跟踪级别
跟踪大小循环

日志文件中的条目如下所示：

"traceFile": "/tmp/app.log",
"traceLevel": "error",
"traceSizeRotate": "10",

您可以通过更改 "traceFile" 的值来指定日志文件名。缺省值为 "/tmp/app.log"。您可以通过更改 "traceLevel" 的值来设置日志文件跟踪级别。缺省值为 "error"。支持两个跟踪级别值："info" 和 "error"。如果将跟踪级别设置为值 "info"，那么在插件正常运行时会记录消息，还会记录发送到代理程序的原始监视数据。如果将跟踪级别设置为值 "error"，那么仅会在发生错误情况时记录消息。您可以通过更改 "traceSizeRotate"（兆字节）的值来指定日志文件的循环大小。缺省值为 10，这意味着在日志文件的大小达到 10 兆字节时将删除该文件。将针对新日志创建同名的空日志文件。

Node.js 代理程序 监视插件：运行时配置文件

运行时配置文件

URL 过滤规则

插件日志记录参数

Node.js 代理程序监视插件：运行时配置文件