第七十章 使用 REST API 監控 IRIS - 互操作性指標
除了上一節中描述的指標外, IRIS 實例還可以記錄有關活動互操作性產品的指標,並將它們包含在 /metrics
端點的輸出中。默認情況下禁用這些互操作性指標的記錄。要啓用它,必須爲要監控的每個互操作性產品執行以下步驟:
- 爲運行要監控的生產的
IRIS
實例打開一個終端會話。如有必要,通過執行以下命令切換到與生產關聯的命名空間:
set $namespace = "[interopNS]"
其中 [interopNS]
是命名空間名稱。
- 在終端中,執行以下命令以啓用當前命名空間內活動生產的指標收集(
SAM
指的是系統警報和監控, 監控解決方案):
do ##class(Ens.Util.Statistics).EnableSAMForNamespace()
注意:如果爲命名空間啓用了指標記錄但相應的生產未激活,則 /metrics
端點不會返回任何指標。
Ens.Util.Statistics
類提供了自定義 /metrics
端點輸出的方法。例如,調用方法 DisableSAMIncludeHostLabel
將爲整個生產提供聚合指標,而不是爲每個主機單獨提供它們。
完成此步驟後可用的指標在下面的基本互操作性指標表中進行了描述。
- 如果想收集有關生產活動量的其他指標,則必須通過使用終端在相應命名空間中調用類方法
Ens.Util.Statistics.EnableStatsForProduction
來啓用活動監控。還必須將Ens.Activity.Operation.Local
業務操作添加到生產中。此過程在監控活動量頁面上的啓用活動監控中有詳細說明。
完成此步驟後可用的其他指標在下面的活動量指標表中進行了描述。
- 如果想爲使用
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"}
- 當前在生產和命名空間中排隊的消息數。如果輸出已配置爲包括主機標籤,則單獨提供當前爲每個主機排隊的消息數。