Documentation Grafana Cloud Monitor infrastructure Kubernetes Monitoring Configure Kubernetes Monitoring Configure with Helm chart Helm chart overview

Overview of Grafana Kubernetes Monitoring Helm chart

The Grafana Kubernetes Monitoring Helm chart offers a complete solution for configuring infrastructure, automatic instrumentation, and gathering telemetry. The benefits of using this chart include:

• Flexible architecture
• Compatibility with existing systems such as OpenTelemetry and Prometheus Operators
• Scalability for all Cluster sizes
• Built-in testing and schemas to help you avoid errors

Release notes

Refer to Helm chart release notes for all updates.

Container image security

The container images deployed by the Kubernetes Monitoring Helm chart are built and managed by the following subcharts. The Helm chart itself uses a dependency updating system to ensure that the latest version of the dependent charts are used. Subchart authors are responsible for maintaining the security of the container images they build and release.

• Grafana Alloy
• Grafana Beyla
• Node Exporter
• Windows Exporter
• kube-state-metrics
• OpenCost
• Kepler

Packages installed with Helm chart

The Grafana Kubernetes Monitoring Helm chart deploys a complete monitoring solution for your Cluster. It includes all of the following systems along with the configuration to make these systems run. These elements are kept up to date in the Kubernetes Monitoring Helm chart with a dependency updating system to ensure that the latest versions are used.

Infrastructure metrics

The Helm chart installs an Alloy metrics StatefulSet which will retrieve Cluster metrics from:

• kubelet, the primary Node agent which ensures containers are running and healthy
• cadvisor, which provides container CPU, memory, and disk usage
• Node Exporter, which provides hardware device and kernel-related metrics from Linux Nodes. The exported Prometheus metrics indicate the health and state of Nodes in the Cluster.
• Windows Exporter, which provides hardware device and kernel-related metrics from Windows Nodes. The exported Prometheus metrics indicate the health and state of Nodes in the Cluster.
• kube-state-metrics, which listens to the API server and generates metrics on the health of objects such as Deployments, Nodes, and Pods. This service generates metrics from Kubernetes API objects, and uses client-go to communicate with Clusters. For Kubernetes client-go version compatibility and any other related details, refer to kube-state-metrics.
• Prometheus Operator CRDs, which gathers metrics on Pods, services, and containers

This Alloy instance can also gather metrics from:

• OpenCost, to calculate Kubernetes infrastructure and container costs. OpenCost requires Kubernetes 1.8+ Clusters.
• Kepler for energy metrics

Infrastructure logs

The following collectors retrieve logs:

• An Alloy Deployment for Cluster events, to get events from the API server and transform them into logs

• An Alloy DaemonSet to retrieve Pod logs and Node logs

Application telemetry

The Helm chart also includes the following to gather metrics, logs, traces, and profiles from applications running in the Cluster:

• An Alloy DaemonSet, which opens receiver ports to process data delivered directly to itself from applications instrumented with OpenTelemetry SDKs

• An Alloy DaemonSet to gather profiles

Automatic instrumentation

With the Helm chart, you can install a Grafana Beyla DaemonSet to automatically instrument applications and gather network metrics.

Deployment

When you use the easy deployment process in Kubernetes Monitoring, the Grafana Kubernetes Monitoring Helm chart is adjusted based on your choices for configuration. As improvements are made to Kubernetes Monitoring, the Helm chart is updated as well.

After you have made configuration choices, the values.yaml file is altered to reflect your selections for configuration. When you deploy the chart with the command available in the easy deploy GUI, the chart installs the appropriate elements. Separate instances of Alloy deploy so that there are no issues with scaling.

After deployment, you can check the Metrics status tab under Configuration. This page provides a snapshot of the overall health of the metrics being ingested.

Customization

You can also customize the chart for your specific needs and tailor it to specific Cluster environments. For example:

• Your configuration might already have an existing kube-state-metrics in your Cluster, so you don’t want the Helm chart to install another one.
• Enterprise clusters with many workloads running can have specific requirements.

For links to examples for customization, refer to the Customize the Kubernetes Monitoring Helm chart.

Troubleshoot

Refer to Troubleshooting for any issues that occur after configuration.

Metrics management

To learn more about managing metrics, refer to Metrics management and control.