Merge pull request #60966 from ekristova/RHDEVDOCS-3819

RHDEVDOCS-3819: [UG] How to store and retrieve logs

Author: bscott-rh

_topic_maps/_topic_map.yml

@@ -1943,6 +1943,8 @@ Topics:
     File: configuring-resource-quota
   - Name: Monitoring Argo CD custom resource workloads
     File: monitoring-argo-cd-custom-resource-workloads
+  - Name: Viewing Argo CD logs
+    File: viewing-argo-cd-logs
   - Name: Running Control Plane Workloads on Infra nodes
     File: run-gitops-control-plane-workload-on-infra-nodes
   - Name: Sizing requirements for GitOps Operator

cicd/gitops/viewing-argo-cd-logs.adoc

@@ -0,0 +1,16 @@
+:_content-type: ASSEMBLY
+[id="viewing-argo-cd-logs"]
+= Viewing Argo CD logs
+include::_attributes/common-attributes.adoc[]
+:context: viewing-argo-cd-logs
+
+toc::[]
+
+You can view the Argo CD logs with the {logging-title}. The {logging} visualizes the logs on a Kibana dashboard. The OpenShift Logging Operator enables logging with Argo CD by default.
+
+include::modules/gitops-storing-and-retrieving-argo-cd-logs.adoc[leveloffset=+1]
+
+[role="_additional-resources"]
+[id="additional-resources_viewing-argo-cd-logs"]
+== Additional resources
+* xref:../../logging/cluster-logging-deploying.adoc#cluster-logging-deploy-console_cluster-logging-deploying[Installing the {logging-title} using the web console]

modules/gitops-storing-and-retrieving-argo-cd-logs.adoc

@@ -0,0 +1,44 @@
+// Module included in the following assemblies:
+//
+// * cicd/gitops/viewing-argo-cd-logs.adoc
+
+:_content-type: PROCEDURE
+[id="gitops-storing-and-retrieving-argo-cd-logs_{context}"]
+= Storing and retrieving Argo CD logs
+
+You can use the Kibana dashboard to store and retrieve Argo CD logs.
+
+.Prerequisites
+
+* The {gitops-title} Operator is installed in your cluster.
+* The {logging-title} is installed with default configuration in your cluster.
+
+.Procedure
+
+. In the {product-title} web console, go to the {rh-app-icon} menu -> *Observability* -> *Logging* to view the Kibana dashboard. 
+
+. Create an index pattern.
+
+.. To display all the indices, define the index pattern as `pass:[*]`, and click *Next step*.
+
+.. Select *@timestamp* for *Time Filter field name*.
+
+.. Click *Create index pattern*.
+
+. In the navigation panel of the Kibana dashboard, click the *Discover* tab.
+
+. Create a filter to retrieve logs for Argo CD. The following steps create a filter that retrieves logs for all the pods in the `openshift-gitops` namespace:
+
+.. Click *Add a filter +*.
+
+.. Select the *kubernetes.namespace_name* field.
+
+.. Select the *is* operator.
+
+.. Select the *openshift-gitops* value.
+
+.. Click *Save*.
+
+. Optional: Add additional filters to narrow the search. For example, to retrieve logs for a particular pod, you can create another filter with `kubernetes.pod_name` as the field.
+
+. View the filtered Argo CD logs in the Kibana dashboard.