OpenTelemetryによるIBM MQ Applianceのモニタリング

IBM MQ Appliance IBM MQ がプリインストールされ、すぐに使用できる状態のハードウェア製品です。 Instana OpenTelemetry データコレクターを使用して、 IBM MQ Appliance ホストを監視します。

Java SDK 11 以降がインストールされていることを確認してください。

Java SDKのバージョンを確認するには:

java -version

OpenTelemetry IBM MQ Applianceデータコレクタをセットアップするには、以下の手順を 実行します:

  1. 「 OpenTelemetry データコレクタドライバ(ODCD)」の最新版を、 OpenTelemetry データコレクタドライバのリリースページからダウンロードしてください
    図 1. 新しいタブまたはウィンドウで開きます
    外部リンク・アイコン
    .
  2. パッケージを配置場所に展開する。

    tar vxf otel-dc-host-0.2.3.tar
    cd otel-dc-host-0.2.3
    
  3. 解凍したフォルダの中で、以下の設定ファイルがあなたの環境に合わせて更新されていることを確認してください:

    • config/config.yaml
    • config/logging.properties
  4. IBM MQ Applianceの構成ファイル「config/config.yaml」を更新します。 デフォルトの設定ファイルは'config/config.yamlである。

  5. 以下のステップのいずれかを実行します。

    • config/config-mqappliance.yamlファイルを'config/config.yamlにコピーする。

    • 環境変数'DC_CONFIGを使って設定ファイルを指定する:

      export DC_CONFIG=config/config-mqappliance.yaml
      

サンプル構成ファイル

アーカイブ内で共有されている設定ファイルのサンプルです。これを使用すると、 Instana 上の IBM MQ Appliance のメトリクスを監視できます。以下のスニペットを参照してください:

host.system: mq_appliance
instances:
  - appliance.host: testbox1.mqappliance.com
    appliance.user: admin
    appliance.password: xxxxxxxx
    #Data collector properties:
    poll.interval: 10
    callback.interval: 5
    otel.backend.url: http://127.0.0.1:4317
    #otel.backend.using.http: true

現在のシステムに合わせて、以下のコマンドで Data Collector を実行します:

nohup ./bin/otel-dc-host

以下のパラメータは、ホストデータコレクタの構成ファイルで使用されます。

パラメーター 範囲 説明 サンプル値
appliance.host mq_appliance IBM MQ Applianceのホスト名 testbox1.mqappliance.com
appliance.user mq_appliance IBM MQ Applianceのユーザー名 管理者
appliance.password mq_appliance IBM MQ Applianceのパスワード password1

Instana のUIでメトリクスを表示するには、 「Infrastructure」 をクリックします。 IBM MQ Appliance 「 OTEL Host 」と表示されます。 「 IBM 」の「 MQ Appliance 」を選択し、 「ダッシュボードを開く 」をクリックします。

図 2. OpenTelemetry メトリック
OpenTelemetryエンティティ