故障诊断

若要测试 IBM MQ 通道的连接性，您必须先配置 IBM MQ Explorer。 然后，您可以使用 configuration.yaml 文件中提供的凭据，在 IBM MQ Explorer中测试通道连接。

如果自动发现失败，您可能会在仪表板上收到警告消息。 这些警告消息的说明和解决方案如下所示:

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

  如果主机上运行的是 Windows 10操作系统，则会显示此消息。 Windows 10 操作系统不支持自动发现功能。 要解决此问题，您必须在 文件 <agent_install_dir>/etc/instana/configuration.yaml 中指定集成节点信息，以便继续通过 REST 接口 API 进行监控。

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

  当主机运行 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 路径为空时，将显示此消息。 要解决此问题，请遵循第一条消息中概述的相同解决方案。

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

  当 MQTT 进程被意外禁用或停止时，将显示此消息。 要解决此问题，请启用 MQTT 并启动此过程。 如果您不想启用此功能，请参阅第一条消息中概述的相同解决方案。

如果您无法通过 Instana 用户界面获取指标，而是从代理日志中收到错误代码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
  

• ACE 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. 在 trueIBM ACE 传感器对应的文件 <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以来，针对流节点度量引入了设计更改。 将除去流节点仪表板页面，并且将显示所有流节点度量值以及可展开的表。 对于自托管环境，需要选择下列其中一个解决方案以再次查看流节点度量值:

• 将自托管版本升级到 release-217。 通过此方案，您可以使用 Instana 的所有新功能。
• 如果不想升级后端以使用旧代理程序的功能，那么可以将代理程序锁定到 V 1.1.620。 如需了解更多信息，请参阅版本固定。

如果您在 Instana 用户界面中无法查看 Windows 代理的指标，而代理用户界面上却显示 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 用户界面中无法看到ACE跟踪调用，或者跟踪调用未按预期显示，请执行以下步骤：

1. 启用 Instana ACE 跟踪的调试功能。

   • 对于传统的 ACE 环境，请在命令行中 LOG_LEVEL="debug" 设置环境变量，例如 export LOG_LEVEL=debug 。

     然后，在同一条命令行中，运行 和 mqsistart mqsistop 命令以重启 IBM ACE 实例。

   • 对于位于 IBM Cloud Pak for Integration 中的容器 ACE，请将环境变量设置 LOG_LEVEL 为 debug 与 IBM ACE 实例相同的值。

     • 有关 ACE（ 11.x ），请参阅 《 Red Hat OpenShift 》中的“管理集成服务器环境变量”。
     • 有关 ACE（ 12.x ），请参阅 App Connect Integration Server 参考文档 - 自定义资源值 - spec.env。

2. 重新启动集成服务器，并收集 /tmp/trace 目录中的所有文件以及 /tmp/ 目录中的文件 (例如 MqsiTransportUserExitBase.debug.*.log)。

3. 在 Instana 用户界面中收集跟踪调用的屏幕截图。

4. 请将调试文件和屏幕截图发送给 Instana 支持团队。