Prometheus Community Helm Charts
repository·main·Indexed 27 days ago
https://github.com/prometheus-community/helm-chartsOfficial Kubernetes Helm charts maintained by the Prometheus community, providing standardized deployment templates for Prometheus-related components. Includes charts for kube-prometheus-stack, Alertmanager, jiralert, and alertmanager-snmp-notifier, with support for OCI registries and traditional Helm repositories.
What's inside prometheus-community-helm-charts
- This Helm chart bootstraps a Prometheus deployment on a Kubernetes cluster. Prometheus is a CNCF project used for systems and service monitoring, collecting metrics from targets, evaluating rule expressions, and triggering alerts.
Access prometheus-conntrack-stats-exporter via OCI or Helm Repository
mainThe chart is available through two distribution methods:
- OCI Artifact:
oci://ghcr.io/prometheus-community/charts/prometheus-conntrack-stats-exporter - Helm Repository:
https://prometheus-community.github.io/helm-charts(chart name:prometheus-conntrack-stats-exporter)
- OCI Artifact:
Access Prometheus Windows Exporter via OCI or Helm Repository
mainThe chart is available through two distribution methods:
- OCI Artifact:
oci://ghcr.io/prometheus-community/charts/prometheus-windows-exporter - Helm Repository:
https://prometheus-community.github.io/helm-charts(chart name:prometheus-windows-exporter)
- OCI Artifact:
Access Prometheus SQL Exporter via OCI or Helm Repository
mainThe chart is available through two distribution methods:
- OCI Artifact:
oci://ghcr.io/prometheus-community/charts/prometheus-sql-exporter - Helm Repository:
https://prometheus-community.github.io/helm-charts(chart name:prometheus-sql-exporter)
- OCI Artifact:
Upgrade the Prometheus Blackbox Exporter chart
mainUse the
helm upgradecommand to update your existing release. Use the--installflag to ensure the chart is installed if it doesn't already exist.helm upgrade [RELEASE_NAME] [CHART] --installMigrate to Prometheus Elasticsearch Exporter v4.0.0
mainThe chart was renamed from
stable/elasticsearch-exportertoprometheus-elasticsearch-exporter. To maintain existing resource names (likeServiceorDeployment) during an upgrade, usefullnameOverrideandnameOverride.Example for a release named
my-exporter:helm upgrade my-exporter . --set fullnameOverride=my-exporter-elasticsearch-exporter --set nameOverride=elasticsearch-exporterInstall the Prometheus MongoDB Exporter chart
mainThe chart is distributed as an OCI Artifact. You can install it using the following command. Ensure you provide a
[RELEASE_NAME]and configure the necessary MongoDB connection settings (see Configuration section).helm install [RELEASE_NAME] oci://ghcr.io/prometheus-community/charts/prometheus-mongodb-exporterMigrate from stable/prometheus-operator with downtime (Redeploy with new name)
mainTo migrate and change the name prefix (which requires downtime), follow these steps. This guide assumes the deployment is in the
monitoringnamespace.Patch the existing PV to use a
Retainreclaim policy:kubectl patch pv/<PersistentVolume name> -p '{"spec":{"persistentVolumeReclaimPolicy":"Retain"}}'Uninstall the old release and delete the PVC:
helm uninstall prometheus-operator -n monitoring kubectl delete pvc/<PersistenceVolumeClaim name> -n monitoringNote: You must also manually delete the
prometheus-operator-kubeletservice in thekube-systemnamespace.Make the PV Available: Remove the
spec.claimReffrom the PV so it can be re-bound:kubectl patch pv/<PersistentVolume name> --type json -p='[{"op": "remove", "path": "/spec/claimRef"}]' -n monitoringFresh Installation: Install
kube-prometheus-stackensuring thevolumeClaimTemplate(storage size, access modes, andstorageClassName) matches your old configuration.
Important: Ensure the new pods are scheduled in the same Availability Zone (AZ) as the old PV. You can enforce this using
prometheus.prometheusSpec.nodeSelectorin yourvalues.yaml:nodeSelector: failure-domain.beta.kubernetes.io/zone: east-west-1aUpgrade the prometheus-modbus-exporter chart
mainUpgrade an existing release or install it if it does not exist.
Command:
helm upgrade [RELEASE_NAME] [CHART] --installUpgrade kube-prometheus-stack from 43.x to 44.x
mainThis upgrade updates Prometheus-Operator to v0.62.0, Prometheus to v2.41.0, and Thanos to v0.30.1. You must update the CRDs using
kubectl apply --server-sidebefore applying the Helm upgrade.Breaking Changes
- Admission Webhooks: If you have explicitly set
prometheusOperator.admissionWebhooks.failurePolicy, this value is now always used even when.prometheusOperator.admissionWebhooks.patch.enabledistrue(the default). - Image Tags: The values for
prometheusOperator.image.tagandprometheusOperator.prometheusConfigReloader.image.tagare now empty by default; the Chart.yamlappVersionfield is used instead.
kubectl apply --server-side -f https://raw.githubusercontent.com/prometheus-operator/prometheus-operator/v0.62.0/example/prometheus-operator-crd/monitoring.coreos.com_alertmanagerconfigs.yaml kubectl apply --server-side -f https://raw.githubusercontent.com/prometheus-operator/prometheus-operator/v0.62.0/example/prometheus-operator-crd/monitoring.coreos.com_alertmanagers.yaml kubectl apply --server-side -f https://raw.githubusercontent.com/prometheus-operator/prometheus-operator/v0.62.0/example/prometheus-operator-crd/monitoring.coreos.com_podmonitors.yaml kubectl apply --server-side -f https://raw.githubusercontent.com/prometheus-operator/prometheus-operator/v0.62.0/example/prometheus-operator-crd/monitoring.coreos.com_probes.yaml kubectl apply --server-side -f https://raw.githubusercontent.com/prometheus-operator/prometheus-operator/v0.62.0/example/prometheus-operator-crd/monitoring.coreos.com_prometheuses.yaml kubectl apply --server-side -f https://raw.githubusercontent.com/prometheus-operator/prometheus-operator/v0.62.0/example/prometheus-operator-crd/monitoring.coreos.com_prometheusrules.yaml kubectl apply --server-side -f https://raw.githubusercontent.com/prometheus-operator/prometheus-operator/v0.62.0/example/prometheus-operator-crd/monitoring.coreos.com_servicemonitors.yaml kubectl apply --server-side -f https://raw.githubusercontent.com/prometheus-operator/prometheus-operator/v0.62.0/example/prometheus-operator-crd/monitoring.coreos.com_thanosrulers.yaml- Admission Webhooks: If you have explicitly set
Upgrade kube-prometheus-stack from 18.x to 19.x
mainThe configuration keykubeStateMetrics.serviceMonitor.namespaceOverridehas been removed. Usekube-state-metrics.namespaceOverrideinstead.Test the kube-prometheus-stack setup on Minikube
mainYou can locally test the
kube-prometheus-stacksetup using Minikube. The configuration in thehack/minikubedirectory provides a way to set up components and create a working etcd scrape configuration.To get a local working Minikube cluster, run the commands contained in
cmd.shin the exact sequence listed within the script.Windows Users: If you are running on Windows, locate the commented-out section within the script and add those specific flags/commands to your
minikubecommand to ensure compatibility.