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

description: Learn about new and updated features in Grafana v10.1 keywords: grafana new documentation '10.1' release notes labels: products: cloud enterprise oss title: What's new in Grafana v10.1 weight: -38 Welcome to Grafana 10.1! Read on to learn about changes to dashboards and visualizations, data sources, security and authentication and more. We're particularly excited about a set of improvements to visualizing logs from and other logging data sources in Explore mode, and our Flame graph panel, used to visualize profiling data from and other continuous profiling data sources. For even more detail about all the changes in this release, refer to the . For the specific steps we recommend when you upgrade to v10.1, check out our . <!-- Template below <!-- 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 . {{% /admonition %}} --> <!-- Add an image, GIF or video as below {{< figure src="/media/docs/grafana/dashboards/WidgetVizSplit.png" max-width="750px" caption="DESCRIPTIVE CAPTION" >}} Learn how to upload images here: https://grafana.com/docs/writers-toolkit/write/image-guidelines/#where-to-store-media-assets --> Generally available in all editions of Grafana <!-- Andrej Ocenas --> We've added four new features to the Flame graph visualization: Sandwich view: You can now show a sandwich view of any symbol in the flame graph. Sandwich view shows all the callers on the top and all the callees of the symbol on the bottom. This is useful when you want to see the context of a symbol. Switching color scheme: You can now switch color scheme between a color gradient based on the relative value of a symbol or by the package name of a symbol. Switching symbol name alignment: Symbols with long names may be hard to differentiate if they have the same prefix. This new option allows you to align the text to the left or right so you can see the part of the symbol name that's important. Improved navigation: You can highlight a symbol or enable sandwich view for a symbol from the table. Also, a new status bar on top of the flame graph displays which views are enabled. {{< video-embed src="/media/docs/grafana/panels-visualizations/screen-recording-grafana-10.1-flamegraph-whatsnew.mp4" >}} <!-- Alexa Vargas, Juan Cabanas --> Experimental in all editions of Grafana This experimental feature introduces a clear distinction between two different categories of panel plugin types: visualization panels that consume a data source and a new type, called widgets, that don't require a data source. Now, you can easily add widgets like Text, News, and Annotation list without the need to select a data source. The plugins list and library panels are filtered based on whether you've selected a widget or visualization, providing a streamlined editing experience. To see the widget editor in Grafana OSS or Enterprise, enable the `vizAndWidgetSplit` feature toggle. If youre using Grafana Cloud and would like to enable this feature, please contact customer support. {{< figure src="/media/docs/grafana/dashboards/WidgetVizSplit.png" max-width="750px" caption="New widget option added to empty dashboards" >}} <!-- Catherine Gui --> Available in public preview in all editions of Grafana The transformations tab has an improved user experience and visual redesign. Now, transformations are categorized, and each transformation type has an illustration to help you choose the right one. {{< figure

max-width="750px" caption="Transformations redesign" >}} <!-- Kyle Cunningham --> Available in public preview in all editions of Grafana When working with date and time data, it can be useful to have different time formats. With the new Format Time transformation, you can convert any time format to any other one supported by . When used in conjunction with the Group by transformation, this can also be used to bucket days, weeks, and other time windows together. {{< figure src="/media/docs/grafana/format-time-10-1.gif" max-width="750px" caption="Format time transformation" >}} <!-- Brendan O'Handley --> Generally available in all editions of Grafana The Join by field transformation has a new option: outer join (tabular). This option is a true outer join for tabular (SQL-like) data. Data can now be joined on a field value that is not distinct. This is different from the previous outer join, which is optimized for time-series data where the join values are never repeated. Generally available in all editions of Grafana <!-- Nathan Marrs --> You can now choose whether to set a threshold above which values in the data should be disconnected. This can be useful in cases where you have sensors that report a value at a set interval, but you want to disconnect the values when the sensor does not respond. This feature complements the existing . To learn more, refer to our . {{< figure src="/media/docs/grafana/screenshot-grafana-10-1-disconnect-values-examples.png" max-width="750px" caption="Disconnect values in Time series, Trend, and State timeline visualizations" >}} Available in public preview in all editions of Grafana <!-- Nathan Marrs --> You can now display network data in the Geomap visualization by using the new beta Network layer. This layer supports the same data format as the . To learn more, refer to our . {{< figure src="/media/docs/grafana/screenshot-grafana-10-1-geomap-network-layer-v2.png" max-width="750px" caption="Geomap Network layer" >}} Generally available in all editions of Grafana <!-- Nathan Marrs --> You can now add data links to Heatmap visualizations. This allows you to add links to other dashboards, panels, or external URLs that are relevant to the data in your heatmap. We're pleased to highlight that this feature was a community contribution. To learn more, refer to both our and our . {{< figure src="/media/docs/grafana/screenshot-grafana-10-1-heatmap-datalinks.png" max-width="750px" caption="Heatmap datalink support" >}} <!-- Robert Horvath --> Generally available in Grafana Enterprise, Cloud Free, Cloud Pro, and Cloud Advanced You can now use the resume and pause report functionality to activate draft reports that have all the required fields filled in. To learn more, refer to our . <!-- Ivana Huckova --> Generally available in all editions of Grafana We've improved the Loki query editor by adding a new Step editor field. This field allows you to specify a value for the `step` parameter in Loki queries. You can use this parameter when making metric queries to Loki or when you want a matrix response from your queries. By default, the `step` parameter is set to the value of the `$interval` variable. This variable is calculated based on the time range and the width of the graph (in pixels). To learn more about the Loki `step` parameter, refer to our . {{< figure src="/media/docs/grafana/data-sources/loki-step-editor.png" max-width="750px" caption="New Loki step editor" >}} <!-- Sven Grossmann --> Generally available in all editions of Grafana New functionality for linking of Loki log lines in Explore allows you to quickly navigate to specific log entries for precise analysis. By clicking the Copy shortlink button for a log line, you can generate and copy a that provides direct access to the exact log entry within an absolute time

When you open the link, Grafana automatically scrolls to the corresponding log line and highlights it, making it easy to identify and focus on the relevant information. {{< figure src="/media/docs/grafana/data-sources/loki-shortlink.png" max-width="750px" caption="New Loki log line linking" >}} <!-- Andr Pereira --> Experimental in all editions of Grafana Grafana's Tempo data source now supports streaming responses to TraceQL queries. With this feature, you can now see partial query results as they come in, so you no longer have to wait for the whole query to finish. This is perfect for big queries that take a long time to return a response. To use this feature, enable the `traceQLStreaming` feature toggle. If youre using Grafana Cloud and would like to enable this feature, please contact customer support. Streaming is available for both the Search and TraceQL query types, and you'll get immediate visibility of incoming traces on the results table. This smooth integration makes data exploration a breeze and speeds up decision-making. {{< video-embed src="/media/docs/grafana/data-sources/tempo-streaming-v2.mp4" >}} <!-- Andr Pereira --> Generally available in all editions of Grafana The Search query type was replaced with a new editor powered by TraceQL. This new editor allows you to use the same query language for both Search and TraceQL queries. This change also brings a new UI that makes it easier to write queries and explore your data while using the powerful features offered by TraceQL. The previous Search interface is now deprecated and will be removed in a future release. We recommend that you start using the new editor as soon as possible and migrate existing dashboards. {{< figure src="/media/docs/grafana/data-sources/tempo-search.png" max-width="750px" caption="Tempo Search editor powered by TraceQL" >}} Generally available in all editions of Grafana <!-- Joey Tawadrous --> Since the last release, we've made several improvements to span filtering. Now, we're promoting span filters out of public preview and into general availability. Span filters allow you to work much more efficiently with traces that consist of a large number of spans. 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 specific the filtered spans. Currently, you can add one or more of the following filters: Service Name Span Name Duration Tags (which includes tags, process tags, and log fields) To only show the spans you've matched, you can enable the Show matches only toggle. Learn more about span filtering in our . {{< figure src="/media/docs/tempo/screenshot-grafana-tempo-span-filters-v10-1.png" max-width="750px" caption="Traces span filtering" >}} <!-- Matas Wenceslao Chomicki --> Generally available in all editions of Grafana The Loki and Elasticsearch data source configuration pages have been redesigned to make getting started and setting up data sources as simple and easy to understand as possible. You can now find new subsections with links to documentation pages, as well as tooltips to assist you with configuring and customizing data sources. <!-- Gabor Farkas --> Generally available in all editions of Grafana The Elasticsearch query editor now allows convenient switching between logs, metrics, and raw data directly from the top, eliminating the need to go through the metric selector. <!-- Catherine Gui --> Generally available in all editions of Grafana The Metrics explorer is a new feature that enhances metrics browsing in the Prometheus query builder. The Metrics explorer makes it easier for you to find the right metric and get comfortable with PromQL. You can now explore metrics with additional metadata, perform fuzzy search on the metric name or description, and filter on the Prometheus type. {{< figure

max-width="750px" caption="Searching in Metrics explorer" >}} <!-- Isabella Siu, Kevin Yu, Andrs Martnez --> Generally available in all editions of Grafana Async query data support in Redshift and Athena makes queries over multiple requests (starting, checking status, and fetching the results) instead of in a single request query. This is useful for queries that can potentially run for a long time and time out. This feature was previously available behind a feature toggle and is now be generally available and enabled by default. <!-- Isabella Siu --> Experimental in Grafana Enterprise, Cloud Pro, and Cloud Advanced This feature adds support for query caching of async queries in the Athena and Redshift data source plugins. To try this feature, enable both the `useCachingService` and `awsAsyncQueryCaching` feature toggles. If youre using Grafana Cloud and would like to enable this experimental feature, please contact customer support. <!-- Isabella Siu, Kevin Yu --> Experimental in all editions of Grafana The CloudWatch logs query editor is moving from being a Slate-based editor to a Monaco-based editor. This new Monaco-based editor provides improved syntax highlighting, and auto-completion. To use the Monaco-based query editor, enable the `cloudWatchLogsMonacoEditor` feature toggle. If youre using Grafana Cloud and would like to enable this feature, please contact customer support. <!-- Ismail Simsek --> Available in public preview in all editions of Grafana Previously, InfluxDB backend mode was available, however, there were compatibility issues that needed to be addressed. In this release, we've addressed these issues and promoted this feature from experimental to public preview. In the future, backend mode will be the default, and we'll deprecate frontend mode. To try backend mode, enable the `influxdbBackendMigration` feature toggle. If youre using Grafana Cloud and would like to enable this feature, please contact customer support. <!-- Matas Wenceslao Chomicki --> Generally available in all editions of Grafana When you're browsing logs in Explore, you can now click the eye icon within a row to replace the log line's contents with the value of one or more of the log fields or labels. This is helpful for scanning through your logs. {{< figure src="/media/docs/grafana/log-field-picker-10-1.gif" max-width="750px" caption="Log rows menu" >}} <!-- Matas Wenceslao Chomicki --> Generally available in all editions of Grafana After a series of performance optimizations to log-related components, browsing log lines is faster than ever. <!-- Gabor Farkas, Sven Grossmann --> Generally available in all editions of Grafana Log context allows you to view additional lines surrounding a specific log entry. With this enhancement, you can access as many log lines as needed within the log context. As you scroll through the logs, Grafana dynamically loads more log lines, ensuring a seamless and continuous viewing experience. <!-- Gareth Dawson --> Generally available in all editions of Grafana For Elasticsearch metric queries in Explore, you can now see the sample of log lines that contributed to the displayed results. To see these logs, click the collapsed logs sample panel under your graph or table panel. If you want to interact with the log lines or modify the log query, click the Open logs in split view button and the log query will be executed in the split view. <!-- Ben Donnelly --> Experimental in all editions of Grafana Data source plugin developers can now use any plugin to visualize data in Explore. Similar to `preferredVisualizationType`, we've introduced an experimental API to render visualizations by plugin ID. In the returned data frame, set the meta option `preferredVisualisationPluginId` to the plugin ID you want to be used when showing the data for given data frame. All Alerting features are generally available in all editions of Grafana Weve made a number of improvements to simplify the alert rule creation process as well as improvements to contact points and alert

For all the details, refer to our . Weve made the following changes to alert rules. This feature is for Grafana-managed alert rules only. Preview how your alert instances will be routed if they fire while you're creating your alert rule. You can view routing for each Alertmanager you've configured to receive Grafana-managed alerts, and if required, easily make adjustments to your custom labels to change the way your alert instances are routed. {{< figure src="/media/docs/alerting/alert-routing-preview.png" max-width="750px" caption="Alert instance routing preview" >}} You can switch to a data source-managed alert rule if your data source is configured to support alert rule creation (Ruler API enabled). By default, the alert rule type is Grafana-managed. {{< figure src="/media/docs/alerting/alert-rule-types.png" max-width="750px" caption="Alert rule types" >}} Alert evaluation behavior: New UI components for creating a folder and adding an evaluation group. along with improved text and validation. Alert Rule list page: The process of creating recording rules (More drop-down) is now separate from Grafana-managed and data source-managed alert rules (+New alert rule) . Annotations display: Adding a summary, description, and runbook URL as annotations are now optional. The dashboard and panel names are now also linked directly, making them easier to access. View YAML button: Displays alert rule configuration in YAML format on the Grafana-managed alert rules form, as well as in the Grafana-managed provisioned and non-provisioned Alert Rule detail view. Queries and expressions: Several improvements have been made to the display of queries and expressions, including making Add expression a drop-down and moving Conditions to the header. Min interval option: Improves control over query costs and performance by allowing you to adjust the minimum resolution of the data used in your alerting queries. In-app guidance for alert rule creation: Learn about how to create your alert rules interactively with in-app guidance for additional context and links out to our Alerting documentation. Support for toggling common labels: Toggle between showing or hiding labels for each individual alert instance. Weve made the following changes to contact points. We've added support for the following contact points when using an external Alertmanager: WeChat Amazon SNS Telegram Cisco Webex Teams This update facilitates file provisioning and maintenance for contact points. The feature implements the provisioning API export endpoints for exporting contact points as well as adding export buttons to the contact point list in the UI. Weve made the following changes to notification policies. This update facilitates file provisioning and maintenance for notification policies. The feature implements the provisioning API export endpoints for exporting notification policies as well as adding an export button to the root notification policy in the UI. Weve made the following changes to alert management. We've added support for different time zones and locations as well as a visual selector for week days, made improvements to loading and error handling, and provided better validation for time ranges. {{< figure src="/media/docs/alerting/timezone-support.png" max-width="600px" caption="Time zone support" >}} Labels are colored according to the label key, which makes it easier to track and view labels across alert instances. <!-- Jo Guerreiro, AuthNZ --> Generally available in all editions of Grafana This change impacts `GitHub`, `GitLab`, `Okta`, and `Generic` OAuth. Previously, if no organization role mapping was found for a user when they connected using OAuth, Grafana didnt update the users organization role. Now, on every login, if the `roleattributepath` property doesn't return a role, then the user is assigned the role specified by the `autoassignorg_role` option or the default role for the organization, which is Viewer by

To avoid overriding manually set roles, enable the `skiporgrole_sync` option in the Grafana configuration for your OAuth provider before affected users log in for the first time. <!-- Ieva Vasiljeva, AuthNZ --> Generally available in all editions of Grafana This change impacts all instances that use an external authentication provider and have role mapping enabled. Previously, it was possible to manually update a user's organization role (Viewer, Editor, Admin, or Grafana Admin) even if this role was managed by an external authentication provider. This means that roles could be manually set for the duration of a user's session, but were overridden by the external authentication provider the next time the user logged in. If the `onlyExternalOrgRoleSync` feature toggle was enabled, only then were manual role updates for externally managed roles not allowed. Now, you can no longer manually update externally managed organization roles. We've removed the `onlyExternalOrgRoleSync` feature toggle, and have defaulted to locking the organization role of users authenticated by an external provider. If you prefer to manage your users' organization roles manually, enable the `skiporgrole_sync` option in the Grafana configuration for your authentication provider. For context on the previous work done leading up to this change, refer to the . <!-- Jo Guerreiro, AuthNZ --> Generally available in all editions of Grafana Grafana now supports GitLab OIDC through the `GitLab` OAuth provider in addition to the existing `GitLab` OAuth2 provider. This allows you to use GitLab OIDC to authenticate users in Grafana. This change also allows Grafana to reduce the access scope to only the required scopes for authentication and authorization, instead of full read API access. To learn how to migrate your GitLab OAuth2 setup to OIDC, refer to our . <!-- Jo Guerreiro, AuthNZ --> Generally available in all editions of Grafana Grafana now supports Google OIDC through the `Google` OAuth provider in addition to the existing `Google` OAuth2 provider. This allows you to use Google OIDC to authenticate users in Grafana, which in turn, lets Grafana reduce the access scope to only the required scopes for authentication and authorization. This release also adds support for Google OIDC in Team Sync. You can now easily add users to teams by using their Google groups. To learn how to migrate your Google OAuth2 setup to OIDC and how to set up Team Sync, refer to our . <!-- Giuseppe Guerra, Plugins Platform --> Generally available in all editions of Grafana We've made the following updates to increase awareness of the and its consequences in future releases of Grafana: Added an Angular badge next to affected plugins in the plugins catalog. Added an alert at the top of a plugin's page in the plugins catalog when browsing Angular plugins. Added an alert at the top of the query editor when editing panels that use Angular data source plugins. Angular Plugins will not be loaded if is set to `false`. Learn more in our . <!-- Giuseppe Guerra, Plugins Platform --> Generally available in all editions of Grafana Grafana now logs an error when provisioning data sources with invalid UIDs. A valid UID is a combination of a-z, A-Z, 0-9 (alphanumericals), `-` (dashes), and `_` (underscores), with a maximum length of 40 characters. Provisioning data sources with invalid UIDs will be removed in future versions of Grafana, and will return an error instead. <!-- Zsofia Komaromi --> Available in public preview in all editions of Grafana When saving or moving a dashboard, you can now see the full folder tree when selecting the destination folder. To get started creating subfolders, enable the `nestedFolders` feature toggle. We recommend that you