prometheus-operator /prometheus-operator
Prometheus Operator creates/configures/manages Prometheus clusters atop Kubernetes
★ 9,995⑂ 3,892👁 132⑃ 5,577● 3,184▤ 176
-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
#2398[Feature idea/request] Create alertmanager silences via CRD28 comments · 2019-02-12#3875Handling statefulset recreation without user facing downtime22 comments · 2021-02-24#3288Introduce requirement entry to CHANGELOG for all PRs21 comments · 2020-06-17#6508Support for RemoteWrite CRD18 comments · 2024-04-14#5495Support different PrometheusAgent deployment models18 comments · 2023-04-12#6432Allow users to use OTEL Kubernetes semantic conventions17 comments · 2024-03-25#4200Support basic_auth_users in web configuration for Prometheus and Alertmanager17 comments · 2021-08-04#3587Ability to control Readiness probe & Liveness probe17 comments · 2020-10-13
Discussions
#8959Alerting with Prometheus in agent mode: working setup with ThanosRuler (small homelab)0 comments · 2026-11-07#8617Set securityContext when installing from Operatorhub / via OLMv0?1 comments · 2026-06-11#8515Deprecation of `bearerTokenFile`1 comments · 2026-04-16#8328We have two Prometheus replicas deployed in one cluster, and only one of them performs Remote Write at any given time. Could anyone share how to implement this with the Operator?1 comments · 2026-01-27#8090Migration help: tools / best practices to convert prometheus.yaml → Prometheus Operator CRs2 comments · 2025-11-12#7565AlertManager throwing the error "A client certificate used to authenticate to kubernetes apiserver is expiring in less than 24.0 hours on cluster"1 comments · 2025-05-26#7550Problem while installing prometheus1 comments · 2025-05-21#7499Fix github action CI failure1 comments · 2025-05-06
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