第 5 章 收集集群数据
您可以使用以下工具获取有关 OpenShift Dedicated 集群的调试信息。
5.1. 关于 must-gather 工具
oc adm must-gather CLI 命令可收集最有助于解决问题的集群信息，包括：
- 资源定义
- 服务日志
默认情况下，oc adm must-gather 命令使用默认的插件镜像，并写入 ./must-gather.local。
另外，您可以使用适当的参数运行命令来收集具体信息，如以下部分所述：
要收集与一个或多个特定功能相关的数据，请使用
--image参数和镜像，如以下部分所述。例如：
$ oc adm must-gather \ --image=registry.redhat.io/container-native-virtualization/cnv-must-gather-rhel9:v4.17.0
要收集审计日志，请使用
-- /usr/bin/gather_audit_logs参数，如以下部分所述。例如：
$ oc adm must-gather -- /usr/bin/gather_audit_logs
注意作为默认信息集合的一部分，不会收集审计日志来减小文件的大小。
当您运行 oc adm must-gather 时，集群的新项目中会创建一个带有随机名称的新 pod。在该 pod 上收集数据，并保存在当前工作目录中以 must-gather.local 开头的新目录中。
例如：
NAMESPACE NAME READY STATUS RESTARTS AGE ... openshift-must-gather-5drcj must-gather-bklx4 2/2 Running 0 72s openshift-must-gather-5drcj must-gather-s8sdh 2/2 Running 0 72s ...
另外，您可以使用 --run-namespace 选项在特定命名空间中运行 oc adm must-gather 命令。
例如：
$ oc adm must-gather --run-namespace <namespace> \ --image=registry.redhat.io/container-native-virtualization/cnv-must-gather-rhel9:v4.17.0
5.1.1. 为红帽支持收集您的集群数据
您可使用 oc adm must-gather CLI 命令收集有关您的集群的调试信息。
先决条件
您可以使用具有
cluster-admin角色的用户访问集群。注意在 OpenShift Dedicated 部署中，不使用客户云订阅(CCS)模型的用户无法使用
oc adm must-gather命令，因为它需要cluster-admin权限。-
已安装 OpenShift CLI (
oc)。
流程
-
进入要存储
must-gather数据的目录。 运行
oc adm must-gather命令：$ oc adm must-gather
注意因为这个命令会默认会选择一个随机 control plane 节点，所以 pod 可能会被调度到处于
NotReady和SchedulingDisabled状态的 control plane 节点。如果此命令失败，例如，您无法在集群中调度 pod，则使用
oc adm inspect命令来收集特定资源的信息。注意请联络红帽支持以获取推荐收集的资源信息。
从刚刚在您的工作目录中创建的
must-gather目录创建一个压缩文件。例如，在使用 Linux 操作系统的计算机上运行以下命令：$ tar cvaf must-gather.tar.gz must-gather.local.5421342344627712289/ 1- 1
- 务必将
must-gather-local.5421342344627712289/替换为实际目录名称。
- 在红帽客户门户网站的客户支持页面中，将压缩文件附加到您的支持问题单中。
5.1.2. must-gather 标记
下表中列出的标记可用于 oc adm must-gather 命令。
| 标记 | 示例命令 | 描述 |
|---|---|---|
|
|
|
使用使用 |
|
|
| 在写入收集的数据的本地机器上设置一个特定的目录。 |
|
|
|
运行 |
|
|
|
指定要运行的 |
|
|
|
使用一个命名空间或 name:tag 值指定一个'<image_stream>'，其中包含要运行的 |
|
|
| 设置要使用的特定节点。如果没有指定，则默认使用随机 master。 |
|
|
| 设置要使用的特定节点选择器。仅在指定命令和镜像时需要同时捕获一组集群节点上的数据时才相关。 |
|
|
|
应该运行 |
|
|
|
仅返回比指定持续时间更新的日志。默认为所有日志。鼓励插件，但不需要支持这个插件。只能使用 |
|
|
|
仅在特定日期和时间后返回日志，以(RFC3339)格式表示。默认为所有日志。鼓励插件，但不需要支持这个插件。只能使用 |
|
|
| 在复制从其中复制收集的数据的 pod 中设置特定目录。 |
|
|
| 在超时前收集数据的时间长度，以秒、分钟或小时表示，如 3s、5m 或 2h。指定的时间必须大于零。如果没有指定，则默认为 10 分钟。 |
|
|
|
指定可用于 |
5.1.3. 收集有关特定功能的数据
您可通过将 oc adm must-gather CLI 命令与 --image 或 --image-stream 参数结合使用来收集有关特定功能的调试信息。must-gather 工具支持多个镜像，这样您便可通过运行单个命令收集多个功能的数据。
| Image | 用途 |
|---|---|
|
| OpenShift Virtualization 的数据收集。 |
|
| OpenShift Serverless 的数据收集。 |
|
| Red Hat OpenShift Service Mesh 的数据收集。 |
|
| MTC 的数据收集。 |
|
| 用于日志记录的数据收集。 |
|
| Network Observability Operator 的数据收集。 |
|
| OpenShift 共享资源 CSI 驱动程序的数据收集。 |
|
| Red Hat OpenShift GitOps 的数据收集。 |
|
| Secret Store CSI Driver Operator 的数据收集。 |
要确定 OpenShift Dedicated 组件镜像的最新版本，请参阅红帽客户门户网站中的 OpenShift Operator 生命周期 网页。
先决条件
-
您可以使用具有
cluster-admin角色的用户访问集群。 -
已安装 OpenShift CLI (
oc)。
流程
-
进入存储
must-gather数据的目录。 使用一个或多个
--image或--image-stream参数运行oc adm must-gather命令。注意-
要收集除特定功能数据外的默认
must-gather数据，请添加--image-stream=openshift/must-gather参数。
例如，使用以下命令可收集默认集群数据和 OpenShift Virtualization 特定信息：
$ oc adm must-gather \ --image-stream=openshift/must-gather \ 1 --image=registry.redhat.io/container-native-virtualization/cnv-must-gather-rhel9:v4.17.0 2
您可以将
must-gather工具与额外参数搭配使用，以收集集群中与 OpenShift Logging 和 Cluster Logging Operator 特别相关的数据。对于 OpenShift Logging，运行以下命令：$ oc adm must-gather --image=$(oc -n openshift-logging get deployment.apps/cluster-logging-operator \ -o jsonpath='{.spec.template.spec.containers[?(@.name == "cluster-logging-operator")].image}')例 5.1. OpenShift Logging 的
must-gather输出示例├── cluster-logging │ ├── clo │ │ ├── cluster-logging-operator-74dd5994f-6ttgt │ │ ├── clusterlogforwarder_cr │ │ ├── cr │ │ ├── csv │ │ ├── deployment │ │ └── logforwarding_cr │ ├── collector │ │ ├── fluentd-2tr64 │ ├── curator │ │ └── curator-1596028500-zkz4s │ ├── eo │ │ ├── csv │ │ ├── deployment │ │ └── elasticsearch-operator-7dc7d97b9d-jb4r4 │ ├── es │ │ ├── cluster-elasticsearch │ │ │ ├── aliases │ │ │ ├── health │ │ │ ├── indices │ │ │ ├── latest_documents.json │ │ │ ├── nodes │ │ │ ├── nodes_stats.json │ │ │ └── thread_pool │ │ ├── cr │ │ ├── elasticsearch-cdm-lp8l38m0-1-794d6dd989-4jxms │ │ └── logs │ │ ├── elasticsearch-cdm-lp8l38m0-1-794d6dd989-4jxms │ ├── install │ │ ├── co_logs │ │ ├── install_plan │ │ ├── olmo_logs │ │ └── subscription │ └── kibana │ ├── cr │ ├── kibana-9d69668d4-2rkvz ├── cluster-scoped-resources │ └── core │ ├── nodes │ │ ├── ip-10-0-146-180.eu-west-1.compute.internal.yaml │ └── persistentvolumes │ ├── pvc-0a8d65d9-54aa-4c44-9ecc-33d9381e41c1.yaml ├── event-filter.html ├── gather-debug.log └── namespaces ├── openshift-logging │ ├── apps │ │ ├── daemonsets.yaml │ │ ├── deployments.yaml │ │ ├── replicasets.yaml │ │ └── statefulsets.yaml │ ├── batch │ │ ├── cronjobs.yaml │ │ └── jobs.yaml │ ├── core │ │ ├── configmaps.yaml │ │ ├── endpoints.yaml │ │ ├── events │ │ │ ├── curator-1596021300-wn2ks.162634ebf0055a94.yaml │ │ │ ├── curator.162638330681bee2.yaml │ │ │ ├── elasticsearch-delete-app-1596020400-gm6nl.1626341a296c16a1.yaml │ │ │ ├── elasticsearch-delete-audit-1596020400-9l9n4.1626341a2af81bbd.yaml │ │ │ ├── elasticsearch-delete-infra-1596020400-v98tk.1626341a2d821069.yaml │ │ │ ├── elasticsearch-rollover-app-1596020400-cc5vc.1626341a3019b238.yaml │ │ │ ├── elasticsearch-rollover-audit-1596020400-s8d5s.1626341a31f7b315.yaml │ │ │ ├── elasticsearch-rollover-infra-1596020400-7mgv8.1626341a35ea59ed.yaml │ │ ├── events.yaml │ │ ├── persistentvolumeclaims.yaml │ │ ├── pods.yaml │ │ ├── replicationcontrollers.yaml │ │ ├── secrets.yaml │ │ └── services.yaml │ ├── openshift-logging.yaml │ ├── pods │ │ ├── cluster-logging-operator-74dd5994f-6ttgt │ │ │ ├── cluster-logging-operator │ │ │ │ └── cluster-logging-operator │ │ │ │ └── logs │ │ │ │ ├── current.log │ │ │ │ ├── previous.insecure.log │ │ │ │ └── previous.log │ │ │ └── cluster-logging-operator-74dd5994f-6ttgt.yaml │ │ ├── cluster-logging-operator-registry-6df49d7d4-mxxff │ │ │ ├── cluster-logging-operator-registry │ │ │ │ └── cluster-logging-operator-registry │ │ │ │ └── logs │ │ │ │ ├── current.log │ │ │ │ ├── previous.insecure.log │ │ │ │ └── previous.log │ │ │ ├── cluster-logging-operator-registry-6df49d7d4-mxxff.yaml │ │ │ └── mutate-csv-and-generate-sqlite-db │ │ │ └── mutate-csv-and-generate-sqlite-db │ │ │ └── logs │ │ │ ├── current.log │ │ │ ├── previous.insecure.log │ │ │ └── previous.log │ │ ├── curator-1596028500-zkz4s │ │ ├── elasticsearch-cdm-lp8l38m0-1-794d6dd989-4jxms │ │ ├── elasticsearch-delete-app-1596030300-bpgcx │ │ │ ├── elasticsearch-delete-app-1596030300-bpgcx.yaml │ │ │ └── indexmanagement │ │ │ └── indexmanagement │ │ │ └── logs │ │ │ ├── current.log │ │ │ ├── previous.insecure.log │ │ │ └── previous.log │ │ ├── fluentd-2tr64 │ │ │ ├── fluentd │ │ │ │ └── fluentd │ │ │ │ └── logs │ │ │ │ ├── current.log │ │ │ │ ├── previous.insecure.log │ │ │ │ └── previous.log │ │ │ ├── fluentd-2tr64.yaml │ │ │ └── fluentd-init │ │ │ └── fluentd-init │ │ │ └── logs │ │ │ ├── current.log │ │ │ ├── previous.insecure.log │ │ │ └── previous.log │ │ ├── kibana-9d69668d4-2rkvz │ │ │ ├── kibana │ │ │ │ └── kibana │ │ │ │ └── logs │ │ │ │ ├── current.log │ │ │ │ ├── previous.insecure.log │ │ │ │ └── previous.log │ │ │ ├── kibana-9d69668d4-2rkvz.yaml │ │ │ └── kibana-proxy │ │ │ └── kibana-proxy │ │ │ └── logs │ │ │ ├── current.log │ │ │ ├── previous.insecure.log │ │ │ └── previous.log │ └── route.openshift.io │ └── routes.yaml └── openshift-operators-redhat ├── ...-
要收集除特定功能数据外的默认
使用一个或多个
--image或--image-stream参数运行oc adm must-gather命令。例如，使用以下命令可收集默认集群数据和 KubeVirt 特定信息：$ oc adm must-gather \ --image-stream=openshift/must-gather \ 1 --image=quay.io/kubevirt/must-gather 2
从工作目录中刚刚创建的
must-gather目录创建一个压缩文件。例如，在使用 Linux 操作系统的计算机上运行以下命令：$ tar cvaf must-gather.tar.gz must-gather.local.5421342344627712289/ 1- 1
- 务必将
must-gather-local.5421342344627712289/替换为实际目录名称。
- 在红帽客户门户网站的客户支持页面中，将压缩文件附加到您的支持问题单中。
