OBSDOCS-555: Added docs for using the logging console plug-in

Author: abrennan89

_attributes/attributes-openshift-dedicated.adoc

@@ -21,6 +21,7 @@
 :SMProductName: Red Hat OpenShift Service Mesh
 :pipelines-title: Red Hat OpenShift Pipelines
 :logging-sd: Red Hat OpenShift Logging
+:log-plug: logging subsystem Console Plugin
 :ServerlessProductName: OpenShift Serverless
 :rh-openstack-first: Red Hat OpenStack Platform (RHOSP)
 :rh-openstack: RHOSP

_attributes/common-attributes.adoc

@@ -136,6 +136,7 @@ endif::[]
 :clo: Red Hat OpenShift Logging Operator
 :loki-op: Loki Operator
 :es-op: Elasticsearch Operator
+:log-plug: logging subsystem Console plugin
 //serverless
 :ServerlessProductName: OpenShift Serverless
 :ServerlessProductShortName: Serverless

_topic_maps/_topic_map.yml

@@ -2516,6 +2516,8 @@ Topics:
   Topics:
   - Name: About log visualization
     File: log-visualization
+  - Name: Log visualization with the web console
+    File: log-visualization-ocp-console
   - Name: Viewing cluster dashboards
     File: cluster-logging-dashboards
   - Name: Log visualization with Kibana

_topic_maps/_topic_map_osd.yml

@@ -1044,6 +1044,8 @@ Topics:
   Topics:
   - Name: About log visualization
     File: log-visualization
+  - Name: Log visualization with the web console
+    File: log-visualization-ocp-console
   - Name: Viewing cluster dashboards
     File: cluster-logging-dashboards
   - Name: Log visualization with Kibana

_topic_maps/_topic_map_rosa.yml

@@ -1215,6 +1215,8 @@ Topics:
   Topics:
   - Name: About log visualization
     File: log-visualization
+  - Name: Log visualization with the web console
+    File: log-visualization-ocp-console
   - Name: Viewing cluster dashboards
     File: cluster-logging-dashboards
   - Name: Log visualization with Kibana

logging/cluster-logging.adoc

@@ -22,6 +22,10 @@ Because the internal {product-title} Elasticsearch log store does not provide se
 
 include::modules/logging-architecture-overview.adoc[leveloffset=+1]
 
+[role="_additional-resources"]
+.Additional resources
+* xref:../logging/log_visualization/log-visualization-ocp-console.adoc#log-visualization-ocp-console[Log visualization with the web console]
+
 include::modules/cluster-logging-about.adoc[leveloffset=+1]
 
 ifdef::openshift-rosa,openshift-dedicated[]

logging/log_visualization/log-visualization-ocp-console.adoc

@@ -0,0 +1,17 @@
+:_mod-docs-content-type: ASSEMBLY
+include::_attributes/common-attributes.adoc[]
+include::_attributes/attributes-openshift-dedicated.adoc[]
+[id="log-visualization-ocp-console"]
+= Log visualization with the web console
+:context: log-visualization-ocp-console
+
+toc::[]
+
+You can use the {product-title} web console to visualize log data by configuring the {log-plug}.
+
+For information about configuring the plugin during the {logging} installation, see xref:../../logging/cluster-logging-deploying.adoc#cluster-logging-deploy-console_cluster-logging-deploying[Installing the {logging} using the web console].
+
+If you have already installed the {logging} and want to configure the plugin, use one of the following procedures.
+
+include::modules/enabling-log-console-plugin.adoc[leveloffset=+1]
+include::modules/logging-plugin-es-loki.adoc[leveloffset=+1]

modules/cluster-logging-deploy-console.adoc

@@ -23,7 +23,7 @@ include::snippets/logging-compatibility-snip.adoc[]
 +
 This option sets the `openshift.io/cluster-monitoring: "true"` label in the Namespace object. You must select this option to ensure that cluster monitoring scrapes the `openshift-logging` namespace.
 
-. Select *stable-5.x* as the *Update channel*.
+. Select *stable-5.y* as the *Update channel*.
 +
 --
 include::snippets/logging-stable-updates-snip.adoc[]
@@ -33,7 +33,7 @@ include::snippets/logging-stable-updates-snip.adoc[]
 ** The *Automatic* strategy allows Operator Lifecycle Manager (OLM) to automatically update the Operator when a new version is available.
 ** The *Manual* strategy requires a user with appropriate credentials to approve the Operator update.
 
-. Select *Enable* or *Disable* for the Console plugin.
+. Select *Enable* or *Disable* for the *Console plugin*.
 . Click *Install*.
 
 .Verification

modules/enabling-log-console-plugin.adoc

@@ -0,0 +1,25 @@
+// Module included in the following assemblies:
+//
+// * logging/log_visualization/log-visualization-ocp-console.adoc
+
+:_mod-docs-content-type: PROCEDURE
+[id="enabling-log-console-plugin_{context}"]
+= Enabling the {log-plug} after you have installed the {clo}
+
+You can enable the {log-plug} as part of the {clo} installation, but you can also enable the plugin if you have already installed the {clo} with the plugin disabled.
+
+.Prerequisites
+
+* You have administrator permissions.
+* You have installed the {clo} and selected *Disabled* for the *Console plugin*.
+* You have access to the {product-title} web console.
+
+.Procedure
+
+. In the {product-title} web console *Administrator* perspective, navigate to *Operators* -> *Installed Operators*.
+. Click *Red Hat OpenShift Logging*. This takes you to the Operator *Details* page.
+. In the *Details* page, click *Disabled* for the *Console plugin* option.
+. In the *Console plugin enablement* dialog, select *Enable*.
+. Click *Save*.
+. Verify that the *Console plugin* option now shows *Enabled*.
+. The web console displays a pop-up window when changes have been applied. The window prompts you to reload the web console. Refresh the browser when you see the pop-up window to apply the changes.

modules/logging-architecture-overview.adoc

@@ -20,7 +20,7 @@ Log store:: The log store stores log data for analysis and is the default output
 include::snippets/logging-elastic-dep-snip.adoc[]
 --
 
-Visualization:: You can use a UI component to view a visual representation of your log data. The UI provides a graphical interface to search, query, and view stored logs. If you are using LokiStack as the default log storage, the {product-title} web console UI is provided by enabling the {product-title} console plugin. If you are using Elasticsearch as the default log storage, you can use Kibana.
+Visualization:: You can use a UI component to view a visual representation of your log data. The UI provides a graphical interface to search, query, and view stored logs. The {product-title} web console UI is provided by enabling the {product-title} console plugin.
 +
 --
 include::snippets/logging-kibana-dep-snip.adoc[]