Skip to content

Values reference

A flat-as-possible reference for the top-level keys in prometheus-stack/values.yaml. For deep tables (every individual key under prometheus.prometheusSpec, alertmanager.config, etc.), the upstream chart README is the authoritative source — this page only summarizes the structure and the OVES-specific defaults in the vendored copy.

Generated file size

The vendored values.yaml in deployment-charts/prometheus-stack/ is roughly 5000 lines / 169 KB. Do not edit it inline as your team's "live" config. Instead, keep an values.overrides.yaml file in your environment repo and pass it with helm install -f.

Top-level keys

Key Default in this repo Notes
nameOverride "monitoring" OVES override of upstream default "". Resources are named with this prefix.
namespaceOverride "monitoring" OVES override of upstream default "".
kubeTargetVersionOverride "" Force a specific K8s minor for rule selection. Leave empty to autodetect.
kubeVersionOverride "" Force chart-level K8s detection.
fullnameOverride "" Full name override.
commonLabels {} Labels added to every chart-rendered resource.
crds.enabled true Install the Operator CRDs.
defaultRules.create true Ship the default PrometheusRule bundle.
defaultRules.rules.* per-group toggles See Customization » Disabling default rules.
additionalPrometheusRulesMap {} Inline custom PrometheusRules.
global.imageRegistry "" Override registry for all images.
global.imagePullSecrets [] Pull secrets used by all subcharts.
global.rbac.create true Whether to create chart-level RBAC.
windowsMonitoring.enabled false Toggle Windows nodes monitoring.
prometheus-windows-exporter.* (subchart defaults) Pass-through to Windows exporter.
alertmanager.enabled true Deploy Alertmanager.
alertmanager.config.* upstream default routing Replace with your own routes / receivers.
alertmanager.alertmanagerSpec.* upstream default Pod spec Storage, replicas, resources, image.
alertmanager.ingress.enabled false Toggle ingress for Alertmanager UI.
grafana.enabled true Deploy Grafana subchart.
grafana.adminPassword prom-operator (rotate this!) Admin password. Prefer grafana.admin.existingSecret.
grafana.defaultDashboardsEnabled true Ship the bundled Kubernetes dashboards.
grafana.persistence.enabled (subchart default) Persist Grafana data.
grafana.ingress.enabled false Toggle ingress for Grafana.
grafana.sidecar.dashboards.* enabled Sidecar that auto-loads dashboard ConfigMaps.
grafana.additionalDataSources [] Extra datasources (Loki, Tempo, ...).
kubernetesServiceMonitors.enabled true Master toggle for the bundled control-plane ServiceMonitors.
kubeApiServer.enabled true ServiceMonitor for kube-apiserver.
kubelet.enabled true ServiceMonitor for kubelet (and cAdvisor).
kubeControllerManager.enabled true Disable on managed clusters.
kubeScheduler.enabled true Disable on managed clusters.
kubeProxy.enabled true Disable when using a kube-proxy replacement.
kubeEtcd.enabled true Disable on managed clusters.
coreDns.enabled true ServiceMonitor for CoreDNS.
kubeDns.enabled false Legacy kube-dns; usually disabled.
kubeStateMetrics.enabled true Master toggle for kube-state-metrics.
kube-state-metrics.* (subchart defaults) Pass-through values for kube-state-metrics.
nodeExporter.enabled true Master toggle for node-exporter.
prometheus-node-exporter.* (subchart defaults) Pass-through values for node-exporter.
prometheusOperator.enabled true The operator itself. Required.
prometheusOperator.admissionWebhooks.enabled true Validating webhook for PrometheusRule.
prometheusOperator.tls.enabled true TLS for the webhook.
prometheus.enabled true Deploy a Prometheus CR.
prometheus.prometheusSpec.* upstream default Prometheus spec The bulk of your real configuration. See dedicated subsections below.
prometheus.ingress.enabled false Toggle ingress for Prometheus UI.
thanosRuler.enabled false Optional ThanosRuler CR.
cleanPrometheusOperatorObjectNames false Renaming knob for legacy installs.
extraManifests [] Free-form list of additional Kubernetes manifests rendered alongside the chart.

Most-edited subsections

prometheus.prometheusSpec

prometheus:
  prometheusSpec:
    replicas: 2
    shards: 1
    retention: 30d
    retentionSize: ""
    image: { tag: "" }              # pin to override
    storageSpec:
      volumeClaimTemplate: { ... }
    resources: { ... }
    externalLabels: {}              # cluster, environment, ...
    ruleSelector: {}                # which PrometheusRule to pick up
    serviceMonitorSelector: {}      # which ServiceMonitor to pick up
    podMonitorSelector: {}          # which PodMonitor to pick up
    probeSelector: {}
    scrapeConfigSelector: {}
    additionalScrapeConfigs: []     # raw scrape jobs, last resort
    remoteWrite: []                 # ship to Thanos / Cortex / Mimir
    remoteRead: []
    enableFeatures: []              # e.g. ["exemplar-storage"]

alertmanager.config

alertmanager:
  config:
    global:
      resolve_timeout: 5m
    route:
      receiver: "default"
      group_by: ["alertname", "namespace"]
      routes: [ ... ]
    receivers:
      - name: "default"
        slack_configs: [ ... ]
    inhibit_rules: [ ... ]
    templates: [ ... ]

alertmanager.alertmanagerSpec

alertmanager:
  alertmanagerSpec:
    replicas: 3
    storage:
      volumeClaimTemplate: { ... }
    resources: { ... }
    image: { tag: "" }
    externalUrl: "https://alerts.example.com"
    routePrefix: "/"

Source files in the repo

  • deployment-charts/prometheus-stack/values.yaml — defaults for this installation.
  • deployment-charts/prometheus-stack/Chart.yaml — chart and subchart versions.
  • deployment-charts/prometheus-stack/README.md — the upstream chart's full values reference (very long).
  • deployment-charts/prometheus-stack/templates/ — the actual Helm templates that consume these values.