Skip to content

Upgrade deprecated Grafana Helm chart to grafana-community/grafana #4447

@markmandel

Description

@markmandel

Problem

The Grafana Helm chart we currently use (grafana/grafana from https://grafana.github.io/helm-charts) has been deprecated. Running make minikube-setup-grafana now produces:

WARNING: This chart is deprecated

The chart was migrated to grafana-community/helm-charts effective January 30, 2026. Updates and support are now only provided in the new repository.

What needs to change

1. build/Makefile

Update the setup-grafana target (line ~914) to use the new repo and chart:

  • Old repo: helm repo add grafana https://grafana.github.io/helm-charts
  • New repo: helm repo add grafana-community https://grafana-community.github.io/helm-charts
  • Old chart: helm upgrade grafana grafana/grafana ...
  • New chart: helm upgrade grafana grafana-community/grafana ...

The uninstall-grafana target should not need changes since it references the release name, not the chart.

2. build/grafana.yaml and build/grafana-frontend.yaml

Review these values files for compatibility with the new chart. Known breaking changes across major versions:

  • v7.0.0: global.image.registry renamed to global.imageRegistry
  • v10.0.0: Static alerting resources now support Helm templating — template expressions like {{ $labels.instance }} must be escaped
  • v11.0.0: Minimum Kubernetes version increased to 1.25; deprecated API references removed

Our current values (service port, tolerations, affinity, sidecar dashboards, plugins, datasources) should be compatible, but this should be verified by installing the new chart and confirming dashboards load correctly.

3. Documentation: site/content/en/docs/Guides/metrics.md

The Grafana Installation section references the old chart and repo. Update:

  • The repo link text from "Grafana Community Kubernetes Helm Charts" URL https://grafana.github.io/helm-charts/ to https://grafana-community.github.io/helm-charts
  • The helm repo add and helm upgrade commands to use grafana-community instead of grafana
  • The Google Cloud Managed Prometheus section also references the Grafana installation, but since it says "Install Grafana as above", it should not need separate changes

Guidance for contributors

This is a good first issue if you're new to the project. Here's how to test:

  1. Follow the Agones development guide to set up a local environment
  2. Make the changes to the Makefile and docs
  3. Run make minikube-setup-prometheus then make minikube-setup-grafana (or the equivalent for your dev cluster)
  4. Verify the deprecation warning is gone
  5. Port-forward Grafana (kubectl port-forward deployments/grafana 3000 -n metrics) and confirm dashboards load with data
  6. Run make site-server to verify the docs render correctly

Metadata

Metadata

Assignees

No one assigned

    Labels

    area/build-toolsDevelopment tooling. I.e. pretty much everything in the `build` directory.good first issueThese are great first issues. If you are looking for a place to start, start here!help wantedWe would love help on these issues. Please come help us!kind/cleanupRefactoring code, fixing up documentation, etc

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions