IBM App Connect Enterprise （ACE）センサーの設定

IBM ACE センサーを設定する前に、以下の手順を完了してください：

1. リソースとメッセージ・フロー統計の収集状態を確認し、有効にする。 ACE メトリクスは、リソースおよびメッセージ・フロー統計の収集をアクティブにしたときにのみ存在します。

   • リソース収集のステータスを確認するには、以下のコマンドを実行する：

     mqsireportresourcestats <integrationNode> -e <integrationServer>
      

     リソース収集の状態が非アクティブの場合は、以下のコマンドを実行してアクティブにする：

     mqsichangeresourcestats <integratorNode> -e <integrationServer> -c active
      

   • メッセージ・フロー統計の状態を確認するには、以下のコマンドを実行する：

     mqsireportflowstats <integratorNode>  -s -e <integrationServer>  -j
      

     メッセージフローの収集状態が非アクティブの場合、指定された統合サーバーおよびノード内のすべてのメッセージフローについてスナップショット統計情報の収集を有効にし、 JSON 形式でデータを送信します。

     • スレッド・データ・レベルを設定せずにスナップショット統計情報収集を有効にするには、以下のコマンドを実行します：

       mqsichangeflowstats <integrationNode> -s -e <integrationServer> -j -c active -o json
        

     • スレッドデータレベルを設定してスナップショット統計情報収集を有効にするには、以下のコマンドを実行します：

       mqsichangeflowstats <integrationNode> -s -e <integrationServer> -j -t basic -c active -o json
        

     • スレッド・データ・レベルとノード・データ・レベルの両方を設定してスナップショット統計情報収集を有効にするには、次のコマンドを実行します：

       mqsichangeflowstats <integrationNode> -s -e <integrationServer> -j -t basic -n basic -c active -o json
        

     注： 各メッセージフローのスレッド使用状況を確認するには、`mqsichangeflowstats` コマンドを使用する際、` -t basic` オプションを指定してスレッドデータを有効にする必要があります。 スナップショットとアーカイブの2種類のデータ収集をリクエストできます。 データ収集にはスナップショットタイプが望ましい。 詳細については、IIB または ACE のドキュメントにある該当するコマンドを参照してください。

2. お使いのACEがMQTTを使用しているか、 IBM MQ を使用しているかを確認してください。 以下のコマンドは、MQTTまたは IBM MQ のプロセスを検索し、運用イベントがACEセンサーに配信されているかどうかを確認します。

   • MQTTをチェックするには、以下のコマンドを実行する：

     ps -ef | awk '/bipMQTT/ && /<integrationNode>/'
     mqsireportproperties <integrationNode> -b Events -o OperationalEvents/MQTT -n enabled
      

     ACEセンサーのOperationalEventsパブリケーションの宛先としてMQTTを使用するには、以下の手順を実行します：

     • Instana エージェントを実行しているユーザーが、ACEのグループに所属していることを確認してください。

     • configuration.yamlファイルにMQTTポートを指定します。 詳細については、ACEの設定例を参照してください。

       注：configuration.yaml のパラメータ `` および acePassword: ‘<VIWER_USER_PASSWORD>’aceUsername: ‘<VIWER_USER>’ `` は、 Unix ソケットでは使用されません。

     • MQTTを有効にする。 詳細については、 IBM （ App Connect ）をご覧ください。

     • 公開されているイベントを確認するには、先のコマンドを使用する。

     以下のリクエスト例を使用して、MQTT側で接続がオープンされ、機能していることを確認する：

     • Unix ソケットを使用したリクエスト、レスポンス403：

       root@itm-0:~# curl --unix-socket /var/mqsi/INODE4.uds http://127.0.0.1:4417/apiv2/servers
       {"name":"servers","type":"integrationServers","uri":"/apiv2/servers","hasChildren":true,"children":[{"name":"IServer_2","hasChildren":true,"uri":"/apiv2/servers/IServer_2","type":"integrationServer","apiResponseCode":403}]}
        

     • ユーザー名でリクエスト、レスポンス403：

       root@itm-0:~# curl -u user1 --unix-socket /var/mqsi/INODE4.uds http://127.0.0.1:4417/apiv2/servers
       Enter host password for user 'user1':
       {"name":"servers","type":"integrationServers","uri":"/apiv2/servers","hasChildren":true,"children":[{"name":"IServer_2","hasChildren":true,"uri":"/apiv2/servers/IServer_2","type":"integrationServer","apiResponseCode":403}]}
        

     • Unix ソケットを削除し、user を提供して、200 レスポンスを返す：

       root@itm-0:~# curl -u user1 http://127.0.0.1:4417/apiv2/servers
       Enter host password for user 'user1':
       {"name":"servers","type":"integrationServers","uri":"/apiv2/servers","hasChildren":true,"children":[{"name":"IServer_2","hasChildren":true,"uri":"/apiv2/servers/IServer_2","type":"integrationServer","active":{"processId":26013,"isRunning":true,"state":"started"},"apiResponseCode":200}]}
        

     • ACEグループに "root "を追加した後、ユーザー名とパスワードを入力する必要はありません：

       root@itm-0:~# grep root /etc/group
       root:x:0:
       mqbrkrs:x:1001:mquser,mq,root
       root@itm-0:~# curl --unix-socket /var/mqsi/INODE4.uds http://127.0.0.1:4417/apiv2/servers
       {"name":"servers","type":"integrationServers","uri":"/apiv2/servers","hasChildren":true,"children":[{"name":"IServer_2","hasChildren":true,"uri":"/apiv2/servers/IServer_2","type":"integrationServer","active":{"processId":26013,"isRunning":true,"state":"started"},"apiResponseCode":200}]}
        

   • IBM MQ を確認するには、次のコマンドを実行してください：

     mqsilist | grep <integrationNode>  # check there is a default queue manager configured.
     mqsireportproperties <integrationNode> -b Events -o OperationalEvents/MQ -n enabled
      

     ACEで IBM MQ を使用するには、以下の手順を実行してください：

     1. 統合サーバー、メッセージ・フロー、およびフロー・ノードのパフォーマンス・メトリクス・データのフロー用にチャネルを設定するか、既存のチャネルを使用します。

     2. configuration.yaml ファイルで指定されたユーザー名かパスワードでチャンネルにアクセスできることを確認してください。

     3. configuration.yaml ファイルで、キューマネージャ名とリスニングポートを、チャネル名、ユーザ名、パスワードとともに指定します。 チャネルの設定に関する詳細については、 「CHLAUTH アクセスに関する問題の解決」 を参照してください。

3. 監視対象サーバーが独立した統合サーバーの場合は、以下の要件を満たしていることを確認する：

   • デフォルトでは無効になっているので、イベント・メッセージの公開を設定する。 ACEセンサーはOperationalEventsだけをモニターし、BusinessEventsはモニターしない。 詳細については、 「イベントメッセージの公開の設定」 を参照してください。
   • ACE 11.0.0.11 以降を使用してください。 そうしないと、.udsファイルが各サーバーに存在しないので、UNIXドメインソケットを使うことができません。

4. 従来のACE環境で自動検出機能を有効にするには、以下の要件が満たされていることを確認する：

   • IBM ACE センサーは、ファイル <agent_install_dir>/etc/instana/configuration.yaml 内で統合ノードやサーバーを設定しなくても有効になります。
   • エージェントを起動するユーザーには、ACE ワークパス（例： /var/mqsi/）へのアクセス権限が与えられています。
   • 関連する統合ノードでMQTTプロセスが正常に実行されている。 確認するには、ホスト上で コマンド ps -ef | grep -E 'bipMQTT.*<integrationNode>’ を実行してください。
   注： 自動検出機能を使用すると、すべての前提条件が満たされていない場合でも、 Instana UIのホストダッシュボードに一覧表示されている、実行中のすべての統合サーバーを確認できます。

5. IBM ACE 13 以降のバージョンでは、統合サーバーはデフォルトで、自己署名証明書を使用して HTTPS プロトコルで起動します。 Instana による監視をサポートするには、次のいずれかのオプションを選択してください：

   • 有効な証明書を含む適切なJKSキーストアを使用して、統合サーバーを起動します。 HTTPS を適切なキーストアとともに使用している場合は、エージェントの configuration.yaml ファイル内の および keystorePassword keystore パラメータを設定してください。
   • 統合サーバーのプロトコルを「 HTTPS 」から「 HTTP 」に変更してください。

従来のACE環境において、 Instana は、リモートおよびローカルの IBM ACE インスタンスの両方の監視をサポートしています。 エージェントのコンフィギュレーション<agent_install_dir>/etc/instana/configuration.yamlファイルでフィールドを設定する必要があります。 以下のコンフィギュレーションを使用できる：

• リモートモニタを使用する場合は、ホストの値としてターゲット ACE サーバの IP アドレスを設定します。

• ローカル・モニタリングを使用するには、host属性をコメントアウトする。 デフォルトではローカルモニタリングが使用される。

• 異なるホスト上の同じ名前のブローカーまたは統合サーバーを監視するには、ブローカーまたは統合サーバーのキーとしてbrokerName:xまたはintegrationServer:xを使用します。 例えば、BK1:1とBK:2です。

• 自動検出機能を使うには、NodesOrServers以下のフィールドを設定しないでください。 ACEセンサーの自動検出機能は、ホスト上で実行されているすべての統合サーバーを検出し、設定なしで自動的に監視を開始する。

これらのフィールドの値を取得する方法に関するヒントについては、「 ACEセンサー設定の役立つヒント 」ブログをご覧ください。

ACEの設定については、次のconfiguration.yamlファイルのサンプルを参照してください：

com.instana.plugin.ace:
  enabled: true
  poll_rate: 60
  forceRemote: false
  flowNodesExcludedRegex: ''
  messageFlow:
    limit: 0
    sortByMetric: 'MaximumElapsedTime'
  NodesOrServers:
    SampleNode/Server:
      host: '<ACE_SERVEr_HOST>'
      restApiPort: '<ACE_REST_API_PORT>'
      aceUsername: '<VIWER_USER>'
      acePassword: '<VIWER_USER_PASSWORD>'
      keystore: '<ACE_KEYSTORE_PATH>'
      keystorePassword: '<ACE_KEYSTORE_PASSWORD>'
      excludedServers: '<INTEGRATION_SERVER_NAMES>'
      flowNodesExcludedRegex: ''
      messageFlow:
        limit: 0
        sortByMetric: 'MaximumElapsedTime'
      availabilityZone: 'IBM ACE Custom Zone'
      mqHost: '<MQ_HOST>'
      mqport: '<MQ_LISTENING_PORT>'
      queuemanagerName: '<QMGR_NAME>'
      channel: '<SVRCONN_CHANNEL>'
      mqUsername: '<AUTHORIZED_USER>'
      mqPassword: '<USER_PASSWORD>'
      mqKeystore: '<MQ_KEYSTORE_PATH>'
      mqKeystorePassword: '<MQ_KEYSTORE_PASSWORD>'
      mqCipherSuite: '<MQ_CIPHER_SUITE>'