Update example docs

charts/k8s-monitoring/docs/examples/features/auto-instrumentation/beyla-metrics-and-traces/README.md

@@ -2,7 +2,11 @@
 (NOTE: Do not edit README.md directly. It is a generated file!)
 (      To make changes, please modify values.yaml or description.txt and run `make examples`)
 -->
-# Example: features/auto-instrumentation/beyla-metrics-and-traces/values.yaml
+# Auto-Instrumentation with Beyla for Metrics and Traces
+
+This example demonstrates how to enable the auto-instrumentation feature, which deploys Grafana Beyla to automatically
+instrument your application for metrics collection. It also coordinates with the Application Observability feature to
+generate traces for your application.
 
 ## Values
 

charts/k8s-monitoring/docs/examples/features/auto-instrumentation/beyla-metrics/README.md

@@ -2,7 +2,10 @@
 (NOTE: Do not edit README.md directly. It is a generated file!)
 (      To make changes, please modify values.yaml or description.txt and run `make examples`)
 -->
-# Example: features/auto-instrumentation/beyla-metrics/values.yaml
+# Auto-Instrumentation with Beyla for Metrics
+
+This example demonstrates how to enable the auto-instrumentation feature, which deploys Grafana Beyla to automatically
+instrument your application for metrics collection.
 
 ## Values
 

charts/k8s-monitoring/docs/examples/features/cluster-events/default/README.md

@@ -2,7 +2,10 @@
 (NOTE: Do not edit README.md directly. It is a generated file!)
 (      To make changes, please modify values.yaml or description.txt and run `make examples`)
 -->
-# Example: features/cluster-events/default/values.yaml
+# Cluster Events
+
+This example demonstrates how to enable the Cluster Events feature to gather Kubernetes Cluster Events from the
+Kubernetes API server and deliver them to a logs destination.
 
 ## Values
 

charts/k8s-monitoring/docs/examples/features/cluster-metrics/control-plane-monitoring/README.md

@@ -2,7 +2,10 @@
 (NOTE: Do not edit README.md directly. It is a generated file!)
 (      To make changes, please modify values.yaml or description.txt and run `make examples`)
 -->
-# Example: features/cluster-metrics/control-plane-monitoring/values.yaml
+# Cluster Metrics with Control Plane Monitoring
+
+This example demonstrates how to enable the Cluster Metrics feature to gather metrics about the Kubernetes Cluster,
+including the control plane components, and deliver them to a metrics destination.
 
 ## Values
 

charts/k8s-monitoring/docs/examples/features/cluster-metrics/default/README.md

@@ -2,7 +2,10 @@
 (NOTE: Do not edit README.md directly. It is a generated file!)
 (      To make changes, please modify values.yaml or description.txt and run `make examples`)
 -->
-# Example: features/cluster-metrics/default/values.yaml
+# Cluster Metrics
+
+This example demonstrates how to enable the Cluster Metrics feature to gather metrics about the Kubernetes Cluster and
+deliver them to a metrics destination.
 
 ## Values
 

charts/k8s-monitoring/docs/examples/features/integrations/alloy/README.md

@@ -2,7 +2,10 @@
 (NOTE: Do not edit README.md directly. It is a generated file!)
 (      To make changes, please modify values.yaml or description.txt and run `make examples`)
 -->
-# Example: features/integrations/alloy/values.yaml
+# Integration: Alloy
+
+This example demonstrates how to gather metrics from
+[Grafana Alloy](https://grafana.com/oss/alloy-opentelemetry-collector/).
 
 ## Values
 

charts/k8s-monitoring/docs/examples/features/integrations/cert-manager/README.md

@@ -2,7 +2,9 @@
 (NOTE: Do not edit README.md directly. It is a generated file!)
 (      To make changes, please modify values.yaml or description.txt and run `make examples`)
 -->
-# Example: features/integrations/cert-manager/values.yaml
+# Integration: cert-manager
+
+This example demonstrates how to gather metrics from [cert-manager](https://cert-manager.io/).
 
 ## Values
 

charts/k8s-monitoring/docs/examples/features/integrations/etcd/README.md

@@ -2,7 +2,9 @@
 (NOTE: Do not edit README.md directly. It is a generated file!)
 (      To make changes, please modify values.yaml or description.txt and run `make examples`)
 -->
-# Example: features/integrations/etcd/values.yaml
+# Integration: etcd
+
+This example demonstrates how to gather metrics from [etcd](https://etcd.io/).
 
 ## Values
 

charts/k8s-monitoring/docs/examples/features/integrations/loki/README.md

@@ -2,7 +2,9 @@
 (NOTE: Do not edit README.md directly. It is a generated file!)
 (      To make changes, please modify values.yaml or description.txt and run `make examples`)
 -->
-# Example: features/integrations/loki/values.yaml
+# Integration: Loki
+
+This example demonstrates how to gather metrics and logs from [Grafana Loki](https://grafana.com/oss/loki/).
 
 ## Values
 

charts/k8s-monitoring/docs/examples/features/integrations/mysql/README.md

@@ -2,11 +2,9 @@
 (NOTE: Do not edit README.md directly. It is a generated file!)
 (      To make changes, please modify values.yaml or description.txt and run `make examples`)
 -->
-# MySQL Integration
+# Integration: Loki
 
-This example shows how to load two MySQL integration instances, which utilize Alloy's [prometheus.exporter.mysql](https://grafana.com/docs/alloy/latest/reference/components/prometheus/prometheus.exporter.mysql/) component
-to scrape metrics from the MySQL database. It also modifies the Pod Logs feature to add special log handling for MySQL
-pods. The username and password for the `prod-db` example are stored in a Kubernetes secret.
+This example demonstrates how to gather metrics and logs from [MySQL](https://www.mysql.com/).
 
 ## Values
 

charts/k8s-monitoring/docs/examples/features/node-logs/default/README.md

@@ -2,7 +2,9 @@
 (NOTE: Do not edit README.md directly. It is a generated file!)
 (      To make changes, please modify values.yaml or description.txt and run `make examples`)
 -->
-# Example: features/node-logs/default/values.yaml
+# Node Logs
+
+This example demonstrates how to gather logs from the Nodes in your Kubernetes cluster.
 
 ## Values
 

charts/k8s-monitoring/docs/examples/features/pod-logs/default/README.md

@@ -2,7 +2,9 @@
 (NOTE: Do not edit README.md directly. It is a generated file!)
 (      To make changes, please modify values.yaml or description.txt and run `make examples`)
 -->
-# Example: features/pod-logs/default/values.yaml
+# Pod Logs
+
+This example demonstrates how to gather logs from the Pods in your Kubernetes cluster.
 
 ## Values
 

charts/k8s-monitoring/docs/examples/features/profiling/default/README.md

@@ -2,7 +2,10 @@
 (NOTE: Do not edit README.md directly. It is a generated file!)
 (      To make changes, please modify values.yaml or description.txt and run `make examples`)
 -->
-# Example: features/profiling/default/values.yaml
+# Profiling
+
+This example demonstrates how to enable the Profiling feature to gather profiles from your Kubernetes cluster and
+deliver them to Pyroscope.
 
 ## Values
 

charts/k8s-monitoring/docs/examples/features/prometheus-operator-objects/default/README.md

@@ -2,7 +2,10 @@
 (NOTE: Do not edit README.md directly. It is a generated file!)
 (      To make changes, please modify values.yaml or description.txt and run `make examples`)
 -->
-# Example: features/prometheus-operator-objects/default/values.yaml
+# Prometheus Operator Objects
+
+This example demonstrates how to enable the Prometheus Operator Objects feature to discover and gather metrics from
+PodMonitors, ServiceMonitors, and Probes in your Kubernetes cluster.
 
 ## Values
 

charts/k8s-monitoring/docs/examples/meta-monitoring/README.md

@@ -25,39 +25,20 @@ integrations:
     instances:
       # monitor the collector gathering and sending meta-monitoring metrics/logs to the meta-monitoring cluster
       - name: alloy-singleton
-        namespaces:
-          - logs
-      # monitor the collectors gathering and sending metrics/logs to the local cluster
-      - name: alloy-metrics
-        namespaces:
-          - collectors
-      - name: alloy-logs
-        namespaces:
-          - collectors
-      - name: alloy-profiles
-        namespaces:
-          - collectors
-      - name: alloy-receiver
-        namespaces:
-          - collectors
-      - name: alloy-singleton
-        namespaces:
-          - collectors
+        namespaces: [logs]
   loki:
     instances:
       - name: loki
         labelSelectors:
           app.kubernetes.io/name: loki
         logs:
           enabled: true
-          namespaces:
-            - logs
+          namespaces: [logs]
 
 clusterEvents:
   enabled: true
   collector: alloy-singleton
-  namespaces:
-    - logs
+  namespaces: [logs]
 
 clusterMetrics:
   enabled: true
@@ -74,16 +55,6 @@ clusterMetrics:
         source_labels = ["namespace"]
         regex = "logs"
       }
-  apiServer:
-    enabled: false
-  kubeControllerManager:
-    enabled: false
-  kubeDNS:
-    enabled: false
-  kubeProxy:
-    enabled: false
-  kubeScheduler:
-    enabled: false
   kube-state-metrics:
     enabled: true
     namespaces:
@@ -107,29 +78,13 @@ clusterMetrics:
     enabled: false
     deploy: false
 
-nodeLogs:
-  enabled: false
-
 podLogs:
   enabled: true
   gatherMethod: kubernetesApi
   collector: alloy-singleton
-  namespaces:
-    - logs
+  namespaces: [logs]
 
 # Collectors
 alloy-singleton:
   enabled: true
-
-alloy-metrics:
-  enabled: false
-
-alloy-logs:
-  enabled: false
-
-alloy-profiles:
-  enabled: false
-
-alloy-receiver:
-  enabled: false
 ```