v5.17.0

We're proud to announce version 5.17.0 of the Grafana Operator!

Highlights include recording rules, a service for HA configuration, sharding and memory optimizations.
The memory optimizations are currently opt-in. To try them out, configure the ENFORCE_CACHE_LABELS environment variable. See the comments in the helm values for more information.

Upgrade instructions

Using Helm

# Upgrade the operator image & deployment
helm upgrade -i grafana-operator oci://ghcr.io/grafana/helm-charts/grafana-operator --version v5.17.0
# Upgrading CRDs
kubectl apply --server-side --force-conflicts -f https://github.com/grafana/grafana-operator/releases/download/v5.17.0/crds.yaml

Using kubectl

# Namespace Scope
kubectl replace -f https://github.com/grafana/grafana-operator/releases/download/v5.17.0/kustomize-namespace_scoped.yaml
# Cluster Scope
kubectl replace -f https://github.com/grafana/grafana-operator/releases/download/v5.17.0/kustomize-cluster_scoped.yaml 

Using kustomize

flux pull artifact oci://ghcr.io/grafana/kustomize/grafana-operator:v5.17.0 --output ./grafana-operator/

Using OLM

Releases are published to operatorhub.io as well as the OpenShift Operator Catalog. Depending on the installation, existing installations will either upgrade automatically or require approval from an administrator.

Changelog:

Features

• feat(controllers): optionally do not cache resources created without CommonLabels by @Baarsgaard in #1818
• feat(runtime): automatically optimize Go runtime based on cgroup limits by @weisdd in #1839
• feat: Allow to restrict the CRs watched according to their labels by @wilfriedroset in #1832
• feat: enable setting labels just for pods by @diurnalist in #1876
• feat: support top level configuration options by @theSuess in #1886
• feat(GrafanaAlertRuleGroup): add support for Grafana-managed recording rules by @miinsun in #1881
• feat: allow customizing admin url when using k8s service by @diurnalist in #1874

Fixes

• Fix: Apply error condition never registered due to early return by @Baarsgaard in #1837
• Fix: Finalize only deletes datasource from the first instance by @Baarsgaard in #1864
• fix: folder title had to be unique by @jacobcrawford in #1859
• fix: use specified name for dashboard env var using valueFrom by @theSuess in #1869
• fix: include GrafanaLibraryPanel CRD in Kustomize artifacts by @Baarsgaard in #1875
• fix(GrafanaDatasource): don't treat missing datasource as an error when deleting datasource by @lexhuismans in #1879
• fix: correctly set encoder to allow logging settings to be overwritten using CLI flags by @theSuess in #1885
• fix(controllers): set Status in synchronized condition to False when hitting apply errors by @weisdd in #1887

Dependencies

• chore(deps): bump the gomod group with 5 updates by @dependabot in #1829
• chore(deps): bump the gha group with 2 updates by @dependabot in #1830
• chore(deps): bump sigs.k8s.io/controller-runtime from 0.20.0 to 0.20.1 in the gomod group by @dependabot in #1838
• chore(deps): bump the gha group with 3 updates by @dependabot in #1848
• chore(deps): bump golangci/golangci-lint-action from 6.3.1 to 6.5.0 in the gha group by @dependabot in #1866
• chore(deps): bump the gomod group with 6 updates by @dependabot in #1871
• chore(deps): bump the gha group with 2 updates by @dependabot in #1870
• chore(deps): bump fluxcd/flux2 from 2.5.0 to 2.5.1 in the gha group by @dependabot in #1882
• chore(deps): bump the gomod group with 3 updates by @dependabot in #1890

New Contributors

• @msvechla made their first contribution in #1800
• @hectorruiz-it made their first contribution in #1853
• @boris-smidt-klarrio made their first contribution in #1856
• @sentoz made their first contribution in #1863
• @jacobcrawford made their first contribution in #1859
• @synthe102 made their first contribution in #1840
• @wilfriedroset made their first contribution in #1832
• @lexhuismans made their first contribution in #1879
• @Hipska made their first contribution in #1884
• @miinsun made their first contribution in #1881
• @Daniel-Vaz made their first contribution in #1860

Full Changelog: v5.16.0...v5.17.0

v5.16.0

This release adds a bunch of cool features, so be sure to check it out!

Highlights include:

• Grafana 11.3.0 as the new default version
• Support for Notification Templates
• Custom HTTP Headers, which allow for more authentication models and rudimentary multi-org support
• Fetch TLS secrets from different namespaces

Upgrade instructions

Using Helm

# Upgrade the operator image & deployment
helm upgrade -i grafana-operator oci://ghcr.io/grafana/helm-charts/grafana-operator --version v5.16.0
# Upgrading CRDs
kubectl apply --server-side --force-conflicts -f https://github.com/grafana/grafana-operator/releases/download/v5.16.0/crds.yaml

Using kubectl

# Namespace Scope
kubectl replace -f https://github.com/grafana/grafana-operator/releases/download/v5.16.0/kustomize-namespace_scoped.yaml
# Cluster Scope
kubectl replace -f https://github.com/grafana/grafana-operator/releases/download/v5.16.0/kustomize-cluster_scoped.yaml 

Using kustomize

flux pull artifact oci://ghcr.io/grafana/kustomize/grafana-operator:v5.16.0 --output ./grafana-operator/

Using OLM

Releases are published to operatorhub.io as well as the OpenShift Operator Catalog. Depending on the installation, existing installations will either upgrade automatically or require approval from an administrator.

Changelog:

Features

• added support for custom HTTP headers by @xorilog in #1756
• set rule version record limit by default by @weisdd in #1763
• bump grafana to 11.3.0 by @weisdd in #1763
• allow for images in spec.version by @theSuess in #1764
• added support for TLS to support custom secret namespaces by @amimof in #1797
• added 'webex' as valid type for GrafanaContactPoints (#1798) by @FabianWilms in #1799
• add support for notification templates by @chenlujjj in #1775

Fixes

• yaml indentation for ServiceMonitor by @nlamirault in #1757
• remove rules requirement for ingress by @theSuess in #1791
• Use Patch instead of Update to add/remove finalizers by @Baarsgaard in #1801
• GrafanaNotificationPolicy reconcile loop ignoring namespace boundaries by @Baarsgaard in #1815

Dependencies

• chore(deps): bump softprops/action-gh-release from 1 to 2 by @dependabot in #1753
• chore(deps): bump tj-actions/changed-files from 45.0.3 to 45.0.4 in the gha group by @dependabot in #1752
• chore(golang): bump version to 1.23.3 by @weisdd in #1759
• chore(deps): bump the gomod group with 7 updates by @dependabot in #1772
• chore(deps): bump the gha group with 2 updates by @dependabot in #1784
• chore(deps): bump the gomod group across 1 directory with 2 updates by @dependabot in #1785
• chore(deps): bump the gomod group with 5 updates by @dependabot in #1792
• chore(deps): bump github.com/onsi/ginkgo/v2 from 2.22.0 to 2.22.1 in the gomod group by @dependabot in #1802
• chore(deps): bump github.com/onsi/gomega from 1.36.1 to 1.36.2 in the gomod group by @dependabot in #1806
• chore(deps): bump tj-actions/changed-files from 45.0.5 to 45.0.6 in the gha group by @dependabot in #1813
• chore(deps): bump github.com/onsi/ginkgo/v2 from 2.22.1 to 2.22.2 in the gomod group by @dependabot in #1812
• chore(deps): bump sigs.k8s.io/controller-runtime from 0.19.3 to 0.19.4 in the gomod group by @dependabot in #1819

New Contributors

• @xorilog made their first contribution in #1756
• @diurnalist made their first contribution in #1611
• @FabianWilms made their first contribution in #1799

Full Changelog: v5.15.1...v5.16.0

v5.15.1

This release only affects the way we publish helm charts. See the release notes for v5.15.0 for a more comprehensive list.

v5.15.0

What's Changed

Changes

• Adds .svc to internal grafana adminUrl by @amimof in #1713
• Implement spec.uid for GrafanaFolder by @Baarsgaard in #1686
• feat: add Name field to GrafanaAlertRuleGroupSpec by @chenlujjj in #1727
• Implement spec.uid for GrafanaDashboard by @Baarsgaard in #1694
• feat: CEL validation of valuesFrom object ensuring refs are defined by @Baarsgaard in #1729
• Enable forced deletion of GrafanaFolder by @Baarsgaard in #1728
• fix: always use related image if it is a hash by @pb82 in #1733
• refactor: move tls block to spec.client by @theSuess in #1690
• feat: add disableProvenance option to GrafanaAlertRuleGroupSpec by @chenlujjj in #1715
• Add editable field to GrafanaNotificationPolicySpec by @chenlujjj in #1739
• fix: remove logging of override values by @theSuess in #1743
• feat: release helm charts to grafana/helm-charts by @theSuess in #1734

Docs

• docs: refresh home page by @theSuess in #1722
• docs: improve alerting documentation by @theSuess in #1724
• docs: update version in docs by @theSuess in #1705
• docs: add docs on how to change the log encoder using kustomize by @theSuess in #1706
• Move database field in example to jsonData by @michael-os in #1725

Dependencies

• chore(deps): bump github.com/prometheus/client_golang from 1.20.4 to 1.20.5 in the gomod group by @dependabot in #1721
• chore(deps): bump the gomod group with 5 updates by @dependabot in #1731
• chore(deps): bump github.com/onsi/gomega from 1.34.2 to 1.35.1 in the gomod group by @dependabot in #1740

New Contributors

• @amimof made their first contribution in #1713
• @chenlujjj made their first contribution in #1727
• @michael-os made their first contribution in #1725

Full Changelog: v5.14.0...v5.15.0

v5.14.0

What's Changed

Heads up! This release contains a refactoring of the RBAC rules in our deployment templates. If you encounter any permission issues please let us know!

Changes

• Move category annotation to the correct struct in GrafanaDashboard and Grafanas by @Baarsgaard in #1672
• docs: add resync period warning by @theSuess in #1689
• Fix example prometheus datasource by @Tualua in #1698
• feat: contact point overrides by @theSuess in #1670
• feat: add user agent to requests made by operator by @theSuess in #1700
• Add logging options to Helm chart by @Baarsgaard in #1691

Dependencies

• chore(deps): bump the gha group with 2 updates by @dependabot in #1687
• chore(deps): bump the gomod group across 1 directory with 7 updates by @dependabot in #1688
• chore(deps): bump k8s.io/apiextensions-apiserver from 0.31.0 to 0.31.1 in the gomod group by @dependabot in #1702
• chore(deps): bump the gha group with 5 updates by @dependabot in #1701

New Contributors

• @Tualua made their first contribution in #1698

Full Changelog: v5.13.0...v5.14.0

v5.13.0

What's Changed

Changes

• feat(helm): add option to disable rbac creation by @Idotno-1 in #1641
• feat(security): implement tls block for grafana external by @aboulay-numspot in #1628
• fix(helm): allow setting pod labels by @pharaujo in #1649
• feat: basic auth support for dashboards from url by @pb82 in #1617
• fix: sort plugin lists by @theSuess in #1656
• Annotate CRD structs with categories by @Baarsgaard in #1650
• fix: correctly set disableResolveMessage for contact points by @theSuess in #1669
• fix: add common labels to created resources by @theSuess in #1661

Development

• Local yq is not downloaded or referenced properly in Makefile by @Baarsgaard in #1637
• update pinned release documentation by @peterbecich in #1665
• documentation comment about kubectl apply error by @peterbecich in #1668
• docs: Add subfolder for GrafanaDashboard and GrafanaFolder in documentation by @aboulay-numspot in #1629

Dependencies

• chore(deps): bump sigstore/cosign-installer from 3.5.0 to 3.6.0 in the gha group by @dependabot in #1635
• chore(deps): bump tj-actions/changed-files from 44.5.7 to 45.0.0 by @dependabot in #1648
• chore(deps): bump tj-actions/changed-files from 45.0.0 to 45.0.1 in the gha group by @dependabot in #1655
• chore(deps): bump kyverno/action-install-chainsaw from 0.2.8 to 0.2.9 in the gha group by @dependabot in #1667

New Contributors

• @Idotno-1 made their first contribution in #1641
• @Baarsgaard made their first contribution in #1637
• @pharaujo made their first contribution in #1649
• @peterbecich made their first contribution in #1668

Full Changelog: v5.12.0...v5.13.0

v5.12.0

What's Changed

Changes

• feat: add support for notification policies by @theSuess in #1610
• feat: enable pprof endpoint by @theSuess in #1632
• chore: bump version 5.12 by @theSuess in #1634

Dependencies

• chore(deps): bump the gha group with 3 updates by @dependabot in #1631
• chore(deps): bump github.com/onsi/gomega from 1.34.0 to 1.34.1 in the gomod group by @dependabot in #1630

Full Changelog: v5.11.0...v5.12.0

v5.11.0

What's Changed

Changes

• docs: add proposal for grafana dashboard parent folder management by @aboulay-numspot in #1592
• HELM: Enable deploying additional objects with helm chart by @gitbluf in #1607
• feat: add parentFolderRef field in GrafanaFolder by @aboulay-numspot in #1604
• docs: Add proposal for ssl specification in Grafana external block by @aboulay-numspot in #1594
• feat: Add folderUID and folderRef in GrafanaDashboard CRD by @aboulay-numspot in #1601
• fix: remove required attribute from folder conditions by @theSuess in #1624
• fix: requeue on apply errors by @theSuess in #1625
• chore: bump version to 5.11.0 by @theSuess in #1627

Dependencies

• chore(deps): bump kyverno/action-install-chainsaw from 0.2.5 to 0.2.6 in the gha group by @dependabot in #1609
• chore(deps): bump the gomod group with 4 updates by @dependabot in #1615
• chore(deps): bump tj-actions/changed-files from 44.5.5 to 44.5.6 in the gha group by @dependabot in #1616
• chore(deps): bump kyverno/action-install-chainsaw from 0.2.6 to 0.2.7 in the gha group by @dependabot in #1619
• chore(deps): bump github.com/onsi/gomega from 1.33.1 to 1.34.0 in the gomod group by @dependabot in #1620

New Contributors

• @gitbluf made their first contribution in #1607

Full Changelog: v5.10.0...v5.11.0

v5.10.0

What's Changed

Changes

• feat(helm): All recommended Kubernetes labels by @nlamirault in #1538
• chore(codeowners): fix handle for HVBE by @weisdd in #1571
• fix: use controller reference instead of owner reference by @theSuess in #1574
• chore(CRDs): publish full CRDs by @weisdd in #1579
• docs: Fix parameter auth.disable_login_form type in README.md by @bodji in #1568
• fix: reason and log typos by @crflynn in #1586
• fix: use correct error propagation logic in alert rule group handler by @theSuess in #1584
• Update release.yaml to add linux/ppc64le by @whaifang in #1589
• fix: use frontend settings endpoint for version detection by @theSuess in #1583
• Feat: add parentFolderUID field in GrafanaFolder CRD by @aboulay-numspot in #1566
• fix: improve nested folder handling by @theSuess in #1600
• fix: use correct folder uid to update permissions by @timp87 in #1602
• chore: prep for release 5.10.0 by @theSuess in #1603

Dependencies

• chore(deps): bump kyverno/action-install-chainsaw from 0.2.3 to 0.2.4 in the gha group by @dependabot in #1575
• chore(deps): bump sigs.k8s.io/controller-runtime from 0.18.3 to 0.18.4 in the gomod group by @dependabot in #1576
• chore(deps): bump the gomod group with 4 updates by @dependabot in #1582
• chore(deps): bump the gha group across 1 directory with 3 updates by @dependabot in #1598

New Contributors

• @bodji made their first contribution in #1568
• @crflynn made their first contribution in #1586
• @whaifang made their first contribution in #1589

Full Changelog: v5.9.2...v5.10.0

v5.9.2

What's Changed

Changes

• chore(makefile): simplify api-docs generation by @weisdd in #1551
• fix crd release upload by @NissesSenap in #1552
• feat(workflows): e2e matrix, avoid version skew for kubectl by @weisdd in #1550
• Adding Grafana v10 ContactPoint types by @andrejshapal in #1549
• docs: add instructions for terraform installation by @theSuess in #1557
• ci: add merge-group trigger to enable merge queues by @theSuess in #1559
• chore: update default grafana version by @theSuess in #1558
• fix(flux): maintain a copy of CRDs and the ClusterRole in deploy/kustomize/base by @weisdd in #1562
• docs: Create proposal about parent folder management for GrafanaFolder CR by @aboulay-numspot in #1564
• chore: bump version to 5.9.2 in prep for new release by @theSuess in #1565

Dependencies

• chore(deps): bump the gha group with 3 updates by @dependabot in #1556
• chore(deps): bump the gomod group across 1 directory with 6 updates by @dependabot in #1555
• chore(deps): bump the gha group with 2 updates by @dependabot in #1563

New Contributors

• @andrejshapal made their first contribution in #1549
• @aboulay-numspot made their first contribution in #1564

Full Changelog: v5.9.1...v5.9.2