Merge pull request #55533 from gabriel-rh/srvcom-2122-observability-restructure

SRVCOM-2112 Observability restructure

Author: gabriel-rh

_topic_maps/_topic_map.yml

@@ -3925,24 +3925,6 @@ Topics:
     File: serverless-kafka-admin
   - Name: Serverless components in the Administrator perspective
     File: serverless-admin-perspective
-    # Metrics
-  - Name: Serverless administrator metrics
-    File: serverless-admin-metrics
-    # HA
-  - Name: High availability
-    File: serverless-ha
-- Name: Monitor
-  Dir: monitor
-  Topics:
-  # logging
-  - Name: Cluster logging with OpenShift Serverless
-    File: cluster-logging-serverless
-  # Metrics
-  - Name: Serverless developer metrics
-    File: serverless-developer-metrics
-# Tracing
-- Name: Tracing
-  File: serverless-tracing
 # Security
 - Name: Security
   Dir: security
@@ -3975,6 +3957,56 @@ Topics:
     File: serverless-functions-annotations
   - Name: Functions development reference guide
     File: serverless-functions-reference-guide
+- Name: Observability
+  Dir: observability
+  Topics:
+  - Name: Administrator metrics
+    Dir: admin-metrics
+    Topics:
+    - Name: Administrator metrics overview
+      File: serverless-admin-metrics
+    - Name: Controller metrics
+      File: serverless-controller-metrics
+    - Name: Webhook metrics
+      File: serverless-webhook-metrics
+    - Name: Knative Eventing metrics
+      File: serverless-admin-metrics-eventing
+    - Name: Knative Serving metrics
+      File: serverless-admin-metrics-serving
+  - Name: Developer metrics
+    Dir: developer-metrics
+    Topics:
+    - Name: Developer metrics overview
+      File: serverless-developer-metrics
+    - Name: Default Knative service metrics
+      File: serverless-monitoring-services-default-metrics
+    - Name: Custom Knative service metrics
+      File: serverless-monitoring-services-custom-metrics
+    - Name: Configuration for scraping custom metrics
+      File: serverless-monitoring-services-configuration-scraping
+    - Name: Examining metrics of a service
+      File: serverless-monitoring-services-examining-metrics
+    - Name: Dashboard for service metrics
+      File: serverless-developer-metrics-dashboard
+  - Name: Cluster logging
+    Dir: cluster-logging
+    Topics:
+    - Name: Using OpenShift Logging with Serverless
+      File: cluster-logging-serverless
+    - Name: Finding logs for Knative Serving components
+      File: finding-serving-logs-components
+    - Name: Finding logs for Knative Serving services
+      File: finding-serving-logs-services
+  - Name: Tracing
+    Dir: tracing
+    Topics:
+    - Name: Tracing requests
+      File: serverless-tracing
+    - Name: Using Red Hat OpenShift distributed tracing
+      File: serverless-tracing-open-telemetry
+      Distros: openshift-enterprise
+    - Name: Using Jaeger distributed tracing
+      File: serverless-tracing-jaeger
 # Integrations
 - Name: Integrations
   Dir: integrations

_topic_maps/_topic_map_osd.yml

@@ -513,20 +513,6 @@ Topics:
     File: serverless-kafka-admin
   - Name: Serverless components in the Administrator perspective
     File: serverless-admin-perspective
-  - Name: Serverless administrator metrics
-    File: serverless-admin-metrics
-  - Name: High availability
-    File: serverless-ha
-- Name: Monitor
-  Dir: monitor
-  Topics:
-  - Name: Cluster logging with OpenShift Serverless
-    File: cluster-logging-serverless
-  - Name: Serverless developer metrics
-    File: serverless-developer-metrics
-# Tracing
-- Name: Tracing
-  File: serverless-tracing
 - Name: Security
   Dir: security
   Topics:
@@ -555,6 +541,56 @@ Topics:
     File: serverless-functions-annotations
   - Name: Functions development reference guide
     File: serverless-functions-reference-guide
+- Name: Observability
+  Dir: observability
+  Topics:
+  - Name: Administrator metrics
+    Dir: admin-metrics
+    Topics:
+    - Name: Administrator metrics overview
+      File: serverless-admin-metrics
+    - Name: Controller metrics
+      File: serverless-controller-metrics
+    - Name: Webhook metrics
+      File: serverless-webhook-metrics
+    - Name: Knative Eventing metrics
+      File: serverless-admin-metrics-eventing
+    - Name: Knative Serving metrics
+      File: serverless-admin-metrics-serving
+  - Name: Developer metrics
+    Dir: developer-metrics
+    Topics:
+    - Name: Developer metrics overview
+      File: serverless-developer-metrics
+    - Name: Default Knative service metrics
+      File: serverless-monitoring-services-default-metrics
+    - Name: Custom Knative service metrics
+      File: serverless-monitoring-services-custom-metrics
+    - Name: Configuration for scraping custom metrics
+      File: serverless-monitoring-services-configuration-scraping
+    - Name: Examining metrics of a service
+      File: serverless-monitoring-services-examining-metrics
+    - Name: Dashboard for service metrics
+      File: serverless-developer-metrics-dashboard
+  - Name: Cluster logging
+    Dir: cluster-logging
+    Topics:
+    - Name: Using OpenShift Logging with Serverless
+      File: cluster-logging-serverless
+    - Name: Finding logs for Knative Serving components
+      File: finding-serving-logs-components
+    - Name: Finding logs for Knative Serving services
+      File: finding-serving-logs-services
+  - Name: Tracing
+    Dir: tracing
+    Topics:
+    - Name: Tracing requests
+      File: serverless-tracing
+    - Name: Using Red Hat OpenShift distributed tracing
+      File: serverless-tracing-open-telemetry
+      Distros: openshift-enterprise
+    - Name: Using Jaeger distributed tracing
+      File: serverless-tracing-jaeger
 # Removing  
 - Name: Removing Serverless
   Dir: removing

_topic_maps/_topic_map_rosa.yml

@@ -711,20 +711,6 @@ Topics:
     File: serverless-kafka-admin
   - Name: Serverless components in the Administrator perspective
     File: serverless-admin-perspective
-  - Name: Serverless administrator metrics
-    File: serverless-admin-metrics
-  - Name: High availability on OpenShift Serverless
-    File: serverless-ha
-- Name: Monitor
-  Dir: monitor
-  Topics:
-  - Name: Cluster logging with OpenShift Serverless
-    File: cluster-logging-serverless
-  - Name: Serverless developer metrics
-    File: serverless-developer-metrics
-# Tracing
-- Name: Tracing
-  File: serverless-tracing
 - Name: Security
   Dir: security
   Topics:
@@ -753,6 +739,66 @@ Topics:
     File: serverless-functions-annotations
   - Name: Functions development reference guide
     File: serverless-functions-reference-guide
+- Name: Observability
+  Dir: observability
+  Topics:
+  - Name: Administrator metrics
+    Dir: admin-metrics
+    Topics:
+    - Name: Administrator metrics overview
+      File: serverless-admin-metrics
+    - Name: Controller metrics
+      File: serverless-controller-metrics
+    - Name: Webhook metrics
+      File: serverless-webhook-metrics
+    - Name: Knative Eventing metrics
+      File: serverless-admin-metrics-eventing
+    - Name: Knative Serving metrics
+      File: serverless-admin-metrics-serving
+  - Name: Developer metrics
+    Dir: developer-metrics
+    Topics:
+    - Name: Developer metrics overview
+      File: serverless-developer-metrics
+    - Name: Default Knative service metrics
+      File: serverless-monitoring-services-default-metrics
+    - Name: Custom Knative service metrics
+      File: serverless-monitoring-services-custom-metrics
+    - Name: Configuration for scraping custom metrics
+      File: serverless-monitoring-services-configuration-scraping
+    - Name: Examining metrics of a service
+      File: serverless-monitoring-services-examining-metrics
+    - Name: Dashboard for service metrics
+      File: serverless-developer-metrics-dashboard
+  - Name: Cluster logging
+    Dir: cluster-logging
+    Topics:
+    - Name: Using OpenShift Logging with Serverless
+      File: cluster-logging-serverless
+    - Name: Finding logs for Knative Serving components
+      File: finding-serving-logs-components
+    - Name: Finding logs for Knative Serving services
+      File: finding-serving-logs-services
+  - Name: Tracing
+    Dir: tracing
+    Topics:
+    - Name: Tracing requests
+      File: serverless-tracing
+    - Name: Using Red Hat OpenShift distributed tracing
+      File: serverless-tracing-open-telemetry
+      Distros: openshift-enterprise
+    - Name: Using Jaeger distributed tracing
+      File: serverless-tracing-jaeger
+# Integrations
+- Name: Integrations
+  Dir: integrations
+  Topics:
+  - Name: Integrating Service Mesh with OpenShift Serverless
+    File: serverless-ossm-setup  
+  - Name: Integrating Serverless with the cost management service
+    File: serverless-cost-management-integration
+  - Name: Using NVIDIA GPU resources with serverless applications
+    File: gpu-resources
 # Removing  
 - Name: Removing Serverless
   Dir: removing
@@ -770,16 +816,6 @@ Topics:
 # Support
 - Name: Serverless support
   File: serverless-support
-# Integrations
-- Name: Integrations
-  Dir: integrations
-  Topics:
-  - Name: Integrating Service Mesh with OpenShift Serverless
-    File: serverless-ossm-setup  
-  - Name: Integrating Serverless with the cost management service
-    File: serverless-cost-management-integration
-  - Name: Using NVIDIA GPU resources with serverless applications
-    File: gpu-resources
 ---
 Name: Troubleshooting
 Dir: rosa_support

modules/serverless-activator-metrics.adoc

@@ -1,6 +1,6 @@
 // Module included in the following assemblies:
 //
-// * serverless/admin_guide/serverless-admin-metrics.adoc
+// * serverless/observability/admin-metrics/serverless-admin-metrics.adoc
 
 :_content-type: REFERENCE
 [id="serverless-activator-metrics_{context}"]

modules/serverless-autoscaler-metrics.adoc

@@ -1,6 +1,6 @@
 // Module included in the following assemblies:
 //
-// * serverless/admin_guide/serverless-admin-metrics.adoc
+// * serverless/observability/admin-metrics/serverless-admin-metrics.adoc
 
 :_content-type: REFERENCE
 [id="serverless-autoscaler-metrics_{context}"]

modules/serverless-broker-filter-metrics.adoc

@@ -1,6 +1,6 @@
 // Module included in the following assemblies:
 //
-// * serverless/admin_guide/serverless-admin-metrics.adoc
+// * serverless/observability/admin-metrics/serverless-admin-metrics.adoc
 
 :_content-type: REFERENCE
 [id="serverless-broker-filter-metrics_{context}"]

modules/serverless-broker-ingress-metrics.adoc

@@ -1,6 +1,6 @@
 // Module included in the following assemblies:
 //
-// * serverless/admin_guide/serverless-admin-metrics.adoc
+// * serverless/observability/admin-metrics/serverless-admin-metrics.adoc
 
 :_content-type: REFERENCE
 [id="serverless-broker-ingress-metrics_{context}"]

modules/serverless-jaeger-config.adoc

@@ -4,9 +4,9 @@
 
 :_content-type: PROCEDURE
 [id="serverless-jaeger-config_{context}"]
-= Using Jaeger to enable distributed tracing
+= Configuring Jaeger to enable distributed tracing
 
-If you do not want to install all of the components of {DTProductName}, you can still use distributed tracing on {product-title} with {ServerlessProductName}. To do this, you must install and configure Jaeger as a standalone integration.
+To enable distributed tracing using Jaeger, you must install and configure Jaeger as a standalone integration.
 
 .Prerequisites
 

modules/serverless-monitoring-services-examining-metrics-dashboard.adoc

@@ -6,8 +6,6 @@
 [id="serverless-monitoring-services-examining-metrics-dashboard_{context}"]
 = Examining metrics of a service in the dashboard
 
-You can examine the metrics using a dedicated dashboard that aggregates queue proxy metrics by namespace.
-
 .Prerequisites
 
 * You have logged in to the {product-title} web console.