トラブルシューティング

IBM MQ チャンネルの接続を確認するには、まず IBM MQ Explorerを設定する必要があります。 その後、ファイル configuration.yaml に記載されている認証情報を使用して、 IBM MQ Explorerでチャネルの接続性をテストできます。

自動ディスカバリーが失敗すると、ダッシュボードに警告メッセージが表示される場合があります。 これらの警告メッセージの説明と解決策は、以下のとおりです。

• Auto-discovery: The OS Windows 10 is not supported for automatic discovery.

  ホストで Windows 10が実行されている場合、このメッセージが表示されます。 OS「 Windows 10」は、自動検出に対応していません。 この問題を解決するには、rest API での監視を継続するために、ファイル <agent_install_dir>/etc/instana/configuration.yaml に統合ノード情報を指定する必要があります。

• Auto-discovery: The OS Windows 10 or the ACE/IIB v10 is not supported for automatic discovery currently.

  このメッセージは、ホストでOS Windows 10 または IBM Integration Bus (IIB) 10 が実行されている場合に表示されます。 どちらもサポートされていません。 この問題を解決するには、前のメッセージで概説されているものと同じ解決策に従ってください。

• Auto-discovery: Unix Domain Socket is unable to access as the mqsi work path is null.

  このメッセージは、 IBM ACE センサーが WebSphere Message Broker のワークパスを取得できなかった場合、または WebSphere Message Broker のパスがnullの場合に表示されます。 この問題を解決するには、最初のメッセージで概説されているのと同じ解決策に従ってください。

• Auto-discovery: MQTT is disabled. You can enable MQTT or specify MQ information in the configuration.yaml file.

  このメッセージは、MQTT プロセスが予期せずに使用不可または停止した場合に表示されます。 この問題を解決するには、MQTT を有効にしてプロセスを開始します。 有効にしない場合は、最初のメッセージで概説されているのと同じ解決策を参照してください。

Instana のUIからメトリクスを取得できず、代わりにエージェントのログにエラーコード2058が表示される場合は、設定ファイル内の IBM MQ に関するすべての情報が正しいことを確認してください。 詳細情報を表示するには、以下の ps -ef | grep runmqlsr | grep '<QUEUEMGR NAME>' | grep '<LISTENER_PORT>' コマンドを実行してください。 リスナーに -iで指定された IP がある場合は、制限を削除するか、ACE 用に新規リスナーをセットアップする必要があります。

正しい設定の以下のサンプル出力を参照してください。

root@upstairs1:~# ps -ef | grep "runmqlsr" | grep QM1 | grep  1414
mqm       9956  9872  0 Aug30 ?        00:00:05 /opt/mqm/bin/runmqlsr -r -m QM1 -t TCP -p 1414

設定が正しくない以下のサンプル出力を参照してください。

root@upstairs1:~# ps -ef | grep "runmqlsr" | grep QM1 | grep  1417
mqm       9957 9872  0 Aug30 ?        00:00:06 /opt/mqm/bin/runmqlsr -r -m QM1 -t TCP -p 1417 -i 10.17.59.113

現在の統合ノードが使用している REST API ポートを取得するには、次のコマンドを実行してください：

• HTTP プロトコルが使用されている場合は、以下のコマンドを使用してポートを取得します。

  mqsireportproperties integrationNode -b webadmin -o HTTPConnector -a | grep port
  

• HTTPS プロトコルが使用されている場合は、以下のコマンドを使用してポートを取得します。

  mqsireportproperties integrationNode  -b webadmin -o HTTPSConnector -a | grep port
  

さらなる調査のために、 JSON 形式のペイロードを取得したい場合は、以下のコマンドを使用できます：

• IIB 10 の場合:

  curl -u <USERNAME> --header "Accept: application/json" "http://<ACE_HOST>:<INTEGTATION_NODE_API_PORT>/apiv1?depth=6" >> payload.json
  

• エース 11

  curl -u <USERNAME> --header "Accept: application/json" "http://<ACE_HOST>:<INTEGTATION_NODE_API_PORT>/apiv2?depth=6" >> payload.json
  

Instana エージェントが DataFlowEngine 、 JVM のラッパーであるプロセスを正しくアタッチできない場合、このメッセージが表示されます。

• IIB 10 を使用している場合は、以下の手順でこの警告を除去できます。

  1. 以下のように、 <agent_install_dir>/etc/instana/configuration.yaml ファイルでこのプロセスを無視します。

      com.instana.ignore:
        processes:
          - 'DataFlowEngine'
     

     詳細については、 「プロセスの無視」 を参照してください。

  2. IBM ACEtrue<agent_install_dir>/etc/instana/configuration.yaml センサーのファイル内のフィールドを forceRemote に設定してください。

• IBM ACE 11 または 12 をお使いの場合は、前述の手順に従ってこのプロセスを無視するか、以下の手順を実行して警告を解消することができます

  1. 環境 JAVA_HOME 変数を設定し、次のコマンドを実行して、ACEに同梱されているJREを指定してください：

     export JAVA_HOME= <PATH to your ACE Bundled JRE>
     

     以下の例を参照してください。

     export JAVA_HOME=/opt/ace-11.0.0.11/common/jdk/jre
     

  2. ACE ブローカーを停止して、開始します (mqsistop/mqsistart)。

release-217以降、フロー・ノード・メトリックの設計変更が導入されました。 フロー・ノード・ダッシュボード・ページが削除され、すべてのフロー・ノード・メトリックが展開可能な表とともに表示されます。 自己ホスト型環境の場合、フロー・ノード・メトリックを再度表示するには、以下のいずれかのソリューションを選択する必要があります。

• セルフホステッド・バージョンを リリース-217にアップグレードします。 このソリューションを利用すれば、 Instana のすべての新機能をご利用いただけます。
• 古いエージェントの機能を使用するようにバックエンドをアップグレードしない場合は、エージェントをバージョン 1.1.620にピン留めできます。 詳細については、 「バージョンの固定」 を参照してください。

Instana のUIに Windows エージェントのメトリクスが表示されず、代わりにエージェントのUIに Create WMQ connection for ACE sensor failed エラーメッセージが表示される場合は、 IBM MQ のセキュリティ機能が無効になっていることを確認してください。 IBM MQ セキュリティーを無効にした後でもエラー・メッセージが表示される場合は、IBM MQ ユーザーが Windows ユーザー・グループに追加されているmqmかどうかを確認してください。

Instana のACEトレースが有効になっているかどうかを確認するには、以下の手順に従ってください：

1. 統合サーバーの stdout ファイル ( /var/mqsi/components/BK1/servers/EG1/stdoutなど) を確認します。 Instana のACEトレースが正常に有効化されると、次のようなメッセージが表示されます：

   Load Tracing Agent in shared mode, 0x7f322822bbbe, (nil)
   /var/mqsi/shared-classes/tracelibrary.so
   Found agent library!
   

2. /tmp/trace ディレクトリーが生成されているかどうかを確認します。 Instana のACEトレースが正常に有効化されると、ユーザー・エクジットによって、例えば aceExit.13312.log/tmp/trace ディレクトリ内にログファイルが作成されます。 この番号 13312 は、 DataFlowEngine またはIntegration ServerのプロセスIDです。 以下の例を参照してください。

   [root@hastened1 trace]# ps -ef | grep 13312
   root     13312 13260 13 18:37 ?        00:00:29 DataFlowEngine v12_BK1 00000000-0000-0000-0000-000000000000 BK1-EG1
   

3. Instana のACEトレースが有効にならない場合は、システムログ /var/log/message、統合ノードの stdout および stderr ファイル、ならびに統合サーバーの stdout および stderr ファイルを収集してください。 すべてのファイルを Instana のサポートチームまでお送りください。

Instana のUIにACEトレースの呼び出しが表示されない場合、またはトレースの呼び出しが期待どおりに表示されない場合は、以下の手順を実行してください：

1. Instana のACEトレースのデバッグを有効にします。

   • 従来のACE環境では、コマンドラインで LOG_LEVEL="debug" 環境変数を設定します。例えば、 のように export LOG_LEVEL=debug 。

     次に、同じコマンドラインで および mqsistart mqsistop コマンドを実行し、 IBM ACE インスタンスを再起動します。

   • IBM Cloud Pak for Integration のコンテナ ACE については、 IBM ACE インスタンス debug と同様に LOG_LEVEL 環境変数を設定してください。

     • ACE（ 11.x ）については、 『 Red Hat OpenShift 』の「統合サーバーの環境変数の管理」 を参照してください。
     • ACE（ 12.x ）については、 App Connect を参照してください。Integration Server リファレンス - カスタムリソース値 - spec.env。

2. 統合サーバーを再始動し、 /tmp/trace ディレクトリー内のすべてのファイルと、 /tmp/ ディレクトリー内の MqsiTransportUserExitBase.debug.*.logなどのファイルを収集します。

3. Instana のUIで、トレース対象のコールのスクリーンショットを収集します。

4. デバッグファイルとスクリーンショットを Instana のサポートチームまでお送りください。