Menu

This is documentation for the next version of Grafana. For the latest stable release, go to the latest version.

Grafana Cloud Enterprise Open source

What’s new in Grafana v9.2

Welcome to Grafana v9.2, a hefty minor release with a swath of improvements that help you create and share dashboards and alerts. Read on to learn about progress on public dashboards, our new panel help menu, custom branding in Grafana Enterprise, and improvements to access control. If you’d prefer to dig into the details, check out the complete changelog.

Panel help menu

Available in beta in Grafana Open Source.

Dashboard panel issues can occur for all kinds of reasons, from problems processing data to issues with rendering or configuration. Shorten your communication time when reporting issues and requesting help from Grafana Labs by retrieving a panel’s query response data and panel settings. This will help the support team reproduce, diagnose, and fix the issue as quickly as possible. See our documentation for more info.

For details, see GitHub issue #55005 and “Send a panel to Grafana Labs support” in the documentation.

Retrieving a panel's query response data and panel settings
Retrieving a panel’s query response data and panel settings

Canvas panel

Available in beta in Grafana Open Source.

Introducing the Canvas panel, a new panel that combines the power of Grafana with the flexibility of custom elements. Canvas visualizations are extensible form-built panels that allow you to explicitly place elements within static and dynamic layouts. This empowers you to design custom visualizations and overlay data in ways that aren’t possible with standard Grafana panels, all within Grafana’s UI. If you’ve used popular UI and web design tools, then designing Canvas panels will feel very familiar.

For example, you can place image layers and then overlay text that’s updated by Grafana data sources, and display icons that can change color conditionally based on data.

We’ve planned additional features and design elements for future releases to make Canvas panels even more powerful tools for creating custom, interactive, data-driven visualizations. To learn more about the Canvas panel, see the documentation.

Canvas panel beta overview

Support for Google Analytics 4 properties

Generally available in Grafana Open Source.

You can now use Google Analytics 4 (GA4) to track usage of Grafana. To enable tracking with GA4, specify your property’s measurement ID in Grafana’s configuration file. Read more in our documentation.

Google Analytics 4 replaces Universal Analytics, which will stop processing hits in 2023 (July 1 for free accounts, October 1 for Google Analytics 360). You can continue using Universal Analytics with Grafana and send analytics data to both types of properties.

Alertmanager updated to be based on Prometheus Alertmanager v0.24

Generally available in all editions.

The Alertmanager used for Grafana-managed alert rules is now based on the latest release of the Prometheus Alertmanager, v0.24. We continue to unify the different Alertmanagers that you can use with Grafana Alertmanager and will provide updates on this topic in a future release of Grafana.

For details, see GitHub pull request #53555.

Grafana Alerting alert rules now return an Error state by default on execution error or timeout

Generally available in all editions.

Error rules created with Grafana Alerting were previously switching to an Alerting state when the rule was facing an execution error or timeout. New error rules now switch by default to the Error state when failing to execute or timing out. You can change this default to either Alerting or OK.

This change does not update existing alert rules.

For details on this change, see GitHub pull request #55345. For more information about alerting states, see the alerting documentation.

Configure external alertmanagers as data sources

Generally available in all editions.

Starting with release 9.2, the URL configuration of external alertmanagers from the Admin tab on the Alerting page is deprecated. It will be removed in a future release.

External alertmanagers should now be configured as data sources using Grafana Configuration from the main Grafana navigation menu. This enables you to manage the contact points and notification policies of external alertmanagers from within Grafana and also encrypts HTTP basic authentication credentials that were previously visible when configuring external alertmanagers by URL.

Public dashboards

Available in Experimental in Grafana Open Source, Enterprise, and Cloud. To enable public dashboards, you must enable a feature flag or request this feature from support.

Public dashboards launched as an experimental feature in Grafana v9.1. We’ve received lots of great feedback on this much-anticipated feature and thank everyone who has helped us improve it. The team has been hard at work polishing public dashboards, and we’ve closed quite a few bugs related to community reports. If you’re trying out public dashboards, let us know how it is going in the open discussion in GitHub. Beyond bug fixes, we’re excited to share some new features:

Expression support

We have added the ability to use expressions for your public dashboards.

Using expressions in a public dashboard
Using expressions in a public dashboard

Public dashboard usage insights

Available in Experimental in Grafana Enterprise.

Usage Insights now has a “Public Dashboards” tab, which tracks how many people are viewing your public dashboard and how many queries have ran, and counts errors.

Usage Insights for a public dashboard
Usage Insights for a public dashboard

Use RBAC to allow any user to share dashboards publicly

RBAC is available in Grafana Enterprise and Cloud.

We have introduced a new role called “Public Dashboard writer” that grants access to publish new public dashboards to additional roles and users. By default, only admins can share dashboards publicly.

The Public Dashboard writer role for users
The Public Dashboard writer role for users

Revamped UI for Google Cloud monitoring

Generally available in Grafana Open Source and Grafana Cloud Free, Pro, and Advanced.

The Google Cloud monitoring data source UI has been brought up to date with the latest Grafana UI design. This new interface provides a more consistent experience as you switch between different data sources. It also groups query builder items together more logically, so it’s easier to write queries. In the case of Cloud monitoring, the query builder’s groupings should more closely match the groupings in Google’s Cloud console.

Query builder groupings for Google Cloud monitoring
Query builder groupings for Google Cloud monitoring

App Plugins: better handling for secure fields

Plugin developers can mark certain fields as secure to encrypt those fields in Grafana’s database. This is important for sensitive fields like data source passwords or API keys. Previously, plugin developers needed to manually track which fields were labeled secure. We have extended our plugins platform to simplify this, which means one less thing for developers to worry about and better security for all users’ data. For details on using this functionality, see GitHub pull request #55313 and our plugin examples repository.

Transformations: INNER JOINs

Transformations allow you to shape raw data from data sources, like metrics series or GitHub issues, into a format that’s appropriate for the chosen visualization. We have extended the Join transformation to support INNER JOINs in addition to OUTER JOINs. These work similarly to SQL JOINs.

Query builder groupings for Google Cloud monitoring
Query builder groupings for Google Cloud monitoring

Also, you can now click on the x to clear values in the select fields for the OUTER JOIN and Grouping to Matrix transformations as expected.

Simplified UI to create template variable queries for Loki data source

Generally available in Grafana Open Source.

We have significantly simplified and improved the way you can create template variable queries for Loki data sources in dashboards. Use drop-downs to choose query type, label, and stream selector, without needing to worry about templating query syntax. For more information, refer to Loki data source documentation.

Creating a template variable query for Loki
Creating a template variable query for Loki

Authentication and authorization

Teams can be empty or without any Admin user

Generally available in all editions.

You can now leave a team empty without any users, or have only Members in a team. This helps you sync teams and users from a single sign-on provider like Active Directory or Okta, or if you use teams as collections of permissions. Previously, teams required at least one Admin user to be in a team.

Creating a team without an Admin user
Creating a team without an Admin user

Role-based access control is easier to use

Generally available in Grafana Enterprise and Grafana Cloud.

Role picker when creating and editing teams

You can now choose a team’s roles and permissions when creating a new team or editing an existing team, which helps you grant permissions to teams more efficiently. Previously, you could assign roles only when looking at a list of all teams.

Assigning roles to a team when creating it
Assigning roles to a team when creating it

RBAC: Organize custom roles into groups

If you create many custom roles in Grafana – for example, different roles for editing specific dashboards or folders, or specific roles for certain teams in your company – you can now organize them into groups for more efficient navigation, browsing, and custom role assignment. For more information on custom roles, see the documentation.

Organizing custom roles into RBAC groups
Organizing custom roles into RBAC groups

RBAC: Terraform resource for assigning fixed and custom roles to users, teams, and service accounts

You can now assign fixed and custom roles to users, teams, and service accounts with the Grafana role_assignment resource in Terraform. This allows you to provision user permissions in a version-able, repeatable way if you use Terraform. Learn more in the documentation for Grafana’s Terraform provider.

SAML role mapping improvements

Generally available in Grafana Enterprise, Grafana Cloud Pro, and Advanced.

Map a user to all organizations in Grafana

You can now use * as the Grafana organization in the mapping to add all users from a given SAML Organization to all existing Grafana organizations. For more information, see “Configure SAML authentication” in the documentation.

Skip organization role sync

Generally available in Grafana Enterprise, Grafana Cloud Pro, and Advanced.

If you use a SAML identity provider to manage your users but prefer to assign roles and permissions in the Grafana UI or via API, you can now enable a configuration option to skip user organization and roles synchronization with your SAML provider.

Use the skip_org_role_sync configuration option when configuring SAML to prevent synchronization with SAML roles and make user roles editable from within Grafana.

For more information, see the SAML configuration documentation.

Assign Server Admin permissions from Oauth

You can now map OAuth groups and roles to Server Admin for the GitLab, GitHub, AzureAD, Okta, and Generic OAuth integrations. To enable this functionality, set the allow_assign_grafana_admin configuration option to true in the desired OAuth integration section. For more information, see the authentication configuration documentation for each OAuth client.

Match parameter support in prometheus labels API

Prometheus users running Prometheus v2.24 and higher can use the labels endpoint instead of the series endpoint for the label_values function. This decreases load times for templated high-cardinality Prometheus instances.

If you want to benefit from this endpoint you must first configure the Prometheus type and version in any Prometheus data sources’ configuration.

New Prometheus streaming parser

In Grafana v9.2, you can enable the prometheusStreamingJSONParser feature toggle to use a better-performing, memory-efficient streaming JSON client for Prometheus. We’ll make this client the default in Grafana v9.3.

When Prometheus returns NaN values, this new client doesn’t change them, neither to the value null nor to 0 as in recent Grafana versions. If you use this new Prometheus streaming parser with Grafana Managed Alerts, this change in behavior might trigger alerts. To avoid this, select the “Drop non-numeric values” option in the Reduce expression to drop NaN values.