Grafana Kubernetes Monitoring
Grafana Kubernetes Monitoring is a core Grafana Cloud feature that allows you to view all of your Kubernetes data in one place. If you are shipping kube-state-metrics
to Grafana Cloud, you will be able to inspect the health of your clusters, containers, and pods with little or no required configuration. You can also access pre-configured dashboards, alert rules, and recording rules.

Grafana Kubernetes Monitoring installation
To get started with Grafana Kubernetes Monitoring, and to get pre-configured dashboards and alerts, go to the Cluster navigation tab, click Install dashboards and rules, and follow the instructions. For more information, or to view installation instructions before installation, see Configuring Kubernetes monitoring.
NOTE: You must have the Admin role to install and configure dashboards and alert rules.
If you don’t want to use the pre-configured Agent manifests, you can manually deploy and scrape kube-state-metrics
. The following metrics are required to use the cluster navigation feature:
- kube_namespace_status_phase
- container_cpu_usage_seconds_total
- kube_pod_status_phase
- kube_pod_start_time
- kube_pod_container_status_restarts_total
- kube_pod_container_info
- kube_pod_container_status_waiting_reason
- kube_daemonset.\*
- kube_replicaset.\*
- kube_statefulset.\*
- kube_job.\*
NOTE: Logs are not required for Kubernetes Monitoring to work, but they will provide additional context in some views of the cluster navigation. Log entries must be shipped to a Loki data source with
cluster
,namespace
, andpod
labels.
Manual installation
If you would like to manually connect your Kubernetes data to Grafana Cloud see the following topics:
Agent installation quickstart guides will show you how to directly deploy Grafana Agent for metrics, logs, and traces.
Kubernetes Agent Operator (beta) is a simple way to deploy and configure Grafana Agent using a Prometheus-style operator and Kubernetes custom resources. It is currently in beta, and is subject to change at any time.
Use remote_write to ship Prometheus metrics if you have an existing Prometheus deployment, and want to ship your Kubernetes metrics to Grafana Kubernetes Monitoring.
Cluster navigation
In the Cluster navigation page, you can can view all of the namespaces and clusters of the data source you choose in the dropdown menu. You can also view the namespace phase status, and click on the number of firing alerts to quickly navigate to Grafana Alerting. You can continue to drill down through namespaces, workloads, and pods.

Configure Grafana Kubernetes Monitoring
Users with the Admin role can use the Configuration tab to install or uninstall pre-configured dashboards and alerts. You can also view instructions to configure and deploy Grafana Agent to keep it up-to-date. For more information on updating your dashboards and rules, see Update Grafana Kubernetes components.
Note: In order to see Agent configuration instructions, you must have the pre-configured dashboards and alerts installed.
TNS Demo App Walkthrough
Learn how to deploy an instrumented three-tier (data layer, app logic layer, load-balancing layer) web application into a Kubernetes cluster, and leverage Grafana Cloud’s built-in Kubernetes features for monitoring this application.
To get started, see Kubernetes Monitoring walkthrough.
Related Grafana Cloud resources
Intro to Prometheus and Grafana Cloud
Prometheus is taking over the monitoring world! In this webinar, we will start with a quick introduction to the open source project that’s the de facto standard for monitoring modern, cloud native systems.
How to set up and visualize synthetic monitoring at scale with Grafana Cloud
Learn how to use Kubernetes, Grafana Loki, and Grafana Cloud’s synthetic monitoring feature to set up your infrastructure's checks in this GrafanaCONline session.
Using Grafana Cloud to drive manufacturing plant efficiency
This GrafanaCONline session tells how Grafana helps a 75-year-old manufacturing company with product quality and equipment maintenance.