上一主题: 查看默认的 TIBCO EMS 报警下一主题: 监控 webMethods Broker


代理配置属性汇总

EMSMonitor 代理依赖于 TibcoEMSMonitor.properties 文件中的大量配置属性来定义所连接到的 EMS 服务器实例及其监控的组件。 下面列出了这些属性的汇总,并描述了每个属性可接受的值的类型(作为设置有效值的快速参考)。

通过几个配置属性,您可以为模式匹配指定正则表达式。 有关正则表达式语法和有效构造的摘要,请参阅 Java 文档中有关模式匹配的信息。

ems.server.list

包含想要监控的 EMS 服务器实例名称的逗号分隔列表。

所指定的名称不需要与正在监控的服务器实例的实际名称匹配。 例如,如果您有两个具有相同名称但不同端口的服务器实例,可以在 ems.server.list 属性中使用别名对其进行区分。

例如:

ems.server.list=mercury01,mercury02,jupiter03
<ServerInstance>.host

承载指定服务器实例的 EMS 服务器的主机名或 IP 地址。 默认值为 localhost

例如:

mercury01.host=winsrvT400
<ServerInstance>.port

承载指定服务器实例的 EMS 服务器的端口号。 默认值为 7222。

例如:

mercury01.port=7200
<ServerInstance>.username

具有管理权限的用户名,可用于建立到 EMS 服务器的连接。 通常在使用 emsPwdEncryptor 实用工具对帐户密码进行加密时设置此属性。

默认值为 admin

例如:

mercury01.username=jgarcia
<ServerInstance>.password

<ServerInstance>.username 属性指定的用户帐户的密码。 通常在使用 emsPwdEncryptor 实用工具对帐户密码进行加密时设置此属性。

默认值为空字符串(无密码)。

例如:

mercury01.password=YCLhqcwQfpc=
<ServerInstance>.delaytime

在对 EMD 服务器进行查询以刷新正在监控的 EMS 服务器组件的度量标准之前的时间间隔(以秒为单位)。

EMSMonitor 代理将按此时间间隔收集有关服务器实例及其组件的状态的度量标准。

默认值为 60 秒。

例如:

mercury01.delaytime=90
<ServerInstance>.report.static.freq

在静态度量标准查询之间执行的 EMS 服务器状态查询数。 例如,如果将此属性设置为 20,则 EMSMonitor 代理每收集 20 次度量标准,与静态配置相关的度量标准才更新一次。

默认值为 20。

例如:

mercury01.report.static.freq=50
<ServerInstance>.queue.filter.includeonly.regex

指定一个正则表达式来监控名称与该表达式匹配的队列。 可以使用任何有效的正则表达式。 某些特殊字符需要转义序列。

默认情况下,如果不使用此属性指定筛选,则 EMSMonitor 代理会收集所有队列的度量标准。

例如:

mercury01.queue.filter.includeonly.regex=[A-H]
<ServerInstance>.topic.filter.includeonly.regex

指定正则表达式以监控其名称与表达式匹配的主题。 可以使用任何有效的正则表达式。 某些特殊字符需要转义序列。

默认情况下,如果不使用该属性指定筛选,EMSMonitor 代理将收集所有主题的度量标准。

例如:

mercury01.topic.filter.includeonly.regex=[a-hA-H]
<ServerInstance>.queue.filter.include.dynamic

指定是否要监控此 EMS 服务器实例的动态队列。 如果要包括动态队列的度量标准,请将此属性设置为 true

默认情况下,EMSMonitor 代理仅监控静态队列。

例如:

mercury01.queue.filter.include.dynamic=true
<ServerInstance>.topic.filter.include.dynamic

指定是否要监控该 EMS 服务器实例的动态主题。 如果要包括动态主题的度量标准,可将该属性设置为 true

默认情况下,EMSMonitor 代理仅监控静态主题。

例如:

mercury01.topic.filter.include.dynamic=true
<ServerInstance>.monitor.bridges

指定是否要监控该 EMS 服务器实例的桥。 如果要包括桥的度量标准,可将该属性设置为 true

默认情况下,EMSMonitor 代理不监控网桥。

例如:

mercury01.monitor.bridges=true
<ServerInstance>.monitor.channels

指定是否要监控该 EMS 服务器实例的多播通道。 如果要包括通道的度量标准,可将该属性设置为 true

默认情况下,EMSMonitor 代理不监控通道。

例如:

mercury01.monitor.channels=true
<ServerInstance>.monitor.routes

指定是否要监控该 EMS 服务器实例的路由。 如果要包括路由的度量标准,可将该属性设置为 true

默认情况下,EMSMonitor 代理不监控路由。

例如:

mercury01.monitor.routes=true
<ServerInstance>.bridge.filter.includeonly.regex

指定一个正则表达式来监控名称与该表达式匹配的网桥。 可以使用任何有效的正则表达式。 某些特殊字符需要转义序列。

默认情况下,如果将 <ServerInstance>.monitor.bridges 属性设置为 true 且未使用此属性指定筛选,则 EMSMonitor 代理会收集所有网桥的度量标准。

例如:

mercury01.bridge.filter.includeonly.regex=test.*
<ServerInstance>.channel.filter.includeonly.regex

指定正则表达式以监控其名称与表达式匹配的通道。 可以使用任何有效的正则表达式。 某些特殊字符需要转义序列。

默认情况下,如果已将 <ServerInstance>.monitor.channels 属性设置为 true,且未使用该属性指定筛选,EMSMonitor 代理将收集所有通道的度量标准。

例如:

mercury01.channel.filter.includeonly.regex=test.*
<ServerInstance>.route.filter.includeonly.regex

指定正则表达式以监控其名称与表达式匹配的路由。 可以使用任何有效的正则表达式。 某些特殊字符需要转义序列。

默认情况下,如果已将 <ServerInstance>.monitor.routes 属性设置为 true,且未使用该属性指定筛选,EMSMonitor 代理将收集所有路由的度量标准。

例如:

mercury01.route.filter.includeonly.regex=test.*
<ServerInstance>.monitoring.level

定义 EMS 服务器实例的监控级别。 此属性的有效设置有 minimumrecommendedfull

默认服务器监控级别为 recommended

例如:

mercury01.monitoring.level=minimum
<ServerInstance>.queue.monitoring.level

为 EMS 服务器实例上的队列定义监控级别。 此属性的有效设置有 minimumrecommendedfull

默认队列监控级别为 recommended

例如:

mercury01.queue.monitoring.level=recommended
<ServerInstance>.topic.monitoring.level

为 EMS 服务器实例上的主题定义监控级别。 此属性的有效设置有 minimumrecommendedfull

默认主题监控级别为 recommended

例如:

mercury01.topic.monitoring.level=full
client.identity

指定可供 EMS 服务器用于验证 EMSMonitor 代理身份的证书的路径。 大多数情况下,在运行 emsPwdEncryptor 程序时设置此属性。

例如:

client.identity=C:/TibcoEMSMonitor/certs/client.p12
ssl.password

为客户端安全证书指定加密密码。

大多数情况下,在运行 emsPwdEncryptor 程序时设置此属性。

<ServerInstance>.ssl.connection

指定是否使用安全套接字层 (SSL) 协议连接到服务器实例。

如果要使用 SSL 连接到服务器实例,请将此属性设置为 enable。 如果想要允许不安全的通信,请将此属性设置为 disable

与安全性相关的属性没有默认值。

<ServerInstance>.verify.host

指定 EMSMonitor 代理是否必须要验证 EMS 服务器的证书。 将此属性设置为 true 将要求代理根据为 trusted.certificates 属性定义的列表来验证 EMS 服务器的安全证书。

与安全性相关的属性没有默认值。

例如,要求在代理连接到 EMS 服务器实例 mercury01 时进行验证:

mercury01.verify.host=true
trusted.certificates

指定 EMSMonitor 代理用于验证服务器证书的可信证书的列表(以逗号分隔)。 如果 verify.host 属性设置为 true,且适用于所有使用 SSL 的 EMS 服务器实例,则该属性是必需的。

与安全性相关的属性没有默认值。

<ServerInstance>.verify.hostname

指定代理是否应验证服务器证书的“公用名称 (CN)”字段。

如果希望代理将已连接主机的名称或 <ServerInstance>.expected.name 属性中指定的名称与服务器证书中的“公用名称 (CN)”字段进行比较,请将此属性设置为 true。 如果设为 true 且名称不匹配,代理将拒绝连接。

与安全性相关的属性没有默认值。

<ServerInstance>.expected.hostname

指定 EMSMonitor 代理预期在服务器证书中的“公用名称 (CN)”字段中找到的名称。

与安全性相关的属性没有默认值。

cipher.suites

指定一个以逗号分隔的密码组列表,EMSMonitor 代理可使用该列表来加密与启用了 SSL 的 EMS 服务器的通信。‑ EMSMonitor 代理可以使用要监控的 EMS 服务器所支持的任何加密软件包。 如果设置该属性,它将适用于所有启用 SSL 的 EMS 服务器实例。

与安全性相关的属性没有默认值。