第 4 章 集群更新故障排除
4.1. 收集集群更新的数据 复制链接链接已复制到粘贴板!
当联系红帽支持以获取更新时,务必要为支持团队提供数据,以便对失败的集群更新进行故障排除。
4.1.1. 为支持问题单收集日志数据 复制链接链接已复制到粘贴板!
要从集群收集数据,包括日志数据,请使用 oc adm must-gather 命令。请参阅收集有关集群的数据。
4.1.2. 更改 CVO 日志级别(技术预览) 复制链接链接已复制到粘贴板!
更改 CVO 日志级别只是一个技术预览功能。技术预览功能不受红帽产品服务等级协议(SLA)支持,且功能可能并不完整。红帽不推荐在生产环境中使用它们。这些技术预览功能可以使用户提早试用新的功能,并有机会在开发阶段提供反馈意见。
有关红帽技术预览功能支持范围的更多信息,请参阅以下链接:
Cluster Version Operator (CVO) 日志级别详细程度可由集群管理员更改。有四个日志级别。
-
normal- 默认日志级别。包含工作日志信息。当一切正常时使用。为审计或常见操作提供有用的通知。 -
Debug- 当出错时使用。会获得更多通知数量。 -
Trace- 用于诊断错误。 -
TraceAll- 用于获取日志的完整正文内容。
如果在生产环境集群中打开 TraceAll,可能会导致大范围的性能问题并生成大的日志文件。
先决条件
-
您可以使用具有
cluster-admin角色的用户访问集群。 -
已安装 OpenShift CLI(
oc)。 -
您已启用了
TechPreviewNoUpgrade功能集。
流程
- 在 CLI 中输入以下命令来更改日志级别。
$ oc patch clusterversionoperator/cluster --type=merge --patch '{"spec":{"operatorLogLevel":"<log_level>"}}'
输出示例
clusterversionoperator.operator.openshift.io/cluster patched
4.1.3. 收集 ClusterVersion 历史记录 复制链接链接已复制到粘贴板!
Cluster Version Operator (CVO) 记录对集群所做的更新,称为 ClusterVersion 历史记录。条目可以显示与潜在的触发器的集群行为更改之间的关联,尽管关联并不意味着会造成问题。
初始、次版本和 z-stream 版本更新由 ClusterVersion 历史记录存储。但是 ClusterVersion 历史记录有大小限制。如果达到了限制,则会修剪之前次版本中最旧的 z-stream 更新以满足限制。
您可以使用 OpenShift Container Platform Web 控制台或使用 OpenShift CLI (oc) 查看 ClusterVersion 历史记录。
您可以在 OpenShift Container Platform Web 控制台中查看 ClusterVersion 历史记录。
先决条件
-
您可以使用具有
cluster-admin角色的用户访问集群。 - 访问 OpenShift Container Platform web 控制台。
流程
-
在 web 控制台中点击 Administration
Cluster Settings 并查看 Details 选项卡中的内容。
4.1.3.2. 使用 OpenShift CLI 收集 ClusterVersion 历史记录 (oc) 复制链接链接已复制到粘贴板!
您可以使用 OpenShift CLI (oc) 查看 ClusterVersion 历史记录。
先决条件
-
您可以使用具有
cluster-admin角色的用户访问集群。 -
已安装 OpenShift CLI(
oc)。
流程
输入以下命令查看集群更新历史记录:
$ oc describe clusterversions/version输出示例
Desired: Channels: candidate-4.13 candidate-4.14 fast-4.13 fast-4.14 stable-4.13 Image: quay.io/openshift-release-dev/ocp-release@sha256:a148b19231e4634196717c3597001b7d0af91bf3a887c03c444f59d9582864f4 URL: https://access.redhat.com/errata/RHSA-2023:6130 Version: 4.13.19 History: Completion Time: 2023-11-07T20:26:04Z Image: quay.io/openshift-release-dev/ocp-release@sha256:a148b19231e4634196717c3597001b7d0af91bf3a887c03c444f59d9582864f4 Started Time: 2023-11-07T19:11:36Z State: Completed Verified: true Version: 4.13.19 Completion Time: 2023-10-04T18:53:29Z Image: quay.io/openshift-release-dev/ocp-release@sha256:eac141144d2ecd6cf27d24efe9209358ba516da22becc5f0abc199d25a9cfcec Started Time: 2023-10-04T17:26:31Z State: Completed Verified: true Version: 4.13.13 Completion Time: 2023-09-26T14:21:43Z Image: quay.io/openshift-release-dev/ocp-release@sha256:371328736411972e9640a9b24a07be0af16880863e1c1ab8b013f9984b4ef727 Started Time: 2023-09-26T14:02:33Z State: Completed Verified: false Version: 4.13.12 Observed Generation: 4 Version Hash: CMLl3sLq-EA= Events: <none>