Merge pull request #102537 from openshift-cherrypick-robot/cherry-pick-101867-to-standalone-coo-docs-1-latest

[standalone-coo-docs-1-latest] OBSDOCS-2695: [COO] Update signal correlation panel for COO 1.3 release.

Author: gabriel-rh

_attributes/common-attributes.adoc

@@ -38,6 +38,9 @@
 :cmo-full: Cluster Monitoring Operator
 :cmo-short: CMO
 
+// Observability Signal Correlation
+:korrel8r: https://github.com/korrel8r/korrel8r[Korrel8r]
+:sync: image:fa-sync-alt.svg[Sync,20]
 
 // Cluster Observability Operator
 :coo-first: Cluster Observability Operator (COO)

images/coo-troubleshooting-experimental.png

@@ -0,0 +1,29 @@
+// Module included in the following assemblies:
+
+// * observability/cluster_observability_operator/ui_plugins/troubleshooting-ui-plugin.adoc
+
+:_mod-docs-content-type: REFERENCE
+[id="coo-troubleshooting-ui-plugin-advanced_{context}"]
+= Advanced controls for the {coo-full} troubleshooting panel UI plugin
+
+The **Advanced** button opens additional controls over the correlation search.
+These are *experimental* and might change in a future release.
+They provide access to additional features of the {korrel8r} upstream project that powers the correlation search.
+
+image::coo-troubleshooting-panel-advanced.png[Advanced Controls]
+
+
+The following list explains the additional controls under the *Advanced* button:
+
+* **Recent** The search is limited to recent results, by default in the last day.
+* **Range** Allows searching an explicit date/time range in the past.
+* **Distance** Searches up to the given distance from the starting point.
+    Each correlation rule (edge in the graph) is a "step", and the **distance** is the maximum number of steps.
+* **Goal Class** Instead of a distance, you can select a **goal**, which is a resource or signal type.
+    This searches for paths from the start to the goal type, and the path length is not limited.
+    For more information about correlation classes, see the {korrel8r} project documentation.
+* **Query** The {korrel8r} query representing the starting point for the search.
+    Click **Focus** to reset the query to reflect the current console page.
+    Click **Sync** to re-run the current query and update the graph.
+    For more information about correlation queries, see the {korrel8r} project documentation.
+

images/coo-troubleshooting-panel-advanced.png

@@ -24,4 +24,5 @@ metadata:
   name: troubleshooting-panel
 spec:
   type: TroubleshootingPanel
-----
+----
+