Gathering and interpreting cv history

Author: obrown1205

modules/gathering-clusterversion-history-cli.adoc

@@ -0,0 +1,62 @@
+// Module included in the following assemblies:
+//
+// * updating/troubleshooting_updates/gathering-data-cluster-update.adoc
+
+:_mod-docs-content-type: PROCEDURE
+[id="gathering-clusterversion-history-cli_{context}"]
+= Gathering ClusterVersion history using the {oc-first}
+
+You can view the ClusterVersion history using the {oc-first}.
+
+.Prerequisites
+* You have access to the cluster as a user with the `cluster-admin` role.
+* You have installed the {oc-first}.
+
+.Procedure
+
+. View the cluster update history by entering the following command:
++
+[source,terminal]
+----
+$ oc describe clusterversions/version
+----
++
+.Example output
+[source,terminal]
+----
+  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>
+----
+
+
+

modules/gathering-clusterversion-history-console.adoc

@@ -0,0 +1,17 @@
+// Module included in the following assemblies:
+//
+// * updating/troubleshooting_updates/gathering-data-cluster-update.adoc
+
+:_mod-docs-content-type: PROCEDURE
+[id="gathering-clusterversion-history-console_{context}"]
+= Gathering ClusterVersion history in the {product-title} web console
+
+You can view the ClusterVersion history in the {product-title} web console.
+
+.Prerequisites
+* You have access to the cluster as a user with the `cluster-admin` role.
+* You have access to the {product-title} web console.
+
+.Procedure
+
+* From the web console, click *Administration* -> *Cluster Settings* and review the contents of the *Details* tab.

modules/gathering-clusterversion-history.adoc

@@ -0,0 +1,17 @@
+// Module included in the following assemblies:
+//
+// * updating/troubleshooting_updates/gathering-data-cluster-update.adoc
+
+:_mod-docs-content-type: PROCEDURE
+[id="gathering-clusterversion-history_{context}"]
+= 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.
+
+[NOTE]
+====
+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 {product-title} web console or by using the {oc-first}.
+

updating/troubleshooting_updates/gathering-data-cluster-update.adoc

@@ -15,6 +15,12 @@ endif::openshift-origin[]
 
 include::modules/gathering-log-data.adoc[leveloffset=+1]
 
+include::modules/gathering-clusterversion-history.adoc[leveloffset=+1]
+
+include::modules/gathering-clusterversion-history-console.adoc[leveloffset=+2]
+
+include::modules/gathering-clusterversion-history-cli.adoc[leveloffset=+2]
+
 [role="_additional-resources"]
 [id="additional-resources_gathering-cluster-data"]
 .Additional resources