MIG-421 Using unified logger in MTC

Author: apinnick

migration/migrating_3_4/troubleshooting-3-4.adoc

@@ -16,6 +16,7 @@ Manual rollback is not required if the application was not stopped during migrat
 ====
 
 include::modules/migration-viewing-migration-crs.adoc[leveloffset=+1]
+include::modules/migration-using-mig-log-reader.adoc[leveloffset=+1]
 include::modules/migration-downloading-logs.adoc[leveloffset=+1]
 include::modules/migration-updating-deprecated-gvks.adoc[leveloffset=+1]
 include::modules/migration-error-messages.adoc[leveloffset=+1]

migration/migrating_4_1_4/troubleshooting-4-1-4.adoc

@@ -16,6 +16,7 @@ Manual rollback is not required if the application was not stopped during migrat
 ====
 
 include::modules/migration-viewing-migration-crs.adoc[leveloffset=+1]
+include::modules/migration-using-mig-log-reader.adoc[leveloffset=+1]
 include::modules/migration-downloading-logs.adoc[leveloffset=+1]
 include::modules/migration-error-messages.adoc[leveloffset=+1]
 include::modules/migration-manually-rolling-back-migration.adoc[leveloffset=+1]

migration/migrating_4_2_4/troubleshooting-4-2-4.adoc

@@ -16,6 +16,7 @@ Manual rollback is not required if the application was not stopped during migrat
 ====
 
 include::modules/migration-viewing-migration-crs.adoc[leveloffset=+1]
+include::modules/migration-using-mig-log-reader.adoc[leveloffset=+1]
 include::modules/migration-downloading-logs.adoc[leveloffset=+1]
 include::modules/migration-error-messages.adoc[leveloffset=+1]
 include::modules/migration-manually-rolling-back-migration.adoc[leveloffset=+1]

modules/migration-using-mig-log-reader.adoc

@@ -0,0 +1,20 @@
+// Module included in the following assemblies:
+//
+// * migration/migrating_3_4/troubleshooting-3-4.adoc
+// * migration/migrating_4_1_4/troubleshooting-4-1-4.adoc
+// * migration/migrating_4_2_4/troubleshooting-4-2-4.adoc
+
+[id='migration-using-mig-log-reader_{context}']
+= Using the migration log reader
+
+You can use the migration log reader to display a single filtered view of all the migration logs.
+
+.Procedure
+
+* Run the following command to display a single migration log:
++
+[source,terminal]
+----
+$ oc logs -f --selector logreader=mig -n openshift-migration -c color <1>
+----
+<1> You can use the `-c plain` option to display the log without colors.