{"id":13510386,"url":"https://github.com/prometheus-operator/kube-prometheus","last_synced_at":"2025-05-11T03:40:32.622Z","repository":{"id":36956257,"uuid":"71823870","full_name":"prometheus-operator/kube-prometheus","owner":"prometheus-operator","description":"Use Prometheus to monitor Kubernetes and applications running on Kubernetes","archived":false,"fork":false,"pushed_at":"2025-05-08T10:46:14.000Z","size":13766,"stargazers_count":7132,"open_issues_count":217,"forks_count":2002,"subscribers_count":66,"default_branch":"main","last_synced_at":"2025-05-08T22:37:50.112Z","etag":null,"topics":["alerts","cluster-monitoring","dashboards","hacktoberfest","kubernetes","operator","prometheus","prometheus-operator"],"latest_commit_sha":null,"homepage":"https://prometheus-operator.dev/","language":"Jsonnet","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/prometheus-operator.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"code-of-conduct.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"docs/security.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2016-10-24T19:20:35.000Z","updated_at":"2025-05-08T22:08:59.000Z","dependencies_parsed_at":"2023-02-18T23:31:12.140Z","dependency_job_id":"3a883a5d-dcba-4a14-ab13-e84f99a62b6c","html_url":"https://github.com/prometheus-operator/kube-prometheus","commit_stats":{"total_commits":2086,"total_committers":344,"mean_commits":6.063953488372093,"dds":0.8657718120805369,"last_synced_commit":"0845950f53a060c69509d05784e829d289f0e463"},"previous_names":["coreos/kube-prometheus"],"tags_count":14,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prometheus-operator%2Fkube-prometheus","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prometheus-operator%2Fkube-prometheus/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prometheus-operator%2Fkube-prometheus/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prometheus-operator%2Fkube-prometheus/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/prometheus-operator","download_url":"https://codeload.github.com/prometheus-operator/kube-prometheus/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253166474,"owners_count":21864467,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["alerts","cluster-monitoring","dashboards","hacktoberfest","kubernetes","operator","prometheus","prometheus-operator"],"created_at":"2024-08-01T02:01:36.953Z","updated_at":"2025-05-11T03:40:32.575Z","avatar_url":"https://github.com/prometheus-operator.png","language":"Jsonnet","readme":"# kube-prometheus\n\n[![Build Status](https://github.com/prometheus-operator/kube-prometheus/workflows/ci/badge.svg)](https://github.com/prometheus-operator/kube-prometheus/actions)\n[![Slack](https://img.shields.io/badge/join%20slack-%23prometheus--operator-brightgreen.svg)](http://slack.k8s.io/)\n[![Gitpod ready-to-code](https://img.shields.io/badge/Gitpod-ready--to--code-blue?logo=gitpod)](https://gitpod.io/#https://github.com/prometheus-operator/kube-prometheus)\n\n\u003e Note that everything is experimental and may change significantly at any time.\n\nThis repository collects Kubernetes manifests, [Grafana](http://grafana.com/) dashboards, and [Prometheus rules](https://prometheus.io/docs/prometheus/latest/configuration/recording_rules/) combined with documentation and scripts to provide easy to operate end-to-end Kubernetes cluster monitoring with [Prometheus](https://prometheus.io/) using the Prometheus Operator.\n\nThe content of this project is written in [jsonnet](http://jsonnet.org/). This project could both be described as a package as well as a library.\n\nComponents included in this package:\n\n* The [Prometheus Operator](https://github.com/prometheus-operator/prometheus-operator)\n* Highly available [Prometheus](https://prometheus.io/)\n* Highly available [Alertmanager](https://github.com/prometheus/alertmanager)\n* [Prometheus node-exporter](https://github.com/prometheus/node_exporter)\n* [Prometheus blackbox-exporter](https://github.com/prometheus/blackbox_exporter)\n* [Prometheus Adapter for Kubernetes Metrics APIs](https://github.com/kubernetes-sigs/prometheus-adapter)\n* [kube-state-metrics](https://github.com/kubernetes/kube-state-metrics)\n* [Grafana](https://grafana.com/)\n\nThis stack is meant for cluster monitoring, so it is pre-configured to collect metrics from all Kubernetes components. In addition to that it delivers a default set of dashboards and alerting rules. Many of the useful dashboards and alerts come from the [kubernetes-mixin project](https://github.com/kubernetes-monitoring/kubernetes-mixin), similar to this project it provides composable jsonnet as a library for users to customize to their needs.\n\n## Prerequisites\n\nYou will need a Kubernetes cluster, that's it! By default it is assumed, that the kubelet uses token authentication and authorization, as otherwise Prometheus needs a client certificate, which gives it full access to the kubelet, rather than just the metrics. Token authentication and authorization allows more fine grained and easier access control.\n\nThis means the kubelet configuration must contain these flags:\n\n* `--authentication-token-webhook=true` This flag enables, that a `ServiceAccount` token can be used to authenticate against the kubelet(s). This can also be enabled by setting the kubelet configuration value `authentication.webhook.enabled` to `true`.\n* `--authorization-mode=Webhook` This flag enables, that the kubelet will perform an RBAC request with the API to determine, whether the requesting entity (Prometheus in this case) is allowed to access a resource, in specific for this project the `/metrics` endpoint. This can also be enabled by setting the kubelet configuration value `authorization.mode` to `Webhook`.\n\nThis stack provides [resource metrics](https://github.com/kubernetes/metrics#resource-metrics-api) by deploying\nthe [Prometheus Adapter](https://github.com/kubernetes-sigs/prometheus-adapter).\nThis adapter is an Extension API Server and Kubernetes needs to be have this feature enabled, otherwise the adapter has\nno effect, but is still deployed.\n\n## Compatibility\n\nThe following Kubernetes versions are supported and work as we test against these versions in their respective branches. But note that other versions might work!\n\n| kube-prometheus stack                                                                      | Kubernetes 1.23 | Kubernetes 1.24 | Kubernetes 1.25 | Kubernetes 1.26 | Kubernetes 1.27 | Kubernetes 1.28 | Kubernetes 1.29 | Kubernetes 1.30 | Kubernetes 1.31 |\n|--------------------------------------------------------------------------------------------|-----------------|-----------------|-----------------|-----------------|-----------------|-----------------|-----------------|-----------------|-----------------|\n| [`release-0.11`](https://github.com/prometheus-operator/kube-prometheus/tree/release-0.11) | ✔               | ✔               | ✗               | x               | x               | x               | x               | x               | x               |\n| [`release-0.12`](https://github.com/prometheus-operator/kube-prometheus/tree/release-0.12) | ✗               | ✔               | ✔               | x               | x               | x               | x               | x               | x               |\n| [`release-0.13`](https://github.com/prometheus-operator/kube-prometheus/tree/release-0.13) | ✗               | ✗               | x               | ✔               | ✔               | ✔               | x               | x               | x               |\n| [`release-0.14`](https://github.com/prometheus-operator/kube-prometheus/tree/release-0.14) | ✗               | ✗               | x               | ✔               | ✔               | ✔               | ✔               | ✔               | ✔               |\n| [`main`](https://github.com/prometheus-operator/kube-prometheus/tree/main)                 | ✗               | ✗               | x               | x               | ✔               | ✔               | ✔               | ✔               | ✔               |\n\n## Quickstart\n\nThis project is intended to be used as a library (i.e. the intent is not for you to create your own modified copy of this repository).\n\nThough for a quickstart a compiled version of the Kubernetes [manifests](manifests) generated with this library (specifically with `example.jsonnet`) is checked into this repository in order to try the content out quickly. To try out the stack un-customized run:\n* Create the monitoring stack using the config in the `manifests` directory:\n\n```shell\n# Create the namespace and CRDs, and then wait for them to be available before creating the remaining resources\n# Note that due to some CRD size we are using kubectl server-side apply feature which is generally available since kubernetes 1.22.\n# If you are using previous kubernetes versions this feature may not be available and you would need to use kubectl create instead.\nkubectl apply --server-side -f manifests/setup\nkubectl wait \\\n\t--for condition=Established \\\n\t--all CustomResourceDefinition \\\n\t--namespace=monitoring\nkubectl apply -f manifests/\n```\n\nWe create the namespace and CustomResourceDefinitions first to avoid race conditions when deploying the monitoring components.\nAlternatively, the resources in both folders can be applied with a single command\n`kubectl apply --server-side -f manifests/setup -f manifests`, but it may be necessary to run the command multiple times for all components to\nbe created successfully.\n\n* And to teardown the stack:\n\n```shell\nkubectl delete --ignore-not-found=true -f manifests/ -f manifests/setup\n```\n\n### minikube\n\nTo try out this stack, start [minikube](https://github.com/kubernetes/minikube) with the following command:\n\n```shell\n$ minikube delete \u0026\u0026 minikube start --container-runtime=containerd --kubernetes-version=v1.32.3 --memory=6g --bootstrapper=kubeadm --extra-config=kubelet.authentication-token-webhook=true --extra-config=kubelet.authorization-mode=Webhook --extra-config=scheduler.bind-address=0.0.0.0 --extra-config=controller-manager.bind-address=0.0.0.0\n```\n\nThe kube-prometheus stack includes a resource metrics API server, so the metrics-server addon is not necessary. Ensure the metrics-server addon is disabled on minikube:\n\n```shell\n$ minikube addons disable metrics-server\n```\n\n## Getting started\n\nBefore deploying kube-prometheus in a production environment, read:\n\n1. [Customizing kube-prometheus](docs/customizing.md)\n2. [Customization examples](docs/customizations)\n3. [Accessing Graphical User Interfaces](docs/access-ui.md)\n4. [Troubleshooting kube-prometheus](docs/troubleshooting.md)\n\n## Documentation\n\n1. [Continuous Delivery](examples/continuous-delivery)\n2. [Update to new version](docs/update.md)\n3. For more documentation on the project refer to `docs/` directory.\n\n## Contributing\n\nTo contribute to kube-prometheus, refer to [Contributing](CONTRIBUTING.md).\n\n## Join the discussion\n\nIf you have any questions or feedback regarding kube-prometheus, join the [kube-prometheus discussion](https://github.com/prometheus-operator/kube-prometheus/discussions). Alternatively, consider joining [the kubernetes slack #prometheus-operator channel](http://slack.k8s.io/) or project's bi-weekly [Contributor Office Hours](https://docs.google.com/document/d/1-fjJmzrwRpKmSPHtXN5u6VZnn39M28KqyQGBEJsqUOk/edit#).\n\n## License\n\nApache License 2.0, see [LICENSE](https://github.com/prometheus-operator/kube-prometheus/blob/main/LICENSE).\n","funding_links":[],"categories":["Jsonnet","prometheus","Kubernetes Monitoring","HarmonyOS","kubernetes","K8S-Tools"],"sub_categories":["Tools","Windows Manager"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprometheus-operator%2Fkube-prometheus","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fprometheus-operator%2Fkube-prometheus","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprometheus-operator%2Fkube-prometheus/lists"}