OSDOCS-12713 Module for changing CVO log levels

Author: cbippley

modules/changing-cvo-log-level.adoc

@@ -0,0 +1,42 @@
+// 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
+
+:FeatureName: Changing the CVO log level
+include::snippets/technology-preview.adoc[]
+
+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.
+* `TraceAll` - Used to get the complete body content of the logs.
+
+[NOTE]
+====
+If `TraceAll` is turned on in a production cluster it may cause widespread performance issues and 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]
+----
+clusterversionoperator.operator.openshift.io/cluster patched
+----

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]