v5.19.4

This minor release only contains changes to the release pipeline, no functionality has been added or removed
See the v5.19.0 release notes for more details.

v5.19.3

This minor release only contains changes to the release pipeline, no functionality has been added or removed
See the v5.19.0 release notes for more details.

v5.19.2

This minor release only contains changes to the release pipeline, no functionality has been added or removed
See the v5.19.0 release notes for more details.

v5.19.1

This minor release only contains changes to the release pipeline, no functionality has been added or removed
See the v5.19.0 release notes for more details.

v5.19.0

Welcome to release 5.19.0 of the Grafana Operator!

This release features many smaller enhancements, like better status updates for most resources, as well as updating our spec to match changes in dependencies (more fields in alert rule groups, improved ingress & route support etc.).

We're also improving our image signing process. This is the first release after this change so we might push out a new minor release soon if something is not quite working.

Upgrade instructions

Using Helm

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

Using kubectl

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

Using kustomize

flux pull artifact oci://ghcr.io/grafana/kustomize/grafana-operator:v5.19.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.

What's Changed

Features

• feat(Grafana): Status conditions on Grafana resource by @Baarsgaard in #2035
• feat(Grafana): allow Ingress creation on OpenShift by @Baarsgaard in #2041
• feat(Grafana): Add option to disable default pod and/or container securityContexts by @Baarsgaard in #2038
• feat(Grafana): reflect matching NotificationTemplates on Grafanas status by @Baarsgaard in #2049
• feat(Grafana): reflect matching AlertRuleGroups on Grafanas status by @Baarsgaard in #2052
• feat(Controllers): Suspend reconciliation with .spec.suspend=true by @Baarsgaard in #2066
• feat(Grafana): Allow specifying subdomain on routes. .spec.route.subdomain by @Baarsgaard in #2074
• feat: update to grafana 12 by @theSuess in #2111
• feat: add missingSeriesEvalsToResolve to alert rule group spec by @theSuess in #2115
• feat: add keepFiringFor to alert rule group by @theSuess in #2117

Fixes

• fix(dashboard): Recreate dashboard when folderRef is updated by @Baarsgaard in #1994
• fix: correctly check for NotFound in library panel finalizer by @theSuess in #2031
• fix(Grafana): set default .spec.version using Patch to avoid Deployment spec drift by @Baarsgaard in #2037
• support attestation and sbom for multi platform by @nissessenap in #2082
• fix(AlertRuleGroup): default for to 0s by @Baarsgaard in #2094
• fix(Grafana): .spec.config.security.admin_* as fallback for external instances by @Baarsgaard in #2092
• feat: treat no matching instances as error by @theSuess in #2113

Dependencies

• chore(deps): bump the gomod group with 4 updates by @dependabot[bot] in #2011
• chore(deps): bump aquasecurity/trivy-action from 99baf0d8b4e787c3cfd7b602664c8ce60a43cd38 to v0.30.0 by @dependabot[bot] in #2012
• chore(deps): bump sigs.k8s.io/controller-runtime from 0.20.4 to 0.21.0 in the gomod group by @dependabot[bot] in #2028
• chore(deps): bump github.com/go-logr/logr from 1.4.2 to 1.4.3 in the gomod group by @dependabot[bot] in #2033
• chore(deps): bump fluxcd/flux2 from 2.5.1 to 2.6.0 in the gha group by @dependabot[bot] in #2034
• chore(deps): bump the gha group with 2 updates by @dependabot[bot] in #2036
• chore(deps): bump the gha group with 2 updates by @dependabot[bot] in #2044
• chore(deps): bump github.com/KimMachineGun/automemlimit from 0.7.2 to 0.7.3 in the gomod group by @dependabot[bot] in #2045
• chore(deps): bump the gha group with 3 updates by @dependabot[bot] in #2053
• chore(deps): bump the gomod group with 4 updates by @dependabot[bot] in #2054
• chore(deps): bump the gha group with 2 updates by @dependabot[bot] in #2059
• chore(deps): bump aquasecurity/trivy-action from 0.31.0 to 0.32.0 in the gha group by @dependabot[bot] in #2067
• chore(npm deps): Security vulnerabilities warnings on docs site by @Baarsgaard in #2075
• chore(deps): bump fluxcd/flux2 from 2.6.3 to 2.6.4 in the gha group by @dependabot[bot] in #2077
• chore(deps): bump github.com/KimMachineGun/automemlimit from 0.7.3 to 0.7.4 in the gomod group by @dependabot[bot] in #2076
• chore(deps): bump the gomod group with 4 updates by @dependabot[bot] in #2090
• chore(deps): bump sigstore/cosign-installer from 3.9.1 to 3.9.2 in the gha group by @dependabot[bot] in #2091
• chore(deps): bump github.com/onsi/gomega from 1.37.0 to 1.38.0 in the gomod group by @dependabot[bot] in #2103
• chore(deps): bump github.com/prometheus/client_golang from 1.22.0 to 1.23.0 in the gomod group by @dependabot[bot] in #2123

New Contributors

• @raffis made their first contribution in #1964
• @spiarh made their first contribution in #2014

Full Changelog: v5.18.0...v5.19.0

v5.18.0

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

This release adds many fixes for bugs introduced by our refactoring of the caching logic. It also adds an option to scale up the concurrent reconciles for large installations.

Upgrade instructions

Using Helm

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

Using kubectl

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

Using kustomize

flux pull artifact oci://ghcr.io/grafana/kustomize/grafana-operator:v5.18.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.

What's Changed

Features

• feat(Grafana): add ContactPoints to Grafana status field by @Baarsgaard in #1936
• Unit test for syncDatasources by @lexhuismans in #1920
• feat: add new flag max-concurrent-reconciles by @eyazici90 in #1969

Fixes

• fix: remove service monitor from OLM deployment by @theSuess in #1954
• fix: Startup sync counter to track per instance by @Baarsgaard in #1937
• fix(Makefile): properly set new image in deploy target by @weisdd in #1961
• fix(controllers): prevent label and controller reference overrides by @weisdd in #1960
• fix(Grafana): respect HTTP path for external instances by @Baarsgaard in #1970
• chore(Makefile): refactor E2E targets and workflows by @Baarsgaard in #1945

Dependencies

• chore(deps): bump github.com/onsi/gomega from 1.36.3 to 1.37.0 in /api in the gomod group by @dependabot in #1957
• chore(deps): bump ko-build/setup-ko from 0.8 to 0.9 in the gha group by @dependabot in #1956
• chore(deps): bump sigstore/cosign-installer from 3.8.1 to 3.8.2 in the gha group by @dependabot in #1973
• chore(deps): bump golangci/golangci-lint-action from 7.0.0 to 8.0.0 by @dependabot in #1983
• chore(deps): bump the gomod group with 2 updates by @dependabot in #1995
• chore(deps): bump actions/setup-go from 5.4.0 to 5.5.0 in the gha group by @dependabot in #1996
• chore(deps): bump step-security/changed-files from 45.0.1 to 46.0.5 by @dependabot in #1997

New Contributors

• @eyazici90 made their first contribution in #1969

Full Changelog: v5.17.1...v5.18.0

v5.17.1

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

This release mostly contains bugfixes and performance improvements. Most notably, issue #1917 has been fixed, and we have enabled the safe caching mode by default.

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.1
# Upgrading CRDs
kubectl apply --server-side --force-conflicts -f https://github.com/grafana/grafana-operator/releases/download/v5.17.1/crds.yaml

Using kubectl

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

Using kustomize

flux pull artifact oci://ghcr.io/grafana/kustomize/grafana-operator:v5.17.1 --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.

What's Changed

Features

• feat(controllers): enrich instance metrics with instance_namespace label by @Baarsgaard in #1900
• feat(Grafana): add an option to disable default admin secret by @gmlexx in #1916
• feat(runtime): use safe caching mode by default by @weisdd in #1929

Fixes

• fix: add NotificationPolicyRoute to CSV base by @theSuess in #1892
• fix(GrafanaAlertRuleGroup): apply mute_time_intervals by @caiofralmeida in #1909
• fix(GrafanaNotificationPolicy): use patch instead of update when applying the notification policy annotation to avoid Grafana CR drift by @Baarsgaard in #1898
• fix(Grafana): avoid grafana-ini's configmap mount masking the existing files/directories by @wilfriedroset in #1928
• fix(Grafana): do not skip reconciliation if generation is the same as before by @weisdd in #1931
• fix(controllers): retry reconciliation for plugins and home dashboards and fix ownerReferences for plugins and Deployment by @weisdd in #1932
• fix(helm): use datasource variable in all panels of grafana-operator dashboard by @solidDoWant in #1927
• fix: use stricter validation for resyncPeriod by @theSuess in #1951

Dependencies

• chore(deps): bump golangci/golangci-lint-action from 6.5.0 to 6.5.1 in the gha group by @dependabot in #1905
• chore(deps): bump the gomod group with 3 updates by @dependabot in #1904
• chore(deps): bump the gomod group with 2 updates by @dependabot in #1911
• chore(deps): bump golangci/golangci-lint-action from 6.5.1 to 6.5.2 in the gha group across 1 directory by @dependabot in #1914
• chore(deps): bump sigs.k8s.io/controller-runtime from 0.20.3 to 0.20.4 in the gomod group by @dependabot in #1924
• chore(deps): bump the gomod group with 2 updates by @dependabot in #1938
• chore(deps): bump github.com/prometheus/client_golang from 1.21.1 to 1.22.0 in the gomod group by @dependabot in #1946
• chore(deps): bump the gomod group in /api with 7 updates by @dependabot in #1947

New Contributors

• @caiofralmeida made their first contribution in #1909
• @gmlexx made their first contribution in #1916
• @solidDoWant made their first contribution in #1927

Full Changelog: v5.17.0...v5.17.1

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.