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

description: Learn about new and updated features in Grafana v9.5 keywords: grafana new documentation '9.5' release notes labels: products: cloud enterprise oss title: What's new in Grafana v9.5 weight: -36 Welcome to Grafana 9.5! We're excited to share some major updates to Grafana's navigation, tons of usability improvements to Alerting, and some promising experiments to help you query your Prometheus metrics. Also, read on to learn about our continued migration from API keys to service accounts, as well as deprecation of plugins that use Angular and a field in the InfluxDB data source. For more detail about all the changes in this release, refer to the . For the specific steps we recommend when you upgrade to v9.5, check out our . <!-- Template below [Generally available | Available in experimental/beta] in Grafana [Open Source, Enterprise, Cloud Free, Cloud Pro, Cloud Advanced] Description. Include an overview of the feature and problem it solves, and where to learn more (like a link to the docs). Note: You must use relative references when linking to docs within the Grafana repo. Please do not use absolute URLs. For more information about relrefs, refer to .--> Generally available in all editions of Grafana. The navigation in Grafana has been updated with a new design and an improved structure to make it easier for you to access the data you need. With this update, you can quickly navigate between pages, giving you full visibility into the health of your systems. As Grafana evolved from a visualization platform to a comprehensive observability solution, we added numerous tools to support users throughout the software development life cycle. These tools focus on preventing incidents, monitoring applications or infrastructure, and aiding incident response. However, the added functionality must be easily discoverable and navigable to be truly helpful. These key updates to Grafanas navigation experience help address this: A redesigned navigation menu that groups related tools together for easy access. A command palette you can use to take actions in Grafana, like creating a dashboard or navigating to an app or page. Updated layouts featuring breadcrumbs and a sidebar, allowing you to quickly jump between pages. A new header that appears on all pages in Grafana, which includes a search function. Join the and share your feedback. {{< figure src="/media/docs/grafana/navigation-9-4.png" max-width="750px" caption="Grafana new navigation" >}} Generally available in all editions of Grafana. Dashboards have been updated so that its easier to begin building from scratch. The options displayed when you add a new dashboardadding a visualization, a row, or importing panelseach include brief explanations of what those steps will do, so you can begin building with confidence. Also, a text Add dropdown with these options has replaced the previous "+" icon at the top of the

This makes it clearer that this element allows you not only to add new panels, but to take all the actions associated with building a new dashboard. {{< figure src="/media/docs/grafana/screenshot-empty-dashboard-whats-new-9-5.png" max-width="750px" caption="Dashboard without any visualizations added" >}} Generally available in all editions of Grafana. Dashboard panels contain a lot of information, some of which is difficult to discover or access from the dashboard. With our redesigned panels, we've improved accessibility and made it easier to understand the status of a panel by adding and moving key elements. Weve improved panels without titles, made panel descriptions and errors more succinct, and linked key actions from the header of the panel. All of these are laid out from left to right in a row, so there are no overlapping, unusable components. Grafanas new panel design is available only for React-based panels. No Angular-based panels, like the legacy Graph and Worldmap panels, are redesigned. As a reminder, Angular is deprecated in Grafana and will be removed in a future release. See our for more information. {{< figure src="/media/docs/grafana/panel-redesign-whats-new-9.5.png" max-width="750px" caption="Panel header with open menu" >}} Experimental in all editions of Grafana. When you have thousands (or millions) of Prometheus metrics, it can be hard to find the exact one you're looking for. Enable feature toggle `prometheusMetricEncyclopedia` to replace the basic metric select dropdown in the Prometheus query builder with a paginated and searchable metric encyclopedia. Here's what you can do with the metric encyclopedia: Fuzzy search for metrics by name, type, and description Filter metrics by Prometheus types (gauge, counter, histogram, summary) Display metrics in a paginated list, sort the results, and choose a number of results per page, so that you don't wait a long time for search results View metric details, like type and description [Expert feature] Search metric names by regex using the backend only Experimental in all editions of Grafana. New feature toggle `prometheusResourceBrowserCache` provides the ability to cache Prometheus editor API calls in the Prometheus data source configuration. This improves Prometheus query editor performance, with the biggest performance improvements seen by users with high cardinality Prometheus instances. With this update we are going one step further in deprecating API keys in favor of . We've removed the button for creating new API keys through Grafana's user interface, and now only allow the creation of API keys using our HTTP API. We recommend that you migrate your existing API keys to service accounts, and opt for new service accounts instead of new API keys. This change is part of our long-term strategy for sunsetting API keys. Learn more about the deprecation strategy for API keys and how to manage them in our GitHub issue. Generally available in all editions of

Support bundles provide a simple way to collect information about your Grafana instance through Grafana's user interface. In a few clicks, you can create a support bundle containing data about migrations, plugins, settings, and more. Once you've created a support bundle, you can either examine it yourself, or share it with your colleagues or Grafana engineers to aid in troubleshooting of your Grafana instance. Learn more about support bundles and how to configure them in our . {{< figure src="/static/img/docs/troubleshooting/support-bundle.png" max-width="750px" caption="Create a support bundle to resolve issues faster" >}} All Alerting improvements are generally available in all editions of Grafana. Search for and display alert rules for multiple data sources at the same time. Search for namespaces or folders, evaluation groups, and alert rule names on the Alert rules list view with immediate results, and regardless of typos. Navigate to an alert rule directly from a dashboard or a panel to easily access the alert rule details. {{< figure src="/media/docs/alerting/alert-rule-dashboard.png" max-width="750px" caption="Access an alert rule from a dashboard or a panel" >}} Navigate from an alert rule straight to a dashboard or a panel associated with the alert rule to visualize your alerting data. {{< figure src="/media/docs/alerting/dashboard-alert-rule-2.png" max-width="750px" caption="Access a dashboard or panel from an alert rule" >}} Visualize queries when creating or editing recording rules, so you can see the results of your query before saving your recording rule. {{< figure src="/media/docs/alerting/preview-queries-recording-rule.png" max-width="750px" caption="Preview queries for recording rules" >}} Alert rules that are configured to fire when an evaluation returns no data now only fire when the entire duration of the evaluation period has finished. This means that rather than immediately firing when the alert rule condition is breached, the alert rule waits until the time set in the For field has finished and then fires, reducing alert noise and allowing for temporary data availability issues. Updates to the Notification policies view make it easier to use and manage in the following ways: View default policy and nested policies at a glance New tab for mute timings View alert instances for each policy View contact points and which integrations are configured for each policy View inherited properties on nested policies Search for label matchers and for contact points to see which notifications are going where {{< figure src="/media/docs/alerting/notification-policies-view.png" max-width="750px" caption="Improved Notification policies view" >}} Get additional help while configuring your Alertmanager. If you enter an invalid Alertmanager configuration, an error message displays, and you can choose from a previous working configuration to restart it. The `database` field in the provisioning file has been deprecated. This information will be stored in the `jsonData` field using the `dbName` property. The `database` field will be removed in the future to make InfluxDB consistent with other data sources. For more information and examples please refer to the

Generally available in all editions of Grafana. Grafana v9.4 provided the ability to configure synchronization of organization roles for each OAuth provider. With synchronization on, the organization role was applied to the user from the OAuth provider upon signing in. However, after the user signed in, you could still change the users organization role during the session. With this release, we are reinforcing organization role syncing behavior by introducing a new feature toggle called `onlyExternalOrgRoleSync`. Once enabled, users signing in to Grafana cannot change organization roles that have been synchronized from an external authentication provider, like Active Directory or Google OAuth. This can help ensure the right users maintain the right level of access at all times. This feature should be used if you want to enforce strict role synchronization from your auth provider to the organization roles. To use this feature, enable the `onlyExternalOrgRoleSync` feature toggle. If youre using Grafana Cloud and would like to enable this feature, please contact customer support. We'll also be automatically enabling this feature for Grafana Cloud instances over the upcoming weeks. You can also prevent the synchronization of organization roles from a given authentication provider. Learn more in our ! documentation. Generally available in Grafana Enterprise, Cloud Pro, and Cloud Advanced. We updated the reporting UI to better fit the new navigation style, adding a horizontal slider and moving the Preview and Send buttons to the Action section in the page. We also fixed the alignment of the different sections. {{< figure src="/media/docs/grafana/Screenshot-newUI-report.png" max-width="750px" caption="New Grafana report UI" >}} Experimental in Grafana Open Source and Enterprise. This feature adds support for using JWT tokens to store rendering keys instead of relying on remote caching. It covers most rendering use cases, though some still rely on the remote cache as a store. You can enable this by enabling the feature flag `renderAuthJWT` in the `custom.ini` configuration file. One of the major changes coming in Grafana 10 will be our upgrade to React 18 and use of the new React client rendering API. There are many significant benefits we gain from this: access to new React features like and concurrent rendering, as well as other general performance and security improvements. These changes have now been delivered to the core `grafana` repo with . As with any major upgrade, there's a potential for this to impact the way your plugin works. In particular, there could be unintended side effects caused by the changes around improving consistency with `useEffect` timings and automatic batching of state updates. Recommended actions: Review the React 18 Test your plugins against one of the latest (for example, ) Add a comment to the if your plugin is impacted in any way. Either to socialise the changes needed for your plugin or to reach out and ask for help yourself.