Skip to main content
After deploying your Kubernetes cluster on bare metal, it’s important to set up monitoring to track its health and performance. This guide walks you through installing and configuring Prometheus and Grafana to collect metrics, visualize data, and set up alerts for your Kubernetes environment. Let’s get started!

​
Prerequisites

  • A running Kubernetes cluster.
  • kubectl configured.
  • Helm 3 installed on your local machine.
Verify your cluster is ready: 
kubectl cluster-info

​
Step 1: Add the Prometheus Helm repository

helm repo add prometheus-community https://prometheus-community.github.io/helm-charts

helm repo update

​
Step 2: Install the Prometheus stack

Install everything (Prometheus, Grafana, Alertmanager) with one command: 
helm install monitoring prometheus-community/kube-prometheus-stack
This uses default settings and creates a full monitoring stack.

​
Step 3: Verify installation

1

Check pods status

Check if all pods are running:
kubectl get pods
You should see the pods of the monitoring stack running:
> kubectl get pods -n monitoring
NAME                                                        READY   STATUS    RESTARTS   AGE
alertmanager-kube-prometheus-stack-alertmanager-0           2/2     Running   0          53s
kube-prometheus-stack-grafana-76649cf75d-r4x7k              3/3     Running   0          3m6s
kube-prometheus-stack-kube-state-metrics-77899fc47f-xmkhf   1/1     Running   0          3m6s
kube-prometheus-stack-operator-6b6c6f966d-hrsjk             1/1     Running   0          3m6s
kube-prometheus-stack-prometheus-node-exporter-dcwzq        1/1     Running   0          3m6s
prometheus-kube-prometheus-stack-prometheus-0               2/2     Running   0          3m6s
2

Check services

Check the services:
kubectl get services -n monitoring
This will show the created services for the monitoring stack and their assigned IPs.

​
Step 4: Access the Grafana dashboard

By default, Grafana is only accessible from within the cluster. Use port forwarding to view it locally.
1

Set up port forwarding

Run the following command to forward the port:
kubectl port-forward svc/kube-prometheus-stack-grafana -n monitoring 3000:80
2

Open Grafana

Open http://localhost:3000 in your browser.
3

Login with default credentials

Log in with the default credentials:
  • Username: admin
  • Password: prom-operator
Grafana login screenIf you need to retrieve the password:
kubectl get secret kube-prometheus-stack-grafana -n monitoring -o jsonpath="{.data.admin-password}" | base64 --decode; echo

​
Step 5: Confirm Prometheus as a data source

The kube-prometheus-stack automatically sets up Prometheus as a data source in Grafana. To check:
1

Login to Grafana

Login to Grafana.
2

Go to Data Sources

Go to Connections > Data Sources.
3

Confirm Prometheus

Confirm Prometheus is listed.Grafana data sources

​
Step 6: Explore dashboards

Grafana includes several pre-built dashboards out of the box. To access them:
1

Navigate to dashboards

Click Dashboards in the sidebar.
2

Browse available dashboards

Select Browse.
For a high-level overview, start with Kubernetes / Compute Resources / Cluster. This dashboard provides insights into:
  • Overall cluster CPU, memory, and filesystem usage.
  • Pod and container performance.
  • System service metrics.
Grafana Kubernetes dashboard

​
Step 7: Set up basic alerts

Alertmanager is already included as part of the kube-prometheus-stack. To manage alerts:
1

View alerts

In Grafana, go to Alerting > Alert Rules. View existing alerts or create new ones.
2

Configure contact points

To receive alerts:Go to Alerting > Contact points. Click Create contact point. Set up notifications (email, Slack, etc.).Grafana contact points

​
Done!

You now have a working monitoring setup for your Kubernetes cluster. For advanced dashboards or deeper integration, check out the Prometheus and Grafana documentation.