服务网格故障排除 - 服务网格 2.x | 服务网格 | OpenShift Dedicated

了解服务网格版本
Operator 安装故障排除
- 验证 Operator 安装
- 服务网格 Operator 故障排除
控制平面故障排除
- 验证服务网格控制平面安装
- 服务网格控制平面故障排除
数据平面故障排除
- sidecar 注射故障排除
- Envoy 代理故障排除
获取支持

本节介绍如何在 Red Hat OpenShift 服务网格中识别和解决常见问题。使用以下部分来帮助您在 OpenShift Dedicated 上部署 Red Hat OpenShift 服务网格时排除问题和调试问题。

了解服务网格版本

为了了解您在系统上部署了哪个版本的 Red Hat OpenShift 服务网格，您需要了解每个组件版本的管理方式。

Operator 版本 - 最新 Operator 版本为 2.6.4。 Operator 版本号仅指示当前安装的 Operator 的版本。因为 Red Hat OpenShift 服务网格 Operator 支持多个版本的 Service Mesh 控制平面，所以 Operator 的版本并不决定已部署的 ServiceMeshControlPlane 资源的版本。

升级到最新的 Operator 版本会自动应用补丁更新，但不会自动将您的服务网格控制平面升级到最新的次要版本。
ServiceMeshControlPlane 版本 - ServiceMeshControlPlane 版本决定您使用的 Red Hat OpenShift 服务网格版本。ServiceMeshControlPlane 资源中 spec.version 字段的值控制用于安装和部署 Red Hat OpenShift 服务网格的架构和配置设置。创建服务网格控制平面时，您可以通过两种方式之一设置版本
- 要在表单视图中配置，请从控制平面版本菜单中选择版本。
- 要在 YAML 视图中配置，请在 YAML 文件中设置spec.version的值。

Operator 生命周期管理器 (OLM) 不管理服务网格控制平面的升级，因此您的 Operator 和 ServiceMeshControlPlane (SMCP) 的版本号可能不匹配，除非您手动升级了您的 SMCP。

Operator 安装故障排除

验证 Operator 安装

安装 Red Hat OpenShift 服务网格 Operator 时，OpenShift 会自动创建以下对象作为成功安装 Operator 的一部分

配置映射
自定义资源定义
部署
Pod
副本集
角色
角色绑定
密钥
服务账户
服务

从 OpenShift Dedicated 控制台

您可以使用 OpenShift Dedicated 控制台验证 Operator Pod 是否可用并正在运行。

导航到工作负载→Pod。
选择openshift-operators命名空间。
验证以下 Pod 是否存在且状态为running
- istio-operator
- jaeger-operator
- kiali-operator
选择openshift-operators-redhat命名空间。
验证elasticsearch-operator Pod 是否存在且状态为running。

从命令行

使用以下命令验证 Operator Pod 是否在openshift-operators命名空间中可用并正在运行

$ oc get pods -n openshift-operators

示例输出

NAME                               READY   STATUS    RESTARTS   AGE
istio-operator-bb49787db-zgr87     1/1     Running   0          15s
jaeger-operator-7d5c4f57d8-9xphf   1/1     Running   0          2m42s
kiali-operator-f9c8d84f4-7xh2v     1/1     Running   0          64s

使用以下命令验证 Elasticsearch Operator

$ oc get pods -n openshift-operators-redhat

示例输出

NAME                                      READY   STATUS    RESTARTS   AGE
elasticsearch-operator-d4f59b968-796vq     1/1     Running   0          15s

服务网格 Operator 故障排除

如果遇到 Operator 问题

验证您的 Operator 订阅状态。
验证您安装的是受支持的 Red Hat 版本，而不是社区版本 Operator。
验证您是否具有安装 Red Hat OpenShift Service Mesh 的 `cluster-admin` 角色。
如果问题与 Operator 安装相关，请检查 Operator Pod 日志中的任何错误。

您只能通过 OpenShift 控制台安装 Operator，无法通过命令行访问 OperatorHub。

查看 Operator Pod 日志

您可以使用 `oc logs` 命令查看 Operator 日志。Red Hat 可能会请求日志来帮助解决支持案例。

步骤

要查看 Operator Pod 日志，请输入以下命令：

$ oc logs -n openshift-operators <podName>

例如：

$ oc logs -n openshift-operators istio-operator-bb49787db-zgr87

控制平面的故障排除

服务网格控制平面由 Istiod 组成，它将几个以前的控制平面组件（Citadel、Galley、Pilot）合并到单个二进制文件中。部署 `ServiceMeshControlPlane` 还会创建构成 Red Hat OpenShift Service Mesh 的其他组件，如架构主题中所述。

验证服务网格控制平面安装

创建服务网格控制平面时，服务网格 Operator 使用您在 `ServiceMeshControlPlane` 资源文件中指定的参数执行以下操作：

创建 Istio 组件并部署以下 Pod：
- istiod
- istio-ingressgateway
- istio-egressgateway
- grafana
- prometheus
调用 Kiali Operator 根据 SMCP 或 Kiali 自定义资源中的配置创建 Kaili 部署。

您可以在 Kiali Operator 下查看 Kiali 组件，而不是在服务网格 Operator 下。

调用 Red Hat OpenShift 分布式追踪平台 (Jaeger) Operator 根据 SMCP 或 Jaeger 自定义资源中的配置创建分布式追踪平台 (Jaeger) 组件。

您可以在 Red Hat OpenShift 分布式追踪平台 (Jaeger) Operator 和 Red Hat Elasticsearch Operator 下查看 Jaeger 组件和 Elasticsearch 组件，而不是在服务网格 Operator 下。

从 OpenShift Dedicated 控制台

您可以在 OpenShift Dedicated Web 控制台中验证服务网格控制平面安装。

导航到 **Operators** → **已安装的 Operators**。
选择 `istio-system` 命名空间。
选择 Red Hat OpenShift Service Mesh Operator。
1. 单击 **Istio Service Mesh Control Plane** 选项卡。
2. 单击控制平面的名称，例如 `basic`。
3. 要查看部署创建的资源，请单击 **Resources** 选项卡。您可以使用过滤器缩小视图范围，例如，检查所有 **Pods** 的状态是否为 `running`。
4. 如果 SMCP 状态指示任何问题，请检查 YAML 文件中的 `status:` 输出以获取更多信息。
返回 **Operators** → **已安装的 Operators**。
选择 OpenShift Elasticsearch Operator。
1. 单击 **Elasticsearch** 选项卡。
2. 单击部署的名称，例如 `elasticsearch`。
3. 要查看部署创建的资源，请单击 **Resources** 选项卡。
4. 如果 `Status` 列指示任何问题，请检查 **YAML** 选项卡上的 `status:` 输出以获取更多信息。
返回 **Operators** → **已安装的 Operators**。
选择 Red Hat OpenShift 分布式追踪平台 (Jaeger) Operator。
1. 单击 **Jaeger** 选项卡。
2. 单击部署的名称，例如 `jaeger`。
3. 要查看部署创建的资源，请单击 **Resources** 选项卡。
4. 如果 `Status` 列指示任何问题，请检查 **YAML** 选项卡上的 `status:` 输出以获取更多信息。
导航到 **Operators** → **已安装的 Operators**。
选择 Kiali Operator。
1. 单击 **Istio Service Mesh Control Plane** 选项卡。
2. 单击部署的名称，例如 `kiali`。
3. 要查看部署创建的资源，请单击 **Resources** 选项卡。
4. 如果 `Status` 列指示任何问题，请检查 **YAML** 选项卡上的 `status:` 输出以获取更多信息。

从命令行

运行以下命令查看服务网格控制平面 Pod 是否可用并正在运行，其中 `istio-system` 是您安装 SMCP 的命名空间。

$ oc get pods -n istio-system

示例输出

NAME                                   READY   STATUS    RESTARTS   AGE
grafana-6776785cfc-6fz7t               2/2     Running   0          102s
istio-egressgateway-5f49dd99-l9ppq     1/1     Running   0          103s
istio-ingressgateway-6dc885c48-jjd8r   1/1     Running   0          103s
istiod-basic-6c9cc55998-wg4zq          1/1     Running   0          2m14s
jaeger-6865d5d8bf-zrfss                2/2     Running   0          100s
kiali-579799fbb7-8mwc8                 1/1     Running   0          46s
prometheus-5c579dfb-6qhjk              2/2     Running   0          115s

使用以下命令检查服务网格控制平面部署的状态。将 `istio-system` 替换为您部署 SMCP 的命名空间。
```
$ oc get smcp -n istio-system
```
当 STATUS 列为 `ComponentsReady` 时，安装成功完成。
示例输出
```
NAME    READY   STATUS            PROFILES      VERSION   AGE
basic   10/10   ComponentsReady   ["default"]   2.1.3     4m2s
```
如果您修改并重新部署了服务网格控制平面，则状态应显示为 `UpdateSuccessful`。
示例输出
```
NAME            READY     STATUS             TEMPLATE   VERSION   AGE
basic-install   10/10     UpdateSuccessful   default     v1.1     3d16h
```
如果 SMCP 状态指示除 `ComponentsReady` 之外的任何内容，请检查 SCMP 资源中的 `status:` 输出以获取更多信息。
```
$ oc describe smcp <smcp-name> -n <controlplane-namespace>
```
示例输出
```
$ oc describe smcp basic -n istio-system
```

使用以下命令检查 Jaeger 部署的状态，其中 `istio-system` 是您部署 SMCP 的命名空间。

$ oc get jaeger -n istio-system

示例输出

NAME     STATUS    VERSION   STRATEGY   STORAGE   AGE
jaeger   Running   1.30.0    allinone   memory    15m

使用以下命令检查 Kiali 部署的状态，其中 `istio-system` 是您部署 SMCP 的命名空间。
```
$ oc get kiali -n istio-system
```
示例输出
```
NAME    AGE
kiali   15m
```

访问 Kiali 控制台

您可以在 Kiali 控制台中查看应用程序的拓扑、健康状况和指标。如果您的服务遇到问题，Kiali 控制台允许您查看数据流过您的服务。您可以查看不同级别的网格组件的洞察，包括抽象应用程序、服务和工作负载。Kiali 还提供命名空间的实时交互式图形视图。

要访问 Kiali 控制台，您必须安装 Red Hat OpenShift Service Mesh，并安装和配置 Kiali。

安装过程会创建一个访问 Kiali 控制台的路由。

如果您知道 Kiali 控制台的 URL，可以直接访问它。如果您不知道 URL，请使用以下说明。

管理员步骤

使用管理员角色登录 OpenShift Dedicated Web 控制台。
单击 **Home** → **Projects**。
在 **Projects** 页面上，如有必要，请使用过滤器查找项目的名称。
单击项目的名称，例如 `bookinfo`。
在 **Project details** 页面上的 **Launcher** 部分，单击 **Kiali** 链接。
使用您用于访问 OpenShift Dedicated 控制台的相同用户名和密码登录 Kiali 控制台。

首次登录 Kiali 控制台时，您将看到 **Overview** 页面，其中显示了您有权查看的服务网格中的所有命名空间。

如果您正在验证控制台安装，并且尚未将命名空间添加到网格中，则除了 `istio-system` 之外，可能没有任何其他数据显示。

开发者步骤

使用开发者角色登录 OpenShift Dedicated Web 控制台。
单击 **Project**。
在 **Project Details** 页面上，如有必要，请使用过滤器查找项目的名称。
单击项目的名称，例如 `bookinfo`。
在 **Project** 页面上的 **Launcher** 部分，单击 **Kiali** 链接。
单击 **Log In With OpenShift**。

访问 Jaeger 控制台

要访问 Jaeger 控制台，您必须安装 Red Hat OpenShift Service Mesh，并安装和配置 Red Hat OpenShift 分布式追踪平台 (Jaeger)。

安装过程会创建一个访问 Jaeger 控制台的路由。

如果您知道 Jaeger 控制台的 URL，可以直接访问它。如果您不知道 URL，请使用以下说明。

从 Red Hat OpenShift Service Mesh 2.5 开始，Red Hat OpenShift 分布式追踪平台 (Jaeger) 和 OpenShift Elasticsearch Operator 已弃用，将在未来的版本中删除。Red Hat 将在当前发布生命周期内为此功能提供错误修复和支持，但此功能将不再接收增强功能，并将被删除。作为 Red Hat OpenShift 分布式追踪平台 (Jaeger) 的替代方案，您可以改用 Red Hat OpenShift 分布式追踪平台 (Tempo)。

从 OpenShift 控制台进行操作

以具有集群管理员权限的用户身份登录 OpenShift Dedicated Web 控制台。如果您使用 Red Hat OpenShift Dedicated，则必须拥有具有 `dedicated-admin` 角色的帐户。
导航到 **网络** → **路由**。
在 **路由** 页面上，从 **命名空间** 菜单中选择 Service Mesh 控制平面项目，例如 `istio-system`。

**位置** 列显示每个路由的关联地址。
如有必要，使用过滤器查找 `jaeger` 路由。单击路由 **位置** 以启动控制台。
单击 **Log In With OpenShift**。

Kiali 控制台的操作步骤

启动 Kiali 控制台。
单击左侧导航窗格中的 **分布式追踪**。
单击 **Log In With OpenShift**。

CLI 的操作步骤

以具有 `cluster-admin` 角色的用户身份登录 OpenShift Dedicated CLI。如果您使用 Red Hat OpenShift Dedicated，则必须拥有具有 `dedicated-admin` 角色的帐户。
```
$ oc login --username=<NAMEOFUSER> https://<HOSTNAME>:6443
```
要使用命令行查询路由的详细信息，请输入以下命令。在此示例中，`istio-system` 是 Service Mesh 控制平面的命名空间。
```
$ oc get route -n istio-system jaeger -o jsonpath='{.spec.host}'
```
启动浏览器并导航到 `https://<JAEGER_URL>`，其中 `<JAEGER_URL>` 是您在上一步中发现的路由。
使用您用于访问 OpenShift Dedicated 控制台的相同用户名和密码登录。
如果您已将服务添加到服务网格并生成了跟踪，则可以使用过滤器和 **查找跟踪** 按钮来搜索您的跟踪数据。

如果您正在验证控制台安装，则没有跟踪数据显示。

Service Mesh 控制平面的故障排除

如果您在部署 Service Mesh 控制平面时遇到问题，

请确保 `ServiceMeshControlPlane` 资源安装在与您的服务和 Operators 分开的项目中。本文档使用 `istio-system` 项目作为示例，但您可以将控制平面部署到任何项目中，只要它与包含您的 Operators 和服务的项目分开即可。
确保 `ServiceMeshControlPlane` 和 `Jaeger` 自定义资源部署在同一项目中。例如，对两者都使用 `istio-system` 项目。

数据平面的故障排除

数据平面 是一组智能代理，它们拦截并控制服务网格中服务之间所有入站和出站网络通信。

Red Hat OpenShift Service Mesh 依赖于应用程序 pod 内的代理 sidecar 为应用程序提供服务网格功能。

Sidecar 注射的故障排除

Red Hat OpenShift Service Mesh 不会自动将代理 sidecar 注射到 pod 中。您必须选择加入 sidecar 注射。

Istio sidecar 注射的故障排除

检查您的应用程序的 Deployment 中是否启用了自动注入。如果为 Envoy 代理启用了自动注入，则在 `Deployment` 资源的 `spec.template.metadata.annotations` 下应该有一个 `sidecar.istio.io/inject:"true"` 注解。

Jaeger 代理 sidecar 注射的故障排除

检查您的应用程序的 Deployment 中是否启用了自动注入。如果为 Jaeger 代理启用了自动注入，则应该在 `Deployment` 资源中有一个 `sidecar.jaegertracing.io/inject:"true"` 注解。

有关 sidecar 注射的更多信息，请参见启用自动注入

Envoy 代理的故障排除

Envoy 代理拦截服务网格中所有服务的全部入站和出站流量。Envoy 还收集并报告服务网格的遥测数据。Envoy 部署为同一 pod 中相关服务的 sidecar。

启用 Envoy 访问日志

Envoy 访问日志可用于诊断流量故障和流，并有助于端到端流量流分析。

要为所有 istio-proxy 容器启用访问日志记录，请编辑 `ServiceMeshControlPlane` (SMCP) 对象以添加日志输出的文件名。

步骤

以具有集群管理员角色的用户身份登录 OpenShift Container Platform CLI。输入以下命令。然后，在出现提示时输入您的用户名和密码。
```
$ oc login --username=<NAMEOFUSER> https://<HOSTNAME>:6443
```
更改到您安装 Service Mesh 控制平面的项目，例如 `istio-system`。
```
$ oc project istio-system
```
编辑 `ServiceMeshControlPlane` 文件。
```
$ oc edit smcp <smcp_name>
```

如以下示例所示，使用 `name` 指定代理日志的文件名。如果您未为 `name` 指定值，则不会写入任何日志条目。

apiVersion: maistra.io/v2
kind: ServiceMeshControlPlane
metadata:
  name: basic
  namespace: istio-system
spec:
  proxy:
    accessLogging:
      file:
        name: /dev/stdout     #file name

获取支持

如果您在使用本文档中描述的步骤或 OpenShift Dedicated 时遇到困难，请访问 Red Hat 客户门户。

在客户门户中，您可以

搜索或浏览 Red Hat 知识库中关于 Red Hat 产品的文章和解决方案。
向 Red Hat 支持提交支持案例。
访问其他产品文档。

要识别集群中的问题，您可以在 OpenShift 集群管理器中使用 Insights。Insights 提供有关问题以及（如果可用）如何解决问题的详细信息。

如果您有改进本文档的建议或发现错误，请为最相关的文档组件提交 Jira 问题。请提供具体的详细信息，例如章节名称和 OpenShift Dedicated 版本。

关于 Red Hat 知识库

Red Hat 知识库提供丰富的资源，旨在帮助您充分利用 Red Hat 的产品和技术。Red Hat 知识库包含文章、产品文档和视频，概述了安装、配置和使用 Red Hat 产品的最佳实践。此外，您还可以搜索已知问题的解决方案，每个解决方案都提供简洁的根本原因描述和补救步骤。

搜索 Red Hat 知识库

如果遇到 OpenShift Dedicated 问题，您可以进行初步搜索，以确定 Red Hat 知识库中是否已存在解决方案。

先决条件

您拥有 Red Hat 客户门户帐户。

步骤

登录到 Red Hat 客户门户。
单击 **搜索**。
在搜索字段中，输入与问题相关的关键词和字符串，包括
- OpenShift Dedicated 组件（例如 **etcd**）
- 相关过程（例如 **安装**）
- 与显式故障相关的警告、错误消息和其他输出
按 **Enter** 键。
可选：选择 **OpenShift Dedicated** 产品过滤器。
可选：选择 **文档** 内容类型过滤器。

提交支持案例

先决条件

您可以以具有 `dedicated-admin` 角色的用户身份访问集群。
您已安装 OpenShift CLI ( `oc` )。
您可以访问 Red Hat OpenShift 集群管理器。

步骤

登录到 Red Hat 客户门户的 **客户支持** 页面。
单击 **获取支持**。
在 **客户支持** 页面的 **案例** 选项卡上
1. 可选：根据需要更改预填的帐户和所有者详细信息。
2. 选择与您的问题相关的类别，例如**错误或缺陷**，然后点击**继续**。
输入以下信息
1. 在**摘要**字段中，输入简明扼要但具有描述性的问题摘要以及遇到的症状和您的期望。
2. 从**产品**下拉菜单中选择**OpenShift Dedicated**。
查看建议的 Red Hat 知识库解决方案列表，查找与报告的问题匹配的潜在解决方案。如果建议的文章无法解决问题，请点击**继续**。
查看更新后的 Red Hat 知识库解决方案列表，查找与报告的问题匹配的潜在解决方案。在创建案例的过程中，随着您提供更多信息，此列表会不断完善。如果建议的文章无法解决问题，请点击**继续**。
确保显示的帐户信息符合预期，如果不符合，请相应修改。
检查自动填充的 OpenShift Dedicated 集群 ID 是否正确。如果不正确，请手动获取您的集群 ID。
- 使用OpenShift 集群管理器手动获取您的集群 ID
  1. 导航到**集群列表**。
  2. 点击您需要为其打开支持案例的集群名称。
  3. 在**概述**选项卡的**详细信息**部分的**集群 ID**字段中查找该值。
- 使用 OpenShift Dedicated Web 控制台手动获取您的集群 ID
  1. 导航到**主页** → **概述**。
  2. 在**详细信息**部分的**集群 ID**字段中查找该值。
- 或者，也可以通过 OpenShift Dedicated Web 控制台打开新的支持案例，并自动填充您的集群 ID。
  1. 从工具栏导航到**(?) 帮助** → **打开支持案例**。
  2. **集群 ID**值会自动填充。
- 要使用 OpenShift CLI (oc) 获取您的集群 ID，请运行以下命令：
  $ oc get clusterversion -o jsonpath='{.items[].spec.clusterID}{"\n"}'
完成提示中的以下问题，然后点击**继续**
- 您遇到了什么问题？您期望发生什么？
- 定义对您或业务的价值或影响。
- 您在何处遇到此行为？什么环境？
- 此行为何时发生？频率？反复出现？在特定时间？
上传相关的诊断数据文件，然后点击**继续**。
输入相关的案例管理详细信息，然后点击**继续**。
预览案例详细信息，然后点击**提交**。