docs/sources/whatsnew/whats-new-in-v10-0.md
Welcome to Grafana 10.0! Read on to learn about changes to search and navigation, dashboards and visualizations, and security and authentication.
For even more detail about all the changes in this release, refer to the changelog. For the specific steps we recommend when you upgrade to v10.0, check out our Upgrade Guide.
<!-- Template below ## Feature <!-- Name of contributor --> <!-- [Generally available | Available in private/public preview | Experimental] 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). {{< admonition type="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 [Links and references](/docs/writers-toolkit/writing-guide/references/). {{< /admonition >}} -->For Grafana v10.0, we've also provided a list of breaking changes to help you upgrade with greater confidence. For information about these along with guidance on how to proceed, refer to Breaking changes in Grafana v10.0.
Available in public preview in all editions of Grafana.
You can now bring context from multiple data sources into the Explore experience. Correlations is an extension of our existing data links functionality and now enables you to link from any data source to any other data source.
Correlations enable you to seamlessly jump from one data source to another. You define relationships between your different data sources; when you're using Explore, simply click a button next to a related field in one data source and Grafana will run the corresponding query in the other data source.
Correlations is currently in preview. As such, we recommended you only enable it on test or development instances, rather than in production environments.
To try out Correlations, enable the correlations feature toggle. If you’re using Grafana Cloud and would like to enable this feature, please contact customer support.
In subsequent releases, we’ll be refining and enhancing the user interface for Correlations, to provide a more streamlined user experience.
Available in public preview in all editions of Grafana.
Scenes is a new front-end library by Grafana that empowers Grafana plugin developers to effortlessly build stunning dashboard-like experiences into their Grafana app plugins. With Scenes, you can easily create apps that mirror the Grafana dashboarding experience, complete with template variable support, flexible layouts, dynamic panel rendering, and so much more.
To try it out, go to the @grafana/scenes repository.
To learn more, refer to the Scenes documentation.
Available in public preview in all editions of Grafana.
You can now try out creating subfolders in Grafana for organizing your dashboards and alerts. You can enable this new feature in your development environment to create, read, update, and delete subfolders, making it easier to sort resources by business units, departments, and teams.
You can also set up permissions using Role-Based Access Control (RBAC). Folder permissions cascade, being inherited from the parent folder, which simplifies access management.
The ability to add subfolders is currently in preview, with more functionality coming in subsequent releases. This includes creating subfolders using Terraform, and displaying the full folder tree when creating and moving resources through Grafana’s UI. We recommend that you enable this feature only on test or development instances, rather than in production environments.
To get started creating subfolders, enable the nestedFolders feature toggle. If you’re using Grafana Cloud, and would like to enable this feature, please contact customer support.
{{< figure src="/media/docs/grafana/screenshot-grafana-10.0-nested-folders-2.png" max-width="750px" caption="Subfolders in Grafana" >}}
Generally available in all editions of Grafana.
<!-- Nathan Marrs -->We're promoting the canvas panel out of public preview and into general availability. Over the past several months we've introduced multiple enhancements to the panel such as the ability to draw connections between elements, the ability to set the color and size of connections based on data, and the ability to add data links. We're excited to include Canvas as a first class citizen in Grafana’s core panel library. To learn more about the panel, refer to our Canvas documentation. Also, check out our latest blog post about canvas.
{{< figure src="/media/docs/grafana/screenshot-grafana-10-0-canvas-service-graph.png" max-width="750px" caption="Canvas service graph" >}}
Experimental in all editions of Grafana
The Trends panel allows you to display trends where the x-axis is numeric and not time. This experimental panel addresses gaps that were not solved by either the Time series or XY Chart panels. For example, you can plot function graphs, rpm/torque curves, supply/demand relationships, and more. To learn more about the Trend panel, refer to the Trend documentation.
{{< figure src="/media/docs/grafana/screenshot-grafana-10-0-trend-panel-new-colors.png" max-width="750px" caption="Trend engine power and torque curves" >}}
Experimental in all editions of Grafana
Datagrid is a new panel that allows you to edit your data within a Grafana dashboard. Imagine having a spreadsheet-like view where you can fine-tune data pulled from a data source or create your own dataset from scratch and use it within your dashboard to update your panels in real time. That's what Datagrid provides. You can also use the Datagrid panel as a data source used by other panels to augment other data.
Currently, the Datagrid Panel supports the following features in Grafana version 10.0:
In subsequent releases, we’ll continue adding features to the Datagrid panel to further improve the user experience.
Experimental in all editions of Grafana
<!-- Oscar Kilhed -->It's easier than ever to view local data in Grafana: introducing drag and drop. The drag and drop functionality allows you to upload your csv, Excel, or numbers files by simply dragging and dropping them into the query editor of the Grafana data source.
To try out drag and drop, enable the editPanelCSVDragAndDrop feature toggle.
As of Grafana version 10.0, drag and drop supports the following scenarios:
The data from dragged and dropped files is stored in the dashboard JSON and file size is limited to 1MB. To learn more about drag and drop functionality, refer to the official documentation.
Generally available in all editions of Grafana.
Concepts like data sources and dashboard panels are hard to grasp and it can be a struggle to go from Grafana’s “empty state” to a working dashboard that displays data. Our latest advancements streamline the process of selecting the ideal data source in Grafana, prioritizing recent usage, and providing labels and supplementary descriptions.
With this flow, selecting a data source has been greatly simplified, providing a clear overview of available data sources and allowing you to quickly connect to a new one when needed.
{{< video-embed src="/media/docs/grafana/screen-recording-ds-picker-whats-new-10-final.mp4" max-width="750px" caption="Datasource picker flow" >}}
Generally available in all editions of Grafana.
<!-- Nathan Marrs -->We've implemented support for adding time regions to the Time series panel. Time regions provide a more contextualized experience, enabling you to highlight certain days of the week, such as Monday to Friday to display work weeks, right alongside your data. Time regions are also a useful way to highlight specific parts of a day like night, work hours, or whatever you want to define for each day. They allow you to quickly orient yourself in parts of the day or ignore highlighted parts of the time series.
To learn more, refer to our time region documentation.
{{< figure src="/media/docs/grafana/screenshot-grafana-10-0-time-regions.png" max-width="750px" caption="Time regions" >}}
Generally available in all editions of Grafana.
<!-- Nathan Marrs -->You can now filter dashboard annotations to apply annotations to all panels or selected panels, or use them to exclude selected panels.
To learn more, refer to our documentation about adding annotation queries.
{{< figure src="/media/docs/grafana/screenshot-grafana-10-0-annotation-filtering.png" max-width="750px" caption="Annotation filtering" >}}
Generally available in all editions of Grafana.
<!-- Sven Grossman -->We've made enhancements to Grafana's log context feature, resulting in a more seamless and consistent user experience. With the updated user interface, you can expect the same level of functionality and usability in log context as you would in any other logs panel.
Notably, we've added the following new features that streamline the log context experience:
{{< figure src="/media/docs/grafana/log-context-loki-2-whats-new-10-0-.png" max-width="750px" caption="Grafana Log Context" >}}
These improvements make working with log context in Grafana more intuitive and efficient, ultimately improving the overall user experience.
Generally available in all editions of Grafana.
You can now query multiple data sources simultaneously in Explore. Select "Mixed" from the data source picker and specify a data source for each query.
If you’re using Grafana Open Source or Enterprise, you can disable this feature using the exploreMixedDatasource feature toggle.
Available in public preview in all editions of Grafana.
Public dashboards allow you to share your Grafana dashboard with anyone without requiring them to log in to Grafana. This is useful when you want to make your dashboard available to the world.
With this update, we've made the following improvements:
To try it out, enable the publicDashboards feature toggle. If you’re using Grafana Cloud, and would like to enable this feature, please contact customer support.
To learn more, refer to our public dashboards documentation.
Available in public preview in Grafana Enterprise, Cloud Pro, and Cloud Advanced.
Public dashboards insights provide valuable information about your public dashboard usage. You can easily access and view important metrics such as the daily query count, the number of views in the last 30 days, and the number of errors in the last 30 days.
To try it out, enable the publicDashboards feature toggle. If you’re using Grafana Cloud, and would like to enable this feature, please contact customer support.
Available in public preview in Cloud Pro and Cloud Advanced.
Our email sharing feature allows you to easily share your public dashboards and make them visible only with specific individuals. When you add their email addresses, they receive a one-time link to access the dashboard. This provides you with greater control over who can view your public dashboards.
We've also added a Public dashboard users tab in Administration > Users where you can view a list of users who have accessed your public dashboards by way of email sharing.
To try it out, please contact customer support.
{{< admonition type="note" >}}
This feature will have a cost by active users after being promoted into general availability.
{{< /admonition >}}
To learn more, refer to our public dashboards documentation.
Generally available in Grafana Enterprise, Cloud Pro, and Cloud Advanced.
You can now configure SAML using our new user interface, making the process easier and more convenient than ever before. With the new user interface (UI), you can now configure SAML without needing to restart Grafana and you can control access to the configuration UI by using role-based access control (RBAC), which makes the process much faster and more efficient.
The SAML UI is available in Grafana Enterprise, Cloud Pro, and Advanced. It's user-friendly, with clear instructions and helpful prompts to guide you through the process.
For more information on how to set up SAML using the Grafana UI, refer to Configure SAML authentication using the Grafana user interface.
Generally available in all editions of Grafana.
Usernames and email addresses are now treated as case-insensitive, which means that you no longer need to worry about capitalization when logging in or creating an account.
From now on, whether you type your username or email address in uppercase, lowercase, or a combination of both, Grafana will treat them as the same. This simplifies the login process and reduces the risk of typos and identity conflicts when changing authentication providers.
To help you deal with potential user identity conflicts, we've built a Grafana CLI user identity conflict resolver tool, which is available from Grafana version 9.3.
{{< admonition type="note" >}}
If you're running Grafana with MySQL as a database, this change doesn't have any impact as MySQL users were already treated as case-insensitive.
{{< /admonition >}}
Available in public preview in Grafana Cloud Free, Cloud Pro, and Cloud Advanced.
You can now work much more efficiently with traces that consist of a large number of spans with span filtering.
Span filters exist above the trace view and allow you to filter the spans that are shown in the trace view. The more filters you add, the more specifically span are filtered.
Currently, you can add one or more of the following filters:
Span filtering is currently in preview. As such, it's recommended to enable it only on test or development instances, rather than in production environments.
To try it out, enable the newTraceViewHeader feature toggle. This feature is enabled by default in Grafana Cloud.
Generally available in all editions of Grafana.
We've started the work to migrate to OpenTelemetry in Grafana version 8.4; now we're removing OpenTracing and, for those who still have it configured, replacing it under the hood with OpenTelemetry. These changes are backwards compatible, so you don't need to change anything and the feature will continue working as it did before.
Generally available in all editions of Grafana.
The Azure Monitor data source now supports visualizing Application Insights Traces. A new query type, Traces, has been added to the service list. This can be used against Application Insights resources to query and visualize traces in both a tabular format and using the built-in Traces visualization.
This also includes support for a new Azure API that will correlate trace IDs against all Application Insights resources that are accessible to the principal that the data source is configured with. To support this feature, a new query builder has been added with support for querying the Application Insights resource using an Operation ID or visualizing and filtering the data based on the event type and a subset of the properties available on the trace.
Experimental in Grafana Open Source.
The Prometheus data source now supports delta (incremental) querying, in which values from data frames are cached and leveraged to modify future requests to avoid requesting duplicate values in dashboards with now-relative (that is, any dashboard querying until "now") queries. This feature is disabled by default as it is still experimental, but can be enabled and configured in the Prometheus data source configuration.
This update will reduce network load, and speed up now-relative dashboards, especially for dashboards returning a lot of data.
Generally available in all editions of Grafana.
We've renamed the Phlare data source Grafana Pyroscope data source as part of the ongoing unification of the Phlare and Pyroscope projects. This data source supports both Phlare and Pyroscope backends. Existing instances of the data source should not be affected. When you create a new instance of the data source, the backend type will be autodetected on the configuration page, or you can select it manually.
Generally available in all editions of Grafana.
Data types are now being defined to create a data plane layer between producers and consumers of data. By defining data types as part of Grafana's platform, plugin and application developers can use these data types to achieve more reliable interoperability across the platform.
Learn more:
All Alerting features are generally available in all editions of Grafana.
Use the improved State history view to get insight into how your alert instances behave over time. View information on when a state change occurred, what the previous state was, the current state, any other alert instances that changed their state at the same time, as well as what the query value was that triggered the change.
{{< figure src="/media/docs/alerting/state-history.png" max-width="750px" caption="State history view" >}}
Preview how your notification templates will look before using them in your contact points.
{{< figure src="/media/docs/alerting/template-preview.png" max-width="750px" caption="Preview notification templates" >}}
Experimental in all editions of Grafana.
Use trusted types to reduce the risk of XSS vulnerabilities, including the sanitization of third party libraries or plugins that have not explicitly performed sanitization.
To use this feature in report-only mode:
content_security_policy_report_only in the configuration.require-trusted-types-for 'script'; to the content_security_policy_report_only_template.To use it in enforce mode:
content_security_policy in the configuration.require-trusted-types-for 'script'; to the content_security_policy_template.This is an experimental web technology with limited browser support.
Available in public preview in Grafana Cloud Pro and Advanced.
Some data sources, like MySQL databases, Prometheus instances or Elasticsearch clusters, run in private networks, like on premises networks or virtual private clouds (VPCs) running in AWS, GCP, or Azure.
To query these data sources from Grafana Cloud, you've had to open your private network to a range of IP addresses, a non-starter for many IT Security teams. The challenge is, how do you connect to your private data from Grafana Cloud, without exposing your network?
The answer is Private Data Source Connect (PDC), available now in public preview in Grafana Cloud Pro and Advanced. PDC uses SOCKS over SSH to establish a secure connection between a lightweight PDC agent you deploy on your network and your Grafana Cloud stack. PDC keeps the network connection totally under your control. It’s easy to set up and manage, uses industry-standard security protocols, and works across public cloud vendors and a wide variety of secure networks. Learn more in our Private data source connect documentation.
We've added support for using react-router v6 in app plugins. However, we still support the use of react-router v5 for plugins that need to support a minimum Grafana version earlier than v10. For more information, refer to our react-router migration guide.