IBM MQ の高可用性(HA)機能の設定

Instana を使用して、高可用性(HA)環境における IBM MQ キューマネージャーを設定し、継続的な履歴データを一元的に把握できるようにします。

対応しているHA環境

  • レプリケート・データ・キュー・マネージャー(RDQM)
  • マルチ・インスタンスのキュー・マネージャー (multi-instance queue manager)
  • ネイティブ HA キューマネージャー
  • Red Hat OpenShift Container Platform (OCP)におけるシングルインスタンス・キューマネージャー

前提条件

以下のHAキューマネージャーについては、監視対象の各キューマネージャーインスタンスに、 Instana ホストエージェントをローカルにインストールしてください:

  • レプリケート・データ・キュー・マネージャー(RDQM):各RDQMホストにエージェントをインストールします。

    注: RDQMホストは、 Linux プラットフォーム上の仮想マシンまたは物理マシンである必要があります。
  • マルチインスタンス・キュー・マネージャー:

    • 分散プラットフォームの場合:マルチインスタンスホスト上の各キューマネージャインスタンスにエージェントをインストールしてください。
    • Kubernetes 環境の場合: Kubernetes 環境にエージェントをインストールしてください。
  • ネイティブ HA キューマネージャー: Kubernetes 環境にエージェントをインストールします。

  • Red Hat OCP のシングルインスタンス・キューマネージャー: Kubernetes 環境にエージェントをインストールします。

高可用性(HA)のサポートを有効にする

通常のキューマネージャーとの整合性を保つため、 IBM MQ のHAキューマネージャー機能はデフォルトでは有効になっていません。

IBM MQ のHAキューマネージャーを監視するには、以下の設定例に示すように、エージェント <agent_install_dir>/etc/instana/configuration.yaml 設定ファイル内の true パラメータ support_ha を に設定してください

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環境において、HAサポートを有効にするためにファイル configuration.yaml を手動で support_ha 設定する場合は、デプロイメントファイルを編集し、 Instana ホストエージェントを再デプロイする必要があります。 その他の環境では、エージェントを再起動することなくHAサポートが有効化されます。

HAキューマネージャーのデータの表示

Instana のUIでは、 IBM MQ HAキューマネージャーのデータが次のように表示されます:

HA機能を有効にする前に

HAサポート導入前は、すべてのHAキューマネージャーのインスタンスが監視され、 InstanaqmName@host のUI上でラベル付きで個別に表示されていました。 各インスタンスは、それが実行されているホストのレイヤーとして表示されます。

HA機能を有効にした後

HAサポートの適用後、すべてのHAキューマネージャーのインスタンスは単一のキューマネージャーとして監視され、そのデータは集約されます:

  • HAキューマネージャーのすべてのインスタンスは監視され、ラベル付きの独立 qmNameしたボックスとして、1つのキューマネージャーとして表示されます。
  • この名前は、 Instana UI の「 IBM MQqmName@host1-host2-host3 」キューマネージャー・インスタンスのダッシュボードにある概要情報に表示されます。
  • HAキューマネージャーの集約により、ホストレベルの相関関係が削除されるため、ホストベースのフィルタは機能しなくなります。 を使用して entity.ibmmq.qm.activeNode:* 、HAキューマネージャーを検索します。
  • キューマネージャーと元の単一ホストとの関連付けが解除されているため、ホストセクションではなく、エージェント configuration.yaml ファイルのセクション ibmmq plug-in でアベイラビリティゾーンを設定してください。 ホスト側でゾーンが設定されている場合、HAサポートを有効にすると、キューマネージャーは未定義のゾーンに表示されます。
  • Instana IBM MQ のセンサーと IBM MQ のコール詳細におけるトレース間のインフラストラクチャ接続は、トレースの設定後も引き続き機能します。 詳細については、 「トラブルシューティング」 を参照してください。

キューマネージャーのHAサポートを有効にすると、以下の IBM MQ HA環境の監視が開始されます。 以下のセクションでは、 Instana がデータを集約し、以下の各HA環境について Instana のUIに表示する方法について説明します

  • RDQM

    • 稼働中およびスタンバイのキューマネージャインスタンスからのデータを集約します。
    • RDQM 高可用性 (RDQM HA):実行中のキューマネージャーのダッシュボードに Standby NodesHA RolePreferred LocationFloating IPActive Node、、 HA Typeおよび が表示されます。
    • RDQM ディザスタリカバリ (RDQM DR):実行中のキューマネージャのダッシュボードに DR Remote IPDR StatusDR TypeDR Port、、および DR Roleを表示します。
  • マルチ・インスタンスのキュー・マネージャー

    • 稼働中、スタンバイ、およびその他のキューマネージャインスタンスからのデータを集約します。
    • 実行中のキューマネージャーのダッシュボードに、 Active NodeStandby NodesElsewhere NodesHA Typeおよびを表示します。
  • ネイティブHA

    • 稼働中のキューマネージャインスタンスおよびレプリカキューマネージャインスタンスからのデータを集約します。
    • 実行中のキューマネージャーのダッシュボードに、 Active NodeHA TypeStandby Nodes およびを表示します。
  • Red Hat OCPにおけるシングルインスタンス

    • 実行中のキューマネージャインスタンスを監視します。
    • 実行中のキューマネージャーのダッシュボード Active Node に と HA Type が表示されます。