为 IBM MQ 配置高可用性(HA)支持

在高可用性(HA)环境中配置 IBM MQ 队列管理器,通过 Instana 实现对连续历史数据的统一视图。

支持的高可用性环境

  • 复制数据队列管理器(RDQM)
  • 多实例队列管理器 (multi-instance queue manager)
  • 原生高可用队列管理器
  • Red Hat OpenShift Container Platform (OCP)中的单实例队列管理器

预备条件

在每个受监控的队列管理器实例上本地安装 Instana 主机代理,适用于以下高可用队列管理器:

  • 复制数据队列管理器(RDQM):在每个RDQM主机上安装代理。

    注意: RDQM主机必须是 Linux 平台的虚拟机或物理机。
  • 多实例队列管理器:

    • 对于分布式平台:在多实例主机的每个队列管理器实例上安装代理。
    • 对于 Kubernetes 环境:请在 Kubernetes 环境中安装代理。
  • 原生HA队列管理器:在 Kubernetes 环境中安装代理。

  • Red Hat OCP 中的单实例队列管理器:在 Kubernetes 环境中安装代理。

启用高可用性支持

IBM MQ 高可用队列管理器的支持默认未启用,以确保与常规队列管理器保持一致性。

要监控 IBM MQ 高可用队列管理器,请在代理配置文件中将 support_ha true 参数设置 <agent_install_dir>/etc/instana/configuration.yaml 为 ,如下所示:

com.instana.plugin.ibmmq:
  enabled: true
  poll_rate: 60 # The default is 60 seconds. The minimum value is 30 seconds.
  support_ha: false # true or false. The default value is false. If the value is true, the HA Queue manger instances will be shown as 1 aggregated Queue manager.
 
注意: 在 Red Hat OCP环境中,若需手动在 configuration.yaml 部署文件中 support_ha 设置以激活高可用性支持,必须编辑部署文件并重新部署 Instana 主机代理。 在其他环境中,无需重启代理即可激活高可用性支持。

查看HA队列管理器数据

Instana 用户界面以如下方式显示 IBM MQ 高可用队列管理器数据:

在启用高可用性支持之前

在启用高可用性支持之前,所有高可用性队列管理器的实例均被监控,并在 Instana 界面中通过 qmName@host 标签单独显示。 每个实例都显示为其运行主机的层级。

启用高可用性支持后

在启用高可用性支持后,所有高可用队列管理器的实例均作为统一队列管理器进行监控,其数据将被聚合:

  • 所有HA队列管理器的实例均被监控,并作为单个队列管理器显示,其标签 qmName以独立框的形式呈现。
  • 该名称 qmName@host1-host2-host3 显示在 Instana 用户界面中 IBM MQ 队列管理器实例仪表板的摘要信息中。
  • 由于高可用队列管理器的聚合,主机级相关性被移除,因此基于主机的过滤器不再起作用。 使用 entity.ibmmq.qm.activeNode:* 来搜索 HA 队列管理器。
  • 请在代理 configuration.yaml 程序文件的 部分 ibmmq plug-in 设置可用区,而非主机部分,因为队列管理器与原始单一主机的关联已被移除。 如果区域设置在主机部分,则在启用高可用性支持后,队列管理器将显示在未定义区域中。
  • 在配置跟踪后, Instana IBM MQ 传感器与 IBM MQ 跟踪在呼叫详情中的基础设施链接仍可正常工作。 有关更多信息,请参阅《 故障排除》。

启用队列管理器的HA支持将激活对以下 IBM MQ HA环境的监控。 以下各节说明了 Instana 如何聚合数据,并在 Instana 用户界面中呈现以下各高可用性环境的数据:

  • RDQM

    • 汇总运行中和备用队列管理器实例的数据。
    • RDQM高可用性(RDQM HA):在运行队列管理器的仪表板上显示 HA TypeHA RolePreferred LocationFloating IPActive Node、和 Standby Nodes
    • RDQM灾难恢复(RDQM DR):在运行队列管理器的仪表板上显示 DR RoleDR Remote IPDR StatusDR TypeDR Port、和。
  • 多实例队列管理器

    • 汇总来自运行中、备用及其他队列管理器实例的数据。
    • 在运行队列管理器的仪表板上显示 HA Type, Active Node, Elsewhere Nodes Standby Nodes, 和。
  • 原生高可用性

    • 汇总运行中和副本队列管理器实例的数据。
    • 在运行队列管理器的仪表板上显示 HA Type, Active NodeStandby Nodes , 和。
  • Red Hat OCP中的单实例

    • 监控运行中的队列管理器实例。
    • 在运行队列管理器的仪表板上显示 HA TypeActive Node 和。