1.3. Red Hat OpenShift distributed tracing Platform 2.9.1 发行注记

1.3.1. 分布式追踪概述

作为服务所有者，您可以使用分布式追踪来检测您的服务，以收集与服务架构相关的信息。您可以使用 Red Hat OpenShift distributed tracing 平台来监控、网络性能分析，并对现代、云原生的微服务应用程序中组件间的交互进行故障排除。

使用分布式追踪平台，您可以执行以下功能：

监控分布式事务
优化性能和延迟时间
执行根原因分析

分布式追踪平台由三个组件组成：

Red Hat OpenShift distributed tracing Platform (Jaeger)，它基于开源 Jaeger 项目。
Red Hat OpenShift distributed tracing Platform (Tempo)，它基于开源 Grafana Tempo 项目。
红帽构建的 OpenTelemetry，它基于开源 OpenTelemetry 项目。

1.3.2. Red Hat OpenShift distributed tracing Platform 2.9.1 中的组件版本

Operator	组件	Version
Red Hat OpenShift distributed tracing Platform (Jaeger)	Jaeger	1.47.0
Red Hat build of OpenTelemetry	OpenTelemetry	0.81.0
Red Hat OpenShift distributed tracing Platform (Tempo)	Tempo	2.1.1

1.3.3. CVE

此发行版本修复了 CVE-2023-44487。

1.3.4. Red Hat OpenShift distributed tracing Platform (Jaeger)

1.3.4.1. 已知问题

不支持 Apache spark。
IBM Z 和 IBM Power Systems 上不支持通过 AMQ/Kafka 进行流部署。

1.3.5. Red Hat OpenShift distributed tracing Platform (Tempo)

重要

Red Hat OpenShift distributed tracing Platform (Tempo)只是一个技术预览功能。技术预览功能不受红帽产品服务等级协议（SLA）支持，且功能可能并不完整。红帽不推荐在生产环境中使用它们。这些技术预览功能可以使用户提早试用新的功能，并有机会在开发阶段提供反馈意见。

有关红帽技术预览功能支持范围的更多信息，请参阅技术预览功能支持范围。

1.3.5.1. 已知问题

目前，没有为连接对象存储而实施自定义 TLS CA 选项。(TRACING-3462)
目前，当与 Tempo Operator 一起使用时，Jaeger UI 只显示在最后 15 分钟内发送了 trace 的服务。对于没有在最后 15 分钟内发送 trace 的服务，trace 仍然会被存储，但不会在 Jaeger UI 中显示。(TRACING-3139)
目前，分布式追踪平台(Tempo)在 IBM Z (s390x)架构中会失败。(TRACING-3545)
目前，在未部署网关时，Tempo 查询前端服务不得使用内部 mTLS。这个问题不会影响 Jaeger Query API。解决办法是禁用 mTLS。(TRACING-3510)
临时解决方案
禁用 mTLS，如下所示：
1. 运行以下命令，打开 Tempo Operator ConfigMap 进行编辑：
```
$ oc edit configmap tempo-operator-manager-config -n openshift-tempo-operator 1
```
  1
  安装 Tempo Operator 的项目。
2. 通过更新 YAML 文件来禁用 Operator 配置中的 mTLS：
```
data:
  controller_manager_config.yaml: |
    featureGates:
      httpEncryption: false
      grpcEncryption: false
      builtInCertManagement:
        enabled: false
```
3. 运行以下命令来重启 Tempo Operator pod：
```
$ oc rollout restart deployment.apps/tempo-operator-controller -n openshift-tempo-operator
```

缺少在受限环境中运行 Tempo Operator 的镜像。Red Hat OpenShift distributed tracing Platform (Tempo) CSV 缺少对操作对象镜像的引用。(TRACING-3523)

临时解决方案

在镜像工具中添加 Tempo Operator 相关镜像，将镜像复制到 registry：

kind: ImageSetConfiguration
apiVersion: mirror.openshift.io/v1alpha2
archiveSize: 20
storageConfig:
  local:
    path: /home/user/images
mirror:
  operators:
  - catalog: registry.redhat.io/redhat/redhat-operator-index:v4.13
    packages:
    - name: tempo-product
      channels:
      - name: stable
  additionalImages:
  - name: registry.redhat.io/rhosdt/tempo-rhel8@sha256:e4295f837066efb05bcc5897f31eb2bdbd81684a8c59d6f9498dd3590c62c12a
  - name: registry.redhat.io/rhosdt/tempo-gateway-rhel8@sha256:b62f5cedfeb5907b638f14ca6aaeea50f41642980a8a6f87b7061e88d90fac23
  - name: registry.redhat.io/rhosdt/tempo-gateway-opa-rhel8@sha256:8cd134deca47d6817b26566e272e6c3f75367653d589f5c90855c59b2fab01e9
  - name: registry.redhat.io/rhosdt/tempo-query-rhel8@sha256:0da43034f440b8258a48a0697ba643b5643d48b615cdb882ac7f4f1f80aad08e

1.3.6. Red Hat build of OpenTelemetry

重要

红帽构建的 OpenTelemetry 只是一个技术预览功能。技术预览功能不受红帽产品服务等级协议（SLA）支持，且功能可能并不完整。红帽不推荐在生产环境中使用它们。这些技术预览功能可以使用户提早试用新的功能，并有机会在开发阶段提供反馈意见。

有关红帽技术预览功能支持范围的更多信息，请参阅技术预览功能支持范围。

1.3.6.1. 已知问题

目前，您必须手动将 operator 成熟度设置为 Level IV, Deep Insights。(TRACING-3431)

1.3.7. 获取支持

如果您在执行本文档所述的某个流程或 OpenShift Container Platform 时遇到问题，请访问红帽客户门户网站。通过红帽客户门户网站：

搜索或者浏览红帽知识库，了解与红帽产品相关的文章和解决方案。
提交问题单给红帽支持。
访问其他产品文档。

要识别集群中的问题，您可以在 OpenShift Cluster Manager Hybrid Cloud Console 中使用 Insights。Insights 提供了问题的详细信息，并在有可用的情况下，提供了如何解决问题的信息。

如果您对本文档有任何改进建议，或发现了任何错误，请为相关文档组件提交 JIRA 问题。请提供具体详情，如章节名称和 OpenShift Container Platform 版本。

1.3.8. 使开源包含更多

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。我们从这四个术语开始：master、slave、黑名单和白名单。由于此项工作十分艰巨，这些更改将在即将推出的几个发行版本中逐步实施。详情请查看 CTO Chris Wright 的信息。