Doc improvements to link to other charts and reference resource reque…

…sts and limits Signed-off-by: Pete Wall <pete.wall@grafana.com>
grafana · Jan 16, 2025 · e24a244 · e24a244
1 parent fb6c629
commit e24a244
Show file tree

Hide file tree

Showing 3 changed files with 78 additions and 18 deletions.
diff --git a/README.md b/README.md
@@ -8,8 +8,9 @@
 ![GitHub Release](https://img.shields.io/github/v/release/grafana/k8s-monitoring-helm)
 ![GitHub Release Date](https://img.shields.io/github/release-date/grafana/k8s-monitoring-helm)
 
-[![Test Charts](https://github.com/grafana/k8s-monitoring-helm/workflows/Test/badge.svg?branch=main)](https://github.com/grafana/k8s-monitoring-helm/actions/workflows/helm-test.yml?query=branch%3Amain)
-[![Release Charts](https://github.com/grafana/k8s-monitoring-helm/workflows/Release%20Helm%20chart/badge.svg?branch=main)](https://github.com/grafana/k8s-monitoring-helm/actions/workflows/helm-release.yml?query=branch%3Amain)
+[![Unit Tests](https://github.com/grafana/k8s-monitoring-helm/actions/workflows/unit-test.yml/badge.svg?branch=main)](https://github.com/grafana/k8s-monitoring-helm/actions/workflows/unit-test.yml?query=branch%3Amain)
+[![Integration Tests](https://github.com/grafana/k8s-monitoring-helm/actions/workflows/integration-test.yml/badge.svg?branch=main)](https://github.com/grafana/k8s-monitoring-helm/actions/workflows/integration-test.yml?query=branch%3Amain)
+[![Platform Tests](https://github.com/grafana/k8s-monitoring-helm/actions/workflows/platform-test.yml/badge.svg?branch=main)](https://github.com/grafana/k8s-monitoring-helm/actions/workflows/platform-test.yml?query=branch%3Amain)
 ![GitHub License](https://img.shields.io/github/license/grafana/k8s-monitoring-helm)
 
 </div>
@@ -23,34 +24,38 @@
 
 ## Usage
 
-[Helm](https://helm.sh/) must be installed to use the chart. Please refer to Helm's [documentation](https://helm.sh/docs/) to get started.
+[Helm](https://helm.sh/) must be installed to use the chart. Please refer to
+Helm's [documentation](https://helm.sh/docs/) to get started.
 
 Once Helm is set up properly, add the repository as follows:
 
 ```console
 helm repo add grafana https://grafana.github.io/helm-charts
 ```
 
-See the [Chart Documentation](https://github.com/grafana/k8s-monitoring-helm/blob/main/charts/k8s-monitoring-v1/README.md) for chart install instructions.
+See
+the [Chart Documentation](https://github.com/grafana/k8s-monitoring-helm/blob/main/charts/k8s-monitoring-v1/README.md)
+for chart install instructions.
 
 ## Office Hours
 
 We hold office hours roughly monthly. Meeting times and recordings will be posted here:
 
-| Date       | Topic                       | Link                                      |
-|------------|-----------------------------|-------------------------------------------|
-| 2024-10-11 | Upcoming 2.0 version        | [Recording](https://youtu.be/2N6MQN45Gy8) |
-| 2024-11-22 | 2.0 Status                  | [Recording](https://youtu.be/rR6yxTEGLZc) |
-| 2024-12-19 | 2.0 Status and release date | [Recording](https://youtu.be/zkhR_5v1i9g) |
+| Date       | Topic                       | Link                                                                           |
+|------------|-----------------------------|--------------------------------------------------------------------------------|
+| 2024-10-11 | Upcoming 2.0 version        | [Recording](https://youtu.be/2N6MQN45Gy8)                                      |
+| 2024-11-22 | 2.0 Status                  | [Recording](https://youtu.be/rR6yxTEGLZc)                                      |
+| 2024-12-19 | 2.0 Status and release date | [Recording](https://youtu.be/zkhR_5v1i9g)                                      |
+| 2024-01-24 | 2.0 Release and future      | [Meeting Link](https://grafana.slack.com/archives/CAGMZG3GB/p1737059655740439) |
 
 ## Contributing
 
 See our [Contributing Guide](./CONTRIBUTING.md) for more information.
 
 ## Links
 
--   [Kubernetes Monitoring on Grafana Cloud](https://grafana.com/docs/grafana-cloud/kubernetes-monitoring/)
--   [Grafana Alloy](https://github.com/grafana/alloy)
--   [Kube State Metrics](https://github.com/kubernetes/kube-state-metrics)
--   [Node Exporter](https://github.com/prometheus/node_exporter)
--   [OpenCost](https://github.com/opencost/opencost)
+- [Kubernetes Monitoring on Grafana Cloud](https://grafana.com/docs/grafana-cloud/kubernetes-monitoring/)
+- [Grafana Alloy](https://github.com/grafana/alloy)
+- [Kube State Metrics](https://github.com/kubernetes/kube-state-metrics)
+- [Node Exporter](https://github.com/prometheus/node_exporter)
+- [OpenCost](https://github.com/opencost/opencost)
diff --git a/charts/k8s-monitoring/README.md b/charts/k8s-monitoring/README.md
@@ -288,7 +288,7 @@ podLogs:
 
 | Key | Type | Default | Description |
 |-----|------|---------|-------------|
-| autoInstrumentation | object | Disabled | Auto-Instrumentation. Requires destinations that supports metrics, logs, and traces. To see the valid options, please see the [Application Observability feature documentation](https://github.com/grafana/k8s-monitoring-helm/tree/main/charts/k8s-monitoring/charts/feature-application-observability). |
+| autoInstrumentation | object | Disabled | Auto-Instrumentation. Requires destinations that supports metrics, logs, and traces. To see the valid options, please see the [Auto-Instrumentation feature documentation](https://github.com/grafana/k8s-monitoring-helm/tree/main/charts/k8s-monitoring/charts/feature-auto-instrumentation). |
 | autoInstrumentation.destinations | list | `[]` | The destinations where application data will be sent. If empty, all capable destinations will be used. |
 | autoInstrumentation.enabled | bool | `false` | Enable automatic instrumentation for applications. |
 

diff --git a/charts/k8s-monitoring/values.yaml b/charts/k8s-monitoring/values.yaml
@@ -62,6 +62,8 @@ clusterMetrics:
   # @ignored
   collector: alloy-metrics
 
+  # To see additional options, please see the [Cluster Monitoring feature documentation](https://github.com/grafana/k8s-monitoring-helm/tree/main/charts/k8s-monitoring/charts/feature-cluster-metrics).
+
 # -- Cluster events.
 # Requires a destination that supports logs.
 # To see the valid options, please see the [Cluster Events feature documentation](https://github.com/grafana/k8s-monitoring-helm/tree/main/charts/k8s-monitoring/charts/feature-cluster-events).
@@ -81,6 +83,8 @@ clusterEvents:
   # @ignored
   collector: alloy-singleton
 
+  # To see additional options, please see the [Cluster Events feature documentation](https://github.com/grafana/k8s-monitoring-helm/tree/main/charts/k8s-monitoring/charts/feature-cluster-events).
+
 # -- Node logs.
 # Requires a destination that supports logs.
 # To see the valid options, please see the [Node Logs feature documentation](https://github.com/grafana/k8s-monitoring-helm/tree/main/charts/k8s-monitoring/charts/feature-node-logs).
@@ -95,8 +99,13 @@ nodeLogs:
   # @section -- Features - Node Logs
   destinations: []
 
+  # -- Which collector to assign this feature to. Do not change this unless you are sure of what you are doing.
+  # @section -- Features - Node Logs
+  # @ignored
   collector: alloy-logs
 
+  # To see additional options, please see the [Node Logs feature documentation](https://github.com/grafana/k8s-monitoring-helm/tree/main/charts/k8s-monitoring/charts/feature-node-logs).
+
 # -- Pod logs.
 # Requires a destination that supports logs.
 # To see the valid options, please see the [Pod Logs feature documentation](https://github.com/grafana/k8s-monitoring-helm/tree/main/charts/k8s-monitoring/charts/feature-pod-logs).
@@ -111,8 +120,13 @@ podLogs:
   # @section -- Features - Pod Logs
   destinations: []
 
+  # -- Which collector to assign this feature to. Do not change this unless you are sure of what you are doing.
+  # @section -- Features - Pod Logs
+  # @ignored
   collector: alloy-logs
 
+  # To see additional options, please see the [Pod Logs feature documentation](https://github.com/grafana/k8s-monitoring-helm/tree/main/charts/k8s-monitoring/charts/feature-pod-logs).
+
 # -- Application Observability.
 # Requires destinations that supports metrics, logs, and traces.
 # To see the valid options, please see the [Application Observability feature documentation](https://github.com/grafana/k8s-monitoring-helm/tree/main/charts/k8s-monitoring/charts/feature-application-observability).
@@ -132,9 +146,11 @@ applicationObservability:
   # @ignored
   collector: alloy-receiver
 
+  # To see additional options, please see the [Application Observability feature documentation](https://github.com/grafana/k8s-monitoring-helm/tree/main/charts/k8s-monitoring/charts/feature-application-observability).
+
 # -- Auto-Instrumentation.
 # Requires destinations that supports metrics, logs, and traces.
-# To see the valid options, please see the [Application Observability feature documentation](https://github.com/grafana/k8s-monitoring-helm/tree/main/charts/k8s-monitoring/charts/feature-application-observability).
+# To see the valid options, please see the [Auto-Instrumentation feature documentation](https://github.com/grafana/k8s-monitoring-helm/tree/main/charts/k8s-monitoring/charts/feature-auto-instrumentation).
 # @default -- Disabled
 # @section -- Features - Auto-Instrumentation
 autoInstrumentation:
@@ -151,6 +167,8 @@ autoInstrumentation:
   # @ignored
   collector: alloy-metrics
 
+  # To see additional options, please see the [Auto-Instrumentation feature documentation](https://github.com/grafana/k8s-monitoring-helm/tree/main/charts/k8s-monitoring/charts/feature-auto-instrumentation).
+
 # -- Annotation Autodiscovery enables gathering metrics from Kubernetes Pods and Services discovered by special annotations.
 # Requires a destination that supports metrics.
 # To see the valid options, please see the [Annotation Autodiscovery feature documentation](https://github.com/grafana/k8s-monitoring-helm/tree/main/charts/k8s-monitoring/charts/feature-annotation-autodiscovery).
@@ -170,10 +188,11 @@ annotationAutodiscovery:
   # @ignored
   collector: alloy-metrics
 
+  # To see additional options, please see the [Annotation Autodiscovery feature documentation](https://github.com/grafana/k8s-monitoring-helm/tree/main/charts/k8s-monitoring/charts/feature-annotation-autodiscovery).
+
 # -- Prometheus Operator Objects enables the gathering of metrics from objects like Probes, PodMonitors, and
 # ServiceMonitors. Requires a destination that supports metrics.
-# To see the valid options, please see the
-# [Prometheus Operator Objects feature documentation](https://github.com/grafana/k8s-monitoring-helm/tree/main/charts/k8s-monitoring/charts/feature-prometheus-operator-objects).
+# To see the valid options, please see the [Prometheus Operator Objects feature documentation](https://github.com/grafana/k8s-monitoring-helm/tree/main/charts/k8s-monitoring/charts/feature-prometheus-operator-objects).
 # @default -- Disabled
 # @section -- Features - Prometheus Operator Objects
 prometheusOperatorObjects:
@@ -190,6 +209,8 @@ prometheusOperatorObjects:
   # @ignored
   collector: alloy-metrics
 
+  # To see additional options, please see the [Prometheus Operator Objects feature documentation](https://github.com/grafana/k8s-monitoring-helm/tree/main/charts/k8s-monitoring/charts/feature-prometheus-operator-objects).
+
 # -- Profiling enables gathering profiles from applications.
 # Requires a destination that supports profiles.
 # To see the valid options, please see the [Profiling feature documentation](https://github.com/grafana/k8s-monitoring-helm/tree/main/charts/k8s-monitoring/charts/feature-profiling).
@@ -209,6 +230,8 @@ profiling:
   # @ignored
   collector: alloy-profiles
 
+  # To see additional options, please see the [Profiling feature documentation](https://github.com/grafana/k8s-monitoring-helm/tree/main/charts/k8s-monitoring/charts/feature-profiling).
+
 # -- Service Integrations enables gathering telemetry data for common services and applications deployed to Kubernetes.
 # To see the valid options, please see the [Service Integrations documentation](https://github.com/grafana/k8s-monitoring-helm/tree/main/charts/k8s-monitoring/charts/feature-integrations).
 # @default -- No integrations enabled
@@ -223,6 +246,8 @@ integrations:
   # @ignored
   collector: alloy-metrics
 
+  # To see additional options, please see the [Service Integrations documentation](https://github.com/grafana/k8s-monitoring-helm/tree/main/charts/k8s-monitoring/charts/feature-integrations).
+
 # -- Self-reporting creates a single metric and log that reports anonymized information about how this Helm chart was
 # configured. It reports features enabled, destinations types used, and alloy instances enabled. It does not report any
 # actual telemetry data, credentials or configuration, or send any data to any destination other than the ones
@@ -246,6 +271,7 @@ selfReporting:
 #
 
 # An Alloy instance for collecting metrics.
+# To see additional valid options, please see the [Alloy Helm chart documentation](https://github.com/grafana/alloy/tree/main/operations/helm/charts/alloy).
 alloy-metrics:
   # -- Deploy the Alloy instance for collecting metrics.
   # @section -- Collectors - Alloy Metrics
@@ -349,6 +375,11 @@ alloy-metrics:
       seccompProfile:
         type: "RuntimeDefault"
 
+    # Set resource requests and limits. [Guidelines](https://grafana.com/docs/alloy/latest/introduction/estimate-resource-usage/).
+    # resources:
+    #   requests: {}
+    #   limits: {}
+
   controller:
     # -- The type of controller to use for the Alloy Metrics instance.
     # @section -- Collectors - Alloy Metrics
@@ -371,6 +402,7 @@ alloy-metrics:
   crds: {create: false}
 
 # An Alloy instance for data sources required to be deployed on a single replica.
+# To see additional valid options, please see the [Alloy Helm chart documentation](https://github.com/grafana/alloy/tree/main/operations/helm/charts/alloy).
 alloy-singleton:
   # -- Deploy the Alloy instance for data sources required to be deployed on a single replica.
   # @section -- Collectors - Alloy Singleton
@@ -456,6 +488,11 @@ alloy-singleton:
       seccompProfile:
         type: "RuntimeDefault"
 
+    # Set resource requests and limits. [Guidelines](https://grafana.com/docs/alloy/latest/introduction/estimate-resource-usage/).
+    # resources:
+    #   requests: {}
+    #   limits: {}
+
   controller:
     # -- The type of controller to use for the Alloy Singleton instance.
     # @section -- Collectors - Alloy Singleton
@@ -478,6 +515,7 @@ alloy-singleton:
   crds: {create: false}
 
 # An Alloy instance for collecting log data.
+# To see additional valid options, please see the [Alloy Helm chart documentation](https://github.com/grafana/alloy/tree/main/operations/helm/charts/alloy).
 alloy-logs:
   # -- Deploy the Alloy instance for collecting log data.
   # @section -- Collectors - Alloy Logs
@@ -575,6 +613,11 @@ alloy-logs:
       seccompProfile:
         type: "RuntimeDefault"
 
+    # Set resource requests and limits. [Guidelines](https://grafana.com/docs/alloy/latest/introduction/estimate-resource-usage/).
+    # resources:
+    #   requests: {}
+    #   limits: {}
+
   controller:
     # -- The type of controller to use for the Alloy Logs instance.
     # @section -- Collectors - Alloy Logs
@@ -593,6 +636,7 @@ alloy-logs:
   crds: {create: false}
 
 # An Alloy instance for opening receivers to collect application data.
+# To see additional valid options, please see the [Alloy Helm chart documentation](https://github.com/grafana/alloy/tree/main/operations/helm/charts/alloy).
 alloy-receiver:
   # -- Deploy the Alloy instance for opening receivers to collect application data.
   # @section -- Collectors - Alloy Receiver
@@ -683,6 +727,11 @@ alloy-receiver:
       seccompProfile:
         type: "RuntimeDefault"
 
+    # Set resource requests and limits. [Guidelines](https://grafana.com/docs/alloy/latest/introduction/estimate-resource-usage/).
+    # resources:
+    #   requests: {}
+    #   limits: {}
+
   controller:
     # -- The type of controller to use for the Alloy Receiver instance.
     # @section -- Collectors - Alloy Receiver
@@ -701,6 +750,7 @@ alloy-receiver:
   crds: {create: false}
 
 # An Alloy instance for gathering profiles.
+# To see additional valid options, please see the [Alloy Helm chart documentation](https://github.com/grafana/alloy/tree/main/operations/helm/charts/alloy).
 alloy-profiles:
   # -- Deploy the Alloy instance for gathering profiles.
   # @section -- Collectors - Alloy Profiles
@@ -791,6 +841,11 @@ alloy-profiles:
       runAsGroup: 0
       runAsUser: 0
 
+    # Set resource requests and limits. [Guidelines](https://grafana.com/docs/alloy/latest/introduction/estimate-resource-usage/).
+    # resources:
+    #   requests: {}
+    #   limits: {}
+
   controller:
     # -- The type of controller to use for the Alloy Profiles instance.
     # @section -- Collectors - Alloy Profiles