1. 今回対応したい課題

IBM MQ を Instanaで監視する際のヒントです。
Instana においては、デフォルトの組込みイベント監視として、QMGRで定義されている LISTENER 全てを監視しています。

お客様によっては、IBM MQを利用する際に、デフォルトのリスナー SYSTEM.DEFAULT.LISTENER.TCP ではなく、別名のリスナーを定義して、利用されている環境もあるかと思います。
下図の例ですと、1515ポートで待ち受けるMYLISTENERを定義して、それを利用しています。

このような環境では SYSTEM.DEFAULT.LISTENER.TCP は起動していず、常にSTOPPEDというステータスになっていますので、デフォルトのIBM MQ Listener の監視設定では、エラーが出続けてしまいます。

この記事では、① 利用している特定のLISTENER用の監視定義を作り監視を行い、 ②デフォルトのIBM MQ LISTENER 監視定義を停止することによって、実際の環境にあわせた監視へと変えていきたいと思います。

2. 監視設定の修正

2-1. 利用している特定のLISTENER用の監視定義

設定 > イベント　より新規イベントを選択し、以下のようにイベントを作成します。

1 イベントの詳細

定義	設定値	備考
名前	IBM MQ Listener MYLISTENER が起動していません	通知されるイベントのタイトル
説明	任意の文字列	イベントの説明
問題の重大度	クリティカル (デフォルト監視とレベルをあわせました）	クリティカル / 警告

2 条件

定義	設定値	備考
ソース	組込みメトリック	監視データ種類
エンティティ・タイプ	IBM MQ リスナー	監視対象
時間枠	1秒
メトリック	状況	IBM MQ リスナーのステータス値を取得
集約	avg
オペレーター	≠ (等しくない）
状況値	2 (RUNNING)	ステータス値はこちら

3 スコープ　ダイナミック・フォーカス・クエリーで絞り込みます

定義	設定値	備考
選択されているエンティティのみ（ダイナミック・フォーカス・クエリ）	entity.ibmmq.listener.name:MYLISTENER	特定のリスナーのみ監視 ※

※ デフォルトのリスナー以外だけ対象から外したいのであれば
entity.type:ibmmq.listener AND NOT entity.ibmmq.listener.name:"SYSTEM.DEFAULT.LISTNER.TCP"
という定義でもいいかもしれません。環境にあわせて設定ください。

3. デフォルトの IBM MQ LISTNER の定義を停止します

デフォルトで用意された IBM MQ Listener staus の ||のボタンをクリックして、監視を停止しグレーアウトされたことを確認します

4. 監視設定の確認

以下のコマンドで、キュー・マネージャーTESTQMのMYLISTENER を停止します

[mqm@itz-3100008gyq-iwxo bin]$ ./runmqsc TESTQM
5724-H72 (C) Copyright IBM Corp. 1994, 2023.
Starting MQSC for queue manager TESTQM.

stop listener(MYLISTENER)
     1 : stop listener(MYLISTENER)
AMQ8706I: Request to stop IBM MQ Listener accepted.

新しく定義されたイベントで、 MYLISTENERの停止が検知されていることを確認します。

また、SYSTEM.DEFAULT.LISTENER.TCP の停止していても、デフォルト定義のイベントでアラートが上がらないことを確認します。