对消息流关闭 OpenTelemetry

您可以使用 IBM® App Connect Enterprise 管理 REST API 来关闭单个消息流的 OpenTelemetry 数据的记录。

关于此任务

IBM App Connect Enterprise 支持 OpenTelemetry 跟踪 Linux® x86-64 上的集成服务器、Linux zSeries、Linux on POWER® Systems - Little Endian、AIX® 和 Windows 平台。如果在集成服务器上启用了 OpenTelemetry 跟踪（通过在 server.conf.yaml 文件中设置属性），则服务器上的所有报文流都将启用跟踪。如果要关闭个别消息流的数据记录，那么可以通过在管理 REST API 中设置属性来执行此操作。

为消息流收集 OpenTelemetry 数据时，附加信息将作为消息属性添加到由 MQOutput 和 MQPublication 节点生成的 MQ 消息的 RFH2 头中，并由 HTTP、REST 和 SOAP 请求节点作为 HTTP 头属性添加。如果这些节点的数据消费者不需要这些附加数据，则可以通过将管理REST API中的 openTelemetryEnabled 属性设置为 false ，来关闭特定消息流的 OpenTelemetry 数据收集。

例如，要对应用程序 App1中的消息流 Flow1 关闭 OpenTelemetry 数据收集，请运行以下 curl 命令以向管理 REST API 发出请求:


curl -X PATCH --header 'content-type: application/json'  \
      --data "{ \"properties\": { \"openTelemetryEnabled\": \"false\" } }" \
      localhost:7600/apiv2/applications/App1/messageflows/Flow1

您还可以通过将应用程序上的 openTelemetryEnabled 属性设置为 false来关闭应用程序中所有消息流的 OpenTelemetry 数据收集。

要对已关闭遥测数据收集的消息流重新启用 OpenTelemetry ，请将 openTelemetryEnabled 属性的值设置为 inherit。

在集成服务器或应用程序上关闭 OpenTelemetry 数据收集后，无法在单个消息流上启用 OpenTelemetry 。

您可以使用下列其中一种方法来检查对集成服务器处于活动状态的 OpenTelemetry 设置:

使用管理 REST API 针对独立集成服务器在 /apiv2/resource-managers/opentelemetry-manager 上发出 GET 。
在受管集成服务器上使用对象名 opentelemetry-manager 运行 mqsireportproperties 命令。

有关使用 OpenTelemetry, 请参阅为集成服务器配置 OpenTelemetry 跟踪和 OpenTelemetry 注意事项和限制。