配置 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` 启用线程数据。 您可以申请两种类型的数据收集：快照和存档。 快照类型是数据收集的首选。 如需更多信息，请参阅 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
      

     要将 MQTT 用作 ACE 传感器中 OperationalEvents 发布的目标，请完成以下步骤：

     • 请确保运行 Instana 代理的用户属于ACE组。

     • 在 configuration.yaml 文件中指定 MQTT 端口。 有关详细信息，请参阅 ACE 配置示例。

       注意：configuration.yaml 中的参数 acePassword: ‘<VIWER_USER_PASSWORD>’ 和 不适用于 UnixaceUsername: ‘<VIWER_USER>’ Socket。

     • 启用 MQTT。 如需了解更多信息，请访问 IBMApp 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 接口并提供用户，响应 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}]}
        

     • 将 "root "添加到 ACE 组后，无需提供用户名和密码，响应 200：

       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 或更高版本。 否则，您就无法使用 UNIX 域套接字，因为每个服务器都不存在 .uds 文件。

4. 要在传统 ACE 环境中启用自动发现功能，请确保满足以下要求：

   • IBM ACE 传感器已在文件中启用，无需配置集成节点或服务器 <agent_install_dir>/etc/instana/configuration.yaml 。
   • 启动代理的用户具有访问 ACE 工作路径（例如）的权限 /var/mqsi/。
   • 相关集成节点的 MQTT 进程正在正常运行。 要进行检查，请在主机上运行该 ps -ef | grep -E 'bipMQTT.*<integrationNode>’ 命令。
   注意： 通过自动发现功能，即使未满足所有先决条件，您仍可在 Instana 用户界面的主机仪表盘上查看所有正在运行的集成服务器。

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 地址设置为主机值。

• 要使用本地监控，请注释掉主机属性。 默认使用本地监控。

• 要监控不同主机上具有相同名称的代理服务器或集成服务器，请使用 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>'