OSDOCS-12713 Module for changing CVO log levels

Author: cbippley

modules/changing-cvo-log-level.adoc

@@ -0,0 +1,35 @@
+// Module included in the following assemblies:
+//
+// * updating/troubleshooting_updates/gathering-data-cluster-update.adoc
+
+:_mod-docs-content-type: PROCEDURE
+[id="changing-log-data_{context}"]
+= Changing CVO log level
+
+The Cluster Version Operator (CVO) log level verbosity can be changed by the cluster administrator. There are four log levels.
+
+* `Normal` - The default log level. Contains working log information when everything is fine. Provides helpful notices for auditing or common operations.
+* `Debug` - Used when something goes wrong. Expect a higher quantity of notices.
+* `Trace` - Increases the verbosity of the logs. Used to diagnose errors.
+// rephrase traceall
+* `TraceAll` - Used when something is broken at the level of API content/decoding. It will dump complete body content.  If turned on in a production cluster prepare for widespread performance issues and very large log files.
+
+.Prerequisites
+* You have access to the cluster as a user with the `cluster-admin` role.
+* You have installed the {oc-first}.
+* You have the TechPreviewNoUpgrade feature set enabled.
+
+.Procedure
+
+. Enter the following command into the CLI.
+
+[source,terminal]
+----
+$ oc patch clusterversionoperator/cluster --type=merge --patch '{"spec":{"operatorLogLevel":"<log_level>"}}'
+----
++
+.Example output
+[source,terminal]
+----
+TBD
+----

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

@@ -15,6 +15,8 @@ endif::openshift-origin[]
 
 include::modules/gathering-log-data.adoc[leveloffset=+1]
 
+include::modules/changing-cvo-log-level.adoc[leveloffset=+1]
+
 include::modules/update-upgrading-oc-adm-upgrade-status.adoc[leveloffset=+1]
 
 include::modules/gathering-clusterversion-history.adoc[leveloffset=+1]