仮想マシンまたは物理マシンでの IBM MQ の監視設定

オンラインで編集する

お使いの環境における Instana エージェントおよびキューマネージャーの導入状況に応じて、 IBM MQ センサーを設定してください。

展開ベースの設定シナリオ

オンラインで編集する

Instana のホストエージェントと IBM MQ が同じマシン上で実行される場合、次の接続モードがサポートされています：ローカルバインディングモードとクライアントバインディングモード。 Instana のホストエージェントと IBM MQ が別々のマシンで実行されている場合、クライアントバインディングモードのみがサポートされます。

次の表は、さまざまなエージェント・キュー・マネージャーの導入シナリオにおける構成を示しています：

エージェント・キュー・マネージャーのデプロイ ユーザー・タイプ 監視方法 構成要件
同じ仮想マシンまたは物理マシン内 特権ユーザー ローカルバインディングモードによるローカル監視 設定は不要（自動監視）
同じ仮想マシンまたは物理マシン内 一般ユーザー クライアントバインディングモードでのローカル監視 以下の場所で手動設定が必要です configuration.yaml
どちらも同じ Linux マシン上にある 特権を持たないユーザーおよびroot以外のユーザー クライアントバインディングモードでのローカル監視 以下の場所で手動設定が必要です configuration.yaml
異なる環境（ VM、 Docker、または Kubernetes ）において クライアントバインディングモードによるリモート監視 以下の場所で手動設定が必要です configuration.yaml

ローカルバインディングモードを使用したローカル監視の設定

オンラインで編集する

Instana エージェントのユーザーアカウントに権限がある場合、 IBM MQ センサーはローカルバインディングモードを使用して、 IBM MQ からデータを取得します。

ローカルバインディングモードを使用することで、 IBM MQ センサーは IBM MQ キューマネージャのインスタンスを自動的に検出し、すべてのデータを表示することができます。 Instana のエージェント設定ファイルを設定する必要はありません。

クライアントバインディングモードでのローカル監視の設定

オンラインで編集する

Instana エージェントのユーザーアカウントに権限がない場合、 IBM MQ センサーは、 IBM MQ からデータを取得するためにクライアントバインディングモードを使用する必要があります。 エージェントの設定ファイルで、 IBM MQ の接続パラメータを設定する必要があります。

IBM MQ の接続パラメータを設定するには、以下の手順を実行してください：

  1. エージェントの設定ファイル内のプラグインセクション ibmmq を次のように設定します：

    com.instana.plugin.ibmmq:
  enabled: true
  poll_rate: 60
  queueManagers:
    QMGR03:    # Your Queue Manager name here. If there are queue managers with the same name, it is required to append '-<instance>' in the queue manager name to distinguish them. You can select any string for <instance>.
      channel: '<INSERT_CHANNEL_HERE>' # Remote administration channel

  2. IBM MQ の設定に基づいて、その他の権限を設定してください。 IBM MQ のセキュリティ機能が有効になっている場合は、ユーザー名とパスワードを設定してください。 IBM MQ の TLS が有効になっている場合は、エージェントの設定ファイルにキーストアに関する情報を指定してください。 次の構成例を参照してください。

    注： キーストアの証明書ファイルについては、ファイル jks 形式のみがサポートされています。
    com.instana.plugin.ibmmq:
  enabled: true
  poll_rate: 60
  queueManagers:
    QMGR03:    # Your Queue Manager name here. If there are queue managers with the same name, it is required to append '-<instance>' in the queue manager name to distinguish them. You can select any string for <instance>.
      channel: '<INSERT_CHANNEL_HERE>' # Remote administration channel
      username: '<INSERT_USERNAME_HERE>' # User ID to connect to MQ (optional)
      password: '<INSERT_PASSWORD_HERE>' # User password to connect to MQ (optional)
      keystore: '<INSERT_KEYSTORE_PATH_HERE>' # Keystore path for TLS connection (required only when TLS is enabled for remote monitoring. Optional)
      keystorePassword: '<INSERT_KEYSTORE_PASSWORD_HERE>' # Keystore password for TLS connection (required only when TLS is enabled for remote monitoring. Optional)
      cipherSuite: '<INSERT_CIPHER_SUITE_HERE>' # TLS cipher suite for TLS connection (required only when TLS is enabled for remote monitoring. Optional)

    クライアントバインディングモードを使用することで、 IBM MQ センサーは、ローカル監視においてホストやポートなどの一部の設定を自動的に検出でき、 Instana のUIにメトリクスを表示することができます。

  3. Linux における非特権ユーザーおよび非rootユーザーの場合： エージェント設定ファイルで フラグ enableStatisticsQueueMetrics を設定し、 IBM MQ センサーがキューの統計データを取得できるようにします。 「キュー統計の設定」 を参照してください。

    Linux で非root ユーザーとして Instana エージェントを実行する方法に関する詳細については、 「非root ユーザーとしてエージェントを実行する」 を参照してください。

キュー統計の設定

キューの統計情報を設定するには、以下の手順を実行してください：

  1. キュー統計情報の有効化：すべてのキューのパフォーマンス指標（メッセージレートなど）の収集を有効にするには、ユーザー mqm は以下の手順を実行する必要があります：

    1. 次のコマンドを実行して、キューマネージャーレベルで統計機能を有効にします。 このコマンドは、属性 STATQ が（デフォルト QMGR 値）に設定されているすべてのキューのマスタースイッチとして機能します。

      ALTER QMGR STATQ(ON)

    2. b. 次のコマンドを実行して、収集間隔（必須）を設定してください。 リアルタイムで正確な統計情報を得るためには、 poll_rate この STATINT 値がエージェントと一致している必要があります。 が より大きい STATINTpoll_rate 場合、統計情報はリアルタイムではありません。

      ALTER QMGR STATINT(60)
      重要： ユーザー mqm は必要なすべての権限を付与する必要があります。{: important)
  2. エージェントの設定：エージェントの configuration.yaml ファイル（*instanaAgentDir*/etc/instana/configuration.yaml）に enableStatisticsQueueMetrics パラメータを追加します：
    com.instana.plugin.ibmmq:
  enabled: true
  poll_rate: 60
  enableStatisticsQueueMetrics: false # Default is false. If false, uses RESET PCF command (requires mqm privileges). If true (Linux only), uses STATS mode from statistics queue (STATINT must match POLL_RATE for accuracy).

    これらの設定が完了すると、 Instana エージェントは、root権限や mqm グループへのアクセス権を必要とすることなく、統計キューからメッセージを処理することで、キューの統計メトリクスを正常に収集します。

    が に設定 enableStatisticsQueueMetrics されると true、 IBM MQ センサーはSTATSモードを有効にし、キューのスループット統計情報を収集します。 （統計 STATINT 間隔）が、その poll_rate 値に合わせて設定されていることを確認してください。 を false (デフォルト) に設定すると、センサーは コマンド RESET PCF 方式を使用して統計情報を収集します。これには 権限 mqm が必要です。

クライアントバインディングモードでのリモート監視の設定

オンラインで編集する

リモートモニタリングにおいて、 IBM MQ センサーはクライアントバインディングモードを使用して、 IBM MQ からデータを取得し、表示します。 エージェントの設定ファイルで、 IBM MQ の接続パラメータを設定する必要があります。 設定手順は、「クライアントバインディングモードを使用したローカル監視」 のセクションと同じです。

リモート監視でクライアントバインディングモードを使用する場合、 IBM MQ センサーではホストとポートを自動検出できないため、これらを設定する必要があります。 これらの指標は、 Instana のUIにも表示されます。