Project: Grafana (Observability and Analysis / Observability)
File: whats-new-in-v9-2.md

aliases: ../guides/whats-new-in-v9-2/ description: Learn about new and updated features in Grafana v9.2 keywords: grafana new documentation '9.2' release notes labels: products: cloud enterprise oss title: What's new in Grafana v9.2 weight: -33 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 . 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 for more info. For details, see and in the documentation. {{< figure src="/static/img/docs/panels/panel-help-9-2.gif" max-width="750px" caption="Retrieving a panel's query response data and panel settings" >}} 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 . {{< video-embed src="/static/img/docs/canvas-panel/canvas-beta-overview-9-2-0.mp4" max-width="750px" caption="Canvas panel beta overview" >}} 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 . 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. 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 . 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 . For more information about alerting states, see the . Generally available in all editions. Starting with release

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. 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. 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 . Beyond bug fixes, we're excited to share some new features: We have added the ability to use for your public dashboards. {{< figure src="/static/img/docs/dashboards/public-dashboards-expressions-9-2.png" max-width="750px" caption="Using expressions in a public dashboard" >}} 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. {{< figure src="/static/img/docs/dashboards/public-dashboards-usage-insights-9-2.png" max-width="750px" caption="Usage Insights for a public dashboard" >}} 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. {{< figure src="/static/img/docs/dashboards/public-dashboards-writer-role-9-2.png" max-width="750px" caption="The Public Dashboard writer role for users" >}} 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. {{< figure src="/static/img/docs/queries/gcloud-data-source-query-grouping-9-2.png" max-width="750px" caption="Query builder groupings for Google Cloud monitoring" >}} 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 and our repository. 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 to support INNER JOINs in addition to OUTER JOINs. These work similarly to SQL JOINs. {{< figure src="/static/img/docs/transformations/transform-outer-join-9-2.png" max-width="750px" caption="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. 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

Use drop-downs to choose query type, label, and stream selector, without needing to worry about templating query syntax. For more information, refer to . {{< figure src="/static/img/docs/queries/loki-template-variable-queries-9-2.png" max-width="750px" caption="Creating a template variable query for Loki" >}} 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. {{< figure src="/static/img/docs/manage-users/member-only-team-9-2.png" max-width="750px" caption="Creating a team without an Admin user" >}} Generally available in Grafana Enterprise and Grafana Cloud. 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. {{< figure src="/static/img/docs/manage-users/team-role-assignment-during-creation-9-2.png" max-width="750px" caption="Assigning roles to a team when creating it" >}} 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 . {{< figure src="/static/img/docs/manage-users/rbac-groups-9-2.png" max-width="750px" caption="Organizing custom roles into RBAC groups" >}} 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 for Grafana's Terraform provider. Generally available in Grafana Enterprise, Grafana Cloud Pro, and Advanced. 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 in the documentation. 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 `skiporgrole_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 . 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 `allowassigngrafana_admin` configuration option to `true` in the desired OAuth integration section. For more information, see the for each OAuth client. Prometheus users running Prometheus v2.24 and higher can use the instead of the for the . 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' . In Grafana v9.2, you can enable the `prometheusStreamingJSONParser` 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.