Prometheus and Grafana: The Complete Setup Guide for Production Monitoring

Introduction

Prometheus and Grafana have become the de facto open-source monitoring stack for cloud native environments. Prometheus collects and stores time-series metrics from applications and infrastructure. Grafana visualizes those metrics in rich, interactive dashboards. Together, they provide a powerful, cost-effective monitoring solution that rivals expensive commercial alternatives. This guide walks you through setting up a production-ready Prometheus and Grafana monitoring stack.

 

Installing Prometheus on Kubernetes

The recommended way to run Prometheus on Kubernetes is using the kube-prometheus-stack Helm chart, which installs Prometheus, Grafana, Alertmanager, and a comprehensive set of Kubernetes monitoring dashboards and alerting rules. Install the chart with a custom values file that configures storage, retention, and resource requests appropriate for your environment. For production, use a persistent volume for Prometheus storage to prevent data loss when Prometheus Pods restart.

 

Instrumenting Applications with Prometheus

For Prometheus to collect metrics from your application, your application must expose a metrics endpoint that Prometheus can scrape. Most modern frameworks have Prometheus client libraries available. In Go, the prometheus/client_golang library provides simple instrumentation. In Python, prometheus-client exposes a metrics endpoint. In Node.js, prom-client is widely used. Expose metrics at a standard path like /metrics, which Prometheus scrapes on a configured interval.

 

Writing Effective Prometheus Queries

PromQL, the Prometheus Query Language, is powerful but has a learning curve. The most common patterns include rate(), which calculates the per-second rate of change of a counter; histogram_quantile(), which calculates percentile latency from histogram metrics; and up{}, which shows which Prometheus targets are currently being successfully scraped. Learn these core patterns and the label selection syntax, and you will be able to answer most operational questions about your systems.

 

Building Effective Grafana Dashboards

Effective Grafana dashboards are focused and actionable. The USE method — Utilization, Saturation, Errors — provides a framework for system-level dashboards. The RED method — Rate, Errors, Duration — provides a framework for service-level dashboards. Use template variables to make dashboards reusable across services and environments. Set appropriate panel refresh rates — high-frequency panels consume more browser resources. Export dashboards as JSON and store them in version control.

 

Alerting with Alertmanager

Prometheus’ Alertmanager handles alert routing, grouping, and notification. Define alerting rules in Prometheus that fire when metrics cross defined thresholds. Alertmanager routes these alerts to the appropriate notification channels — PagerDuty for high-severity production alerts, Slack for lower-severity informational alerts. Configure alert grouping to prevent alert storms during incidents, and set inhibition rules to suppress lower-severity alerts when a higher-severity alert is already firing.

 

Conclusion

Prometheus and Grafana provide a powerful foundation for production monitoring that can scale to handle large, complex environments. Setting them up correctly requires investment, but the operational visibility they provide is essential for reliability. Our Prometheus and Grafana setup and monitoring services help organizations operationalize these tools at scale. Visit our Prometheus Grafana monitoring tutorials blog for more guides.