Gathering data about your cluster update

If your cluster update fails, you can examine cluster data to troubleshoot the failure.

Gathering log data for a support case

To gather data from your cluster, including log data, use the oc adm must-gather command. See Gathering data about your cluster.

Gathering ClusterVersion history

The Cluster Version Operator (CVO) records updates made to a cluster, known as the ClusterVersion history. The entries can reveal correlation between changes in cluster behavior with potential triggers, although correlation does not imply causation.

The initial, minor, and z-stream version updates are stored by the ClusterVersion history. However, the ClusterVersion history has a size limit. If the limit is reached, the oldest z-stream updates in previous minor versions are pruned to accommodate the limit.

You can view the ClusterVersion history by using the OKD web console or by using the OpenShift CLI (oc).

Gathering ClusterVersion history in the OKD web console

You can view the ClusterVersion history in the OKD web console.

Prerequisites

  • You have access to the cluster as a user with the cluster-admin role.

  • You have access to the OKD web console.

Procedure

  • From the web console, click Administration → Cluster Settings and review the contents of the Details tab.

Gathering ClusterVersion history using the OpenShift CLI (oc)

You can view the ClusterVersion history using the OpenShift CLI (oc).

Prerequisites

  • You have access to the cluster as a user with the cluster-admin role.

  • You have installed the OpenShift CLI (oc).

Procedure

  1. View the cluster update history by entering the following command:

    1. $ oc describe clusterversions/version

    Example output

    1.   Desired:
    2.     Channels:
    3.       candidate-4.13
    4.       candidate-4.14
    5.       fast-4.13
    6.       fast-4.14
    7.       stable-4.13
    8.     Image:    quay.io/openshift-release-dev/ocp-release@sha256:a148b19231e4634196717c3597001b7d0af91bf3a887c03c444f59d9582864f4
    9.     URL:      https://access.redhat.com/errata/RHSA-2023:6130
    10.     Version:  4.13.19
    11.   History:
    12.     Completion Time:    2023-11-07T20:26:04Z
    13.     Image:              quay.io/openshift-release-dev/ocp-release@sha256:a148b19231e4634196717c3597001b7d0af91bf3a887c03c444f59d9582864f4
    14.     Started Time:       2023-11-07T19:11:36Z
    15.     State:              Completed
    16.     Verified:           true
    17.     Version:            4.13.19
    18.     Completion Time:    2023-10-04T18:53:29Z
    19.     Image:              quay.io/openshift-release-dev/ocp-release@sha256:eac141144d2ecd6cf27d24efe9209358ba516da22becc5f0abc199d25a9cfcec
    20.     Started Time:       2023-10-04T17:26:31Z
    21.     State:              Completed
    22.     Verified:           true
    23.     Version:            4.13.13
    24.     Completion Time:    2023-09-26T14:21:43Z
    25.     Image:              quay.io/openshift-release-dev/ocp-release@sha256:371328736411972e9640a9b24a07be0af16880863e1c1ab8b013f9984b4ef727
    26.     Started Time:       2023-09-26T14:02:33Z
    27.     State:              Completed
    28.     Verified:           false
    29.     Version:            4.13.12
    30.   Observed Generation:  4
    31.   Version Hash:         CMLl3sLq-EA=
    32. Events:                 <none>

Additional resources