prometheus-operator /prometheus-operator

Prometheus Operator creates/configures/manages Prometheus clusters atop Kubernetes

★ 9,995⑂ 3,892👁 132⑃ 5,577● 3,184▤ 176
GoApache-2.0Created 2016-09-22prometheus-operator.dev
Download: 0.95.2 / 2026-11-100.95.2 ↓0.95.22026-11-12
-1
Daily
9,995
stars
3,892
forks
132
watchers
5,577
prs
3,184
issues
176
releases

README

Prometheus Operator






 Overview

The Prometheus Operator provides Kubernetes native deployment and management of
Prometheus and related monitoring components. The purpose of this project is to
simplify and automate the configuration of a Prometheus based monitoring stack for Kubernetes clusters.

The Prometheus operator includes, but is not limited to, the following features:

 Kubernetes Custom Resources: Use Kubernetes custom resources to deploy and manage Prometheus, Alertmanager,
  and related components.

 Simplified Deployment Configuration: Configure the fundamentals of Prometheus like versions, persistence,
  retention policies, and replicas from a native Kubernetes resource.

 Prometheus Target Configuration: Automatically generate monitoring target configurations based
  on familiar Kubernetes label queries; no need to learn a Prometheus specific configuration language.

For an introduction to the Prometheus Operator, see the getting started guide.

 Project Status

The operator in itself is considered to be production ready. Please refer to the Custom Resource Definition (CRD) versions for the status of each CRD:

 monitoring.coreos.com/v1: stable CRDs and API, changes are made in a backward-compatible way.
 monitoring.coreos.com/v1beta1: unstable CRDs and API, changes can happen but the team is focused on avoiding them. We encourage usage in production for users that accept the risk of breaking changes.
 monitoring.coreos.com/v1alpha1: unstable CRDs and API, changes can happen frequently, and we suggest avoiding its usage on mission-critical environments.

 Prometheus Operator vs. kube-prometheus vs. community Helm chart

 Prometheus Operator

The Prometheus Operator uses Kubernetes custom resources to simplify the deployment and configuration of Prometheus, Alertmanager, and related monitoring components.

 kube-prometheus

kube-prometheus provides example configurations for a complete cluster monitoring
stack based on Prometheus and the Prometheus Operator. This includes deployment of multiple Prometheus and Alertmanager instances,
metrics exporters such as the node_exporter for gathering node metrics, scrape target configuration linking Prometheus to various
metrics endpoints, and example alerting rules for notification of potential issues in the cluster.

 Helm chart

The prometheus-community/kube-prometheus-stack
Helm chart provides a similar feature set to kube-prometheus. This chart is maintained by the Prometheus community.
For more information, please see the chart's readme

 Prerequisites

The Prometheus Operator requires at least Kubernetes version 1.16.0. If you
are just starting out with the Prometheus Operator, it is highly recommended to
use the latest stable
release.

 CustomResourceDefinitions

A core feature of the Prometheus Operator is to monitor the Kubernetes API server for changes
to specific objects and ensure that the current Prometheus deployments match these objects.
The Operator acts on the following Cu

Top issues

Discussions

Latest release

0.95.2 / 2026-11-10 v0.95.2 2026-11-12
[BUGFIX] Fix container images for all platforms/architectures other than linux/amd64. 8971

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON