Merge pull request #67346 from abrennan89/visual-logs

OBSDOCS-152: Restructuring log visualization docs

Author: abrennan89

_topic_maps/_topic_map.yml

@@ -2533,6 +2533,15 @@ Topics:
 - Name: Updating Logging
   File: cluster-logging-upgrading
   Distros: openshift-enterprise,openshift-origin
+- Name: Visualizing logs
+  Dir: log_visualization
+  Topics:
+  - Name: About log visualization
+    File: log-visualization
+  - Name: Viewing cluster dashboards
+    File: cluster-logging-dashboards
+  - Name: Log visualization with Kibana
+    File: logging-kibana
 - Name: Configuring your Logging deployment
   Dir: config
   Distros: openshift-enterprise,openshift-origin
@@ -2541,8 +2550,6 @@ Topics:
     File: cluster-logging-configuring-cr
   - Name: Configuring the log store
     File: cluster-logging-log-store
-  - Name: Configuring the log visualizer
-    File: cluster-logging-visualizer
   - Name: Configuring CPU and memory limits for Logging components
     File: cluster-logging-memory
   - Name: Using tolerations to control Logging pod placement
@@ -2553,11 +2560,6 @@ Topics:
     File: cluster-logging-systemd
 - Name: Logging using LokiStack
   File: cluster-logging-loki
-- Name: Viewing logs for a specific resource
-  File: viewing-resource-logs
-- Name: Viewing cluster logs in Kibana
-  File: cluster-logging-visualizer
-  Distros: openshift-enterprise,openshift-origin
 - Name: Log collection and forwarding
   Dir: log_collection_forwarding
   Topics:
@@ -2571,8 +2573,6 @@ Topics:
     File: cluster-logging-collector
   - Name: Collecting and storing Kubernetes events
     File: cluster-logging-eventrouter
-- Name: Viewing cluster dashboards
-  File: cluster-logging-dashboards
 - Name: Logging alerts
   Dir: logging_alerts
   Topics:

_topic_maps/_topic_map_osd.yml

@@ -913,6 +913,15 @@ Topics:
   File: cluster-logging-deploying
 - Name: Updating Logging
   File: cluster-logging-upgrading
+- Name: Visualizing logs
+  Dir: log_visualization
+  Topics:
+  - Name: About log visualization
+    File: log-visualization
+  - Name: Viewing cluster dashboards
+    File: cluster-logging-dashboards
+  - Name: Log visualization with Kibana
+    File: logging-kibana
 - Name: Accessing the service logs
   File: sd-accessing-the-service-logs
 - Name: Configuring your Logging deployment
@@ -922,8 +931,6 @@ Topics:
     File: cluster-logging-configuring-cr
   - Name: Configuring the log store
     File: cluster-logging-log-store
-  - Name: Configuring the log visualizer
-    File: cluster-logging-visualizer
   - Name: Configuring CPU and memory limits for Logging components
     File: cluster-logging-memory
   - Name: Using tolerations to control Logging pod placement
@@ -934,11 +941,6 @@ Topics:
   #  File: cluster-logging-systemd
 - Name: Logging using LokiStack
   File: cluster-logging-loki
-- Name: Viewing logs for a specific resource
-  File: viewing-resource-logs
-- Name: Viewing cluster logs in Kibana
-  File: cluster-logging-visualizer
-  Distros: openshift-dedicated
 - Name: Log collection and forwarding
   Dir: log_collection_forwarding
   Topics:
@@ -952,8 +954,6 @@ Topics:
     File: cluster-logging-collector
   - Name: Collecting and storing Kubernetes events
     File: cluster-logging-eventrouter
-- Name: Viewing cluster dashboards
-  File: cluster-logging-dashboards
 - Name: Logging alerts
   Dir: logging_alerts
   Topics:

_topic_maps/_topic_map_rosa.yml

@@ -1084,6 +1084,15 @@ Topics:
   File: cluster-logging-deploying
 - Name: Updating Logging
   File: cluster-logging-upgrading
+- Name: Visualizing logs
+  Dir: log_visualization
+  Topics:
+  - Name: About log visualization
+    File: log-visualization
+  - Name: Viewing cluster dashboards
+    File: cluster-logging-dashboards
+  - Name: Log visualization with Kibana
+    File: logging-kibana
 - Name: Accessing the service logs
   File: sd-accessing-the-service-logs
 - Name: Viewing cluster logs in the AWS Console
@@ -1095,8 +1104,6 @@ Topics:
     File: cluster-logging-configuring-cr
   - Name: Configuring the log store
     File: cluster-logging-log-store
-  - Name: Configuring the log visualizer
-    File: cluster-logging-visualizer
   - Name: Configuring CPU and memory limits for Logging components
     File: cluster-logging-memory
   - Name: Using tolerations to control Logging pod placement
@@ -1107,10 +1114,6 @@ Topics:
   #  File: cluster-logging-systemd
 - Name: Logging using LokiStack
   File: cluster-logging-loki
-- Name: Viewing logs for a specific resource
-  File: viewing-resource-logs
-- Name: Viewing cluster logs in Kibana
-  File: cluster-logging-visualizer
 - Name: Log collection and forwarding
   Dir: log_collection_forwarding
   Topics:
@@ -1124,8 +1127,6 @@ Topics:
     File: cluster-logging-collector
   - Name: Collecting and storing Kubernetes events
     File: cluster-logging-eventrouter
-- Name: Viewing cluster dashboards
-  File: cluster-logging-dashboards
 - Name: Logging alerts
   Dir: logging_alerts
   Topics:

architecture/index.adoc

@@ -19,7 +19,7 @@ include::modules/openshift-architecture-common-terms.adoc[leveloffset=+1]
 * For more information on storage, see xref:../storage/index.adoc#index[{product-title} storage].
 * For more information on authentication, see xref:../authentication/index.adoc#index[{product-title} authentication].
 * For more information on Operator Lifecycle Manager (OLM), see xref:../operators/understanding/olm/olm-understanding-olm.adoc#olm-understanding-olm[OLM].
-* For more information on logging, see xref:../logging/viewing-resource-logs.adoc#viewing-resource-logs[{product-title} Logging].
+* For more information on logging, see xref:../logging/cluster-logging.adoc#cluster-logging[About Logging].
 * For more information on over-the-air (OTA) updates, see xref:../updating/understanding_updates/intro-to-updates.adoc#understanding-openshift-updates[Introduction to OpenShift updates].
 
 [id="about-installation-and-updates"]

cicd/pipelines/viewing-pipeline-logs-using-the-openshift-logging-operator.adoc

@@ -26,7 +26,6 @@ include::modules/op-viewing-pipeline-logs-in-kibana.adoc[leveloffset=+1]
 [role="_additional-resources"]
 [id="additional-resources_viewing-pipeline-logs-using-the-openshift-logging-operator"]
 == Additional resources
-
 * xref:../../logging/cluster-logging-deploying.adoc[Installing OpenShift Logging]
-* xref:../../logging/viewing-resource-logs.adoc[Viewing logs for a resource]
-* xref:../../logging/cluster-logging-visualizer.adoc[Viewing cluster logs by using Kibana]
+* xref:../../logging/log_visualization/log-visualization.adoc#log-visualization-resource-logs_log-visualization[Viewing logs for a resource]
+* xref:../../logging/log_visualization/logging-kibana.adoc#logging-kibana[Log visualization with Kibana]

logging/cluster-logging-deploying.adoc

@@ -40,21 +40,14 @@ include::modules/logging-install-es-operator.adoc[leveloffset=+2]
 
 == Postinstallation tasks
 
-If you plan to use Kibana, you must xref:#cluster-logging-visualizer-indices_cluster-logging-deploying[manually create your Kibana index patterns and visualizations] to explore and visualize data in Kibana.
-
 If your network plugin enforces network isolation, xref:#cluster-logging-deploy-multitenant_cluster-logging-deploying[allow network traffic between the projects that contain the {logging} Operators].
 
-
 include::modules/cluster-logging-deploy-cli.adoc[leveloffset=+1]
 
 == Postinstallation tasks
 
-If you plan to use Kibana, you must xref:#cluster-logging-visualizer-indices_cluster-logging-deploying[manually create your Kibana index patterns and visualizations] to explore and visualize data in Kibana.
-
 If your network plugin enforces network isolation, xref:#cluster-logging-deploy-multitenant_cluster-logging-deploying[allow network traffic between the projects that contain the {logging} Operators].
 
-include::modules/cluster-logging-visualizer-indices.adoc[leveloffset=+2]
-
 include::modules/cluster-logging-deploy-multitenant.adoc[leveloffset=+2]
 
 [role="_additional-resources"]

logging/cluster-logging-visualizer.adoc

@@ -7,7 +7,7 @@ include::_attributes/attributes-openshift-dedicated.adoc[]
 
 toc::[]
 
-As a cluster administrator, you can deploy {logging} on an {product-title} cluster, and use it to collect and aggregate node system audit logs, application container logs, and infrastructure logs. You can forward logs to your chosen log outputs, including on-cluster, Red{nbsp}Hat managed log storage. You can also visualize your log data in the {product-title} web console, or xref:../logging/cluster-logging-visualizer.adoc#cluster-logging-visualizer[the Kibana web console], depending on your deployed log storage solution.
+As a cluster administrator, you can deploy {logging} on an {product-title} cluster, and use it to collect and aggregate node system audit logs, application container logs, and infrastructure logs. You can forward logs to your chosen log outputs, including on-cluster, Red{nbsp}Hat managed log storage. You can also visualize your log data in the {product-title} web console, or the Kibana web console, depending on your deployed log storage solution.
 
 include::snippets/logging-kibana-dep-snip.adoc[]
 
@@ -36,10 +36,6 @@ include::modules/cluster-logging-collecting-storing-kubernetes-events.adoc[level
 
 For information, see xref:../logging/log_collection_forwarding/cluster-logging-eventrouter.adoc#cluster-logging-eventrouter[About collecting and storing Kubernetes events].
 
-include::modules/cluster-logging-view-cluster-dashboards.adoc[leveloffset=+2]
-
-For information, see xref:../logging/cluster-logging-dashboards.adoc#cluster-logging-dashboards[About viewing the cluster dashboard].
-
 include::modules/cluster-logging-troubleshoot-logging.adoc[leveloffset=+2]
 
 include::modules/cluster-logging-export-fields.adoc[leveloffset=+2]
@@ -50,10 +46,6 @@ include::modules/cluster-logging-about-logstore.adoc[leveloffset=+2]
 
 For information, see xref:../logging/config/cluster-logging-log-store.adoc#cluster-logging-log-store[Configuring the log store].
 
-include::modules/cluster-logging-about-visualizer.adoc[leveloffset=+2]
-
-For information, see xref:../logging/config/cluster-logging-visualizer.adoc#cluster-logging-visualizer[Configuring the log visualizer].
-
 include::modules/cluster-logging-eventrouter-about.adoc[leveloffset=+2]
 
 For information, see xref:../logging/log_collection_forwarding/cluster-logging-eventrouter.adoc#cluster-logging-eventrouter[Collecting and storing Kubernetes events].

logging/cluster-logging.adoc

@@ -0,0 +1 @@
+../../_attributes/