第七十章 使用 REST API 监控 IRIS - 互操作性指标

第七十章 使用 REST API 监控 IRIS - 互操作性指标

除了上一节中描述的指标外， IRIS 实例还可以记录有关活动互操作性产品的指标，并将它们包含在 /metrics 端点的输出中。默认情况下禁用这些互操作性指标的记录。要启用它，必须为要监控的每个互操作性产品执行以下步骤：

1. 为运行要监控的生产的 IRIS 实例打开一个终端会话。如有必要，通过执行以下命令切换到与生产关联的命名空间：

set $namespace = "[interopNS]"

其中 [interopNS] 是命名空间名称。

2. 在终端中，执行以下命令以启用当前命名空间内活动生产的指标收集（SAM 指的是系统警报和监控， 监控解决方案）：

do ##class(Ens.Util.Statistics).EnableSAMForNamespace()

注意：如果为命名空间启用了指标记录但相应的生产未激活，则 /metrics 端点不会返回任何指标。

Ens.Util.Statistics 类提供了自定义 /metrics 端点输出的方法。例如，调用方法 DisableSAMIncludeHostLabel 将为整个生产提供聚合指标，而不是为每个主机单独提供它们。

完成此步骤后可用的指标在下面的基本互操作性指标表中进行了描述。

3. 如果想收集有关生产活动量的其他指标，则必须通过使用终端在相应命名空间中调用类方法 Ens.Util.Statistics.EnableStatsForProduction 来启用活动监控。还必须将 Ens.Activity.Operation.Local 业务操作添加到生产中。此过程在监控活动量页面上的启用活动监控中有详细说明。

完成此步骤后可用的其他指标在下面的活动量指标表中进行了描述。

4. 如果想为使用 EnsLib.HTTP.OutboundAdapter 或 EnsLib.SOAP.OutboundAdapter 的互操作性 Web 客户端收集其他 HTTP 传输指标，则必须通过执行以下步骤为相应的业务操作启用 ``HTTP 指标报告：

a. 打开包含要监控的 Web 客户端的 IRIS 实例的管理门户。

b. 选择互操作性并选择包含 Web 客户端的名称空间。

c. 选择“配置”>“生产”以打开“生产配置”页面。

d. 选择使用 HTTP 或 SOAP 出站适配器的操作。

e. 在 Production Settings > Settings 面板的 Alerting Control 部分，选中 Provide Metrics for SAM 复选框。

f. 选择应用以保存设置。

完成此步骤后可用的其他指标在下面的 HTTP 指标表中进行了描述。

注意：目前，仅针对使用队列样式（而非 inProc）调用参与者的业务操作收集 HTTP 传输指标。

下表列出了 IRIS 互操作性指标。带有标签的指标名称出现在此处并带有换行符以提高可读性。

注意：这些表格包含此处记录的 IRIS 版本的指标。由于新版本中可能会添加指标，因此请确保该文档与 IRIS 版本相匹配。

基本互操作性指标

• iris_interop_alert_delay {id="namespace",host="host",production="production"} - 生产和命名空间中已触发队列等待警报 的主机数量。如果输出已配置为包含主机标签，则会单独提供触发队列等待警报的主机，并且该值将为 1。
• iris_interop_hosts {id="namespace",status="status",host="host",production="production"} - 当前具有指定状态的生产和命名空间中的主机数。如果输出已配置为包括主机标签，则单独提供每个主机的状态，并且值为 1。状态可以是 OK、Error、Retry、Starting、Inactive 或 Unconfigured。
• iris_interop_messages {id="namespace",host="host",production="production"} - 自生产开始以来处理的消息数。如果输出已配置为包括主机标签，则单独提供每个主机处理的消息数
• iris_interop_messages_per_sec {id="namespace",host="host",production="production"} - 在最近的采样间隔内，每秒在生产和命名空间内处理的平均消息数。如果输出已配置为包括主机标签，则单独提供每个主机处理的消息数
• iris_interop_queued {id="namespace",host="host",production="production"} - 当前在生产和命名空间中排队的消息数。如果输出已配置为包括主机标签，则单独提供当前为每个主机排队的消息数。