From be6b407d739fd938f1720bd3673d25a0b912799c Mon Sep 17 00:00:00 2001 From: Isabel <76437239+imatwawana@users.noreply.github.com> Date: Tue, 24 Oct 2023 12:56:09 -0400 Subject: [PATCH] =?UTF-8?q?docs:=20What=E2=80=99s=20new=20&=20Upgrade=20gu?= =?UTF-8?q?ide=2010.2=20(#75909)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * Added 10.2 what's new and upgrade guide * Fixed title and added guidance * add: no basic role feature to whats new * Revert "add: no basic role feature to whats new" This reverts commit eb2e31c3dcf013c45b4102f3a149826f5d4c7fe5. * Add field min/max calculation to what's new * refresh token handling * update * Remove whitespace * Revert "Add field min/max calculation to what's new" This reverts commit 9b66ddd0ecfed3b9c3b1dee9cdac6d748e24cffa. * Revert refresh token handling and move it to separate PR * Docs: Add permission validation enabled by default to what's new (#76376) * Add permission validation enabled by default to whats new * Update docs/sources/whatsnew/whats-new-in-v10-2.md Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com> * update * Apply suggestions from code review Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com> * Fix Grafana editions note * run prettier --------- Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com> * Fixed typo * Docs: Add No basic role feature description (#76345) * add whats next for cloud * Update docs/sources/whatsnew/whats-new-next/index.md Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com> * Update docs/sources/whatsnew/whats-new-next/index.md Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com> * Update docs/sources/whatsnew/whats-new-next/index.md Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com> * Update docs/sources/whatsnew/whats-new-next/index.md Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com> * Update docs/sources/whatsnew/whats-new-next/index.md Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com> * Update docs/sources/whatsnew/whats-new-next/index.md Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com> --------- Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com> * Auth: Whats new v10.2 (#76369) * add whatsnew auth * Update docs/sources/whatsnew/whats-new-in-v10-2.md Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com> * Apply suggestions from code review Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com> * Update docs/sources/whatsnew/whats-new-in-v10-2.md * Apply suggestions from code review Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com> * separate ds and db managed permissions whats new * Apply suggestions from code review Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com> --------- Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com> * What's new in transformations 10.2 (#76430) * first draft * spelling * Add doc links and images * Fix relrefs * Apply suggestions from code review Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com> * Add information about availability * update availability for string format transform * add field from calc modifications * Fixed link version syntax * Apply suggestions from code review Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com> --------- Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com> Co-authored-by: Victor Marin * Add field min/max calculation to what's new (#76401) * Add field min/max calculation to what's new * fix whitespace * Fix which editions it's available in * Apply suggestions from code review Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com> * change availability * reduce image size --------- Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com> * Removed What's new next addition from this PR * Added alertmanager update (#76584) * Added alertmanager update * Fixed order of items * Added availability info * remove typo Co-authored-by: Oscar Kilhed * Remove heading formatting * initial draft of dataviz squad deliverables for 10.2 whats new * add dashgpt (#dashboard-ai) whats new draft * What's New: Correlations in 10.2 (#76505) * What's new about correlations * Update docs/sources/whatsnew/whats-new-in-v10-2.md Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com> * Update docs/sources/whatsnew/whats-new-in-v10-2.md Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com> * Update docs/sources/whatsnew/whats-new-in-v10-2.md Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com> * Update docs/sources/whatsnew/whats-new-in-v10-2.md Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com> * Update docs/sources/whatsnew/whats-new-in-v10-2.md Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com> * Update docs/sources/whatsnew/whats-new-in-v10-2.md Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com> * Update availability * Update docs/sources/whatsnew/whats-new-in-v10-2.md Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com> * Update docs/sources/whatsnew/whats-new-in-v10-2.md Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com> * Update docs/sources/whatsnew/whats-new-in-v10-2.md Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com> * Update docs/sources/whatsnew/whats-new-in-v10-2.md Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com> * Update docs/sources/whatsnew/whats-new-in-v10-2.md Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com> * Update docs/sources/whatsnew/whats-new-in-v10-2.md Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com> * Update docs/sources/whatsnew/whats-new-in-v10-2.md Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com> --------- Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com> * Updated linking guidance in template and fixed links * Fixed link Co-authored-by: Kate Brenner <32871890+katebrenner@users.noreply.github.com> * Docs: update whats new links (#76639) Replaced relrefs with fully qualified URLs * DashGPT: update availability status to public preview * Update What's New to Include information on Timezone and Applicability changes in transformations (#76571) * Update what's new * Fix misspelling * Update to fix wording Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com> * Remove merge conflict flag Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com> * Fix capitalization Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com> * Fix wording Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com> * Sentence casing Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com> * Fix up wording Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com> * Fix availability * One last fix :) Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com> * Fixed typo (I introduced!) --------- Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com> * Docs: add Cloud what's new items to 10.2 what's new (#76642) * Added Cloud what's new content * Apply suggestions from code review Co-authored-by: Jennifer Villa * Updated link formatting * Updated Browse Dashboards with the latest content * Updated availability * Updated wording Co-authored-by: Haris Rozajac <58232930+harisrozajac@users.noreply.github.com> * Fixed typo Co-authored-by: Haris Rozajac <58232930+harisrozajac@users.noreply.github.com> --------- Co-authored-by: Jennifer Villa Co-authored-by: joshhunt Co-authored-by: Haris Rozajac <58232930+harisrozajac@users.noreply.github.com> * Fixed title * Removed all editions language * General edits * Copy edits * Fixed availability note * Copy editing Removed Visualize enum entry Added sharing section Added alerting entry Added introduction Made minor copy edits * Fixed capitalization * Fixed typo * add CTA and gif to AI features * update recorded queries text * Update edition availability Cloud permissions were missing (even though this is an OSS release I think it's important to include details about Cloud availability) and some features listed the wrong availability. * reorder topics for emphasis Emphasize the most exciting improvements * add links to feature toggle docs * move recorded queries * update wording and titles for readability * add visualization media * update wording in dataviz section * dashgpt: finalize whats new for 10.2 (finally) 😬 * Fixed typo * DataViz: finalize whats new content 😬 * Copy edits * update enterprise ds availability * Update whats-new-in-v10-2.md * Fixed style issues and availability note * Added missing Alerting items * Updated availability note * Fixed styling * Reverted what's new link to relref * update availability of No Basic Role I consulted with Eric before making this change. * Removed item not going out in this release * Update Alerting items * Fixed linting --------- Co-authored-by: Eric Leijonmarck Co-authored-by: Oscar Kilhed Co-authored-by: Mihaly Gyongyosi Co-authored-by: Jo Co-authored-by: Victor Marin Co-authored-by: nmarrs Co-authored-by: Piotr Jamróz Co-authored-by: Kate Brenner <32871890+katebrenner@users.noreply.github.com> Co-authored-by: Kyle Cunningham Co-authored-by: Jennifer Villa Co-authored-by: joshhunt Co-authored-by: Haris Rozajac <58232930+harisrozajac@users.noreply.github.com> Co-authored-by: Mitch Seaman Co-authored-by: Mitchel Seaman Co-authored-by: Miguel Palau --- docs/sources/_index.md | 4 +- docs/sources/shared/upgrade/intro.md | 4 +- .../shared/upgrade/upgrade-common-tasks.md | 2 +- .../upgrade-guide/upgrade-v10.2/index.md | 21 + docs/sources/whatsnew/_index.md | 1 + docs/sources/whatsnew/whats-new-in-v10-2.md | 476 ++++++++++++++++++ 6 files changed, 503 insertions(+), 5 deletions(-) create mode 100644 docs/sources/upgrade-guide/upgrade-v10.2/index.md create mode 100644 docs/sources/whatsnew/whats-new-in-v10-2.md diff --git a/docs/sources/_index.md b/docs/sources/_index.md index 3cf37151df134..0ea6107fb3546 100644 --- a/docs/sources/_index.md +++ b/docs/sources/_index.md @@ -75,8 +75,8 @@ title: Grafana open source documentation

Provisioning

Learn how to automate your Grafana configuration.

- }}" class="nav-cards__item nav-cards__item--guide"> -

What's new in v10.1

+ }}" class="nav-cards__item nav-cards__item--guide"> +

What's new in v10.2

Explore the features and enhancements in the latest release.

 diff --git a/docs/sources/shared/upgrade/intro.md b/docs/sources/shared/upgrade/intro.md index 2f77e8a04ae4b..108c783c14cf0 100644 --- a/docs/sources/shared/upgrade/intro.md +++ b/docs/sources/shared/upgrade/intro.md @@ -13,10 +13,10 @@ Because Grafana upgrades are backward compatible, the upgrade process is straigh In addition to common tasks you should complete for all versions of Grafana, there might be additional upgrade tasks to complete for a version. {{% admonition type="note" %}} -There might be breaking changes in some releases. We outline these changes in the [What's New ]({{< relref "../../whatsnew/" >}}) document for most releases or a separate [Breaking changes]({{< relref "../../breaking-changes/" >}}) document for releases with many breaking changes. +There might be breaking changes in some releases. We outline these changes in the [What's New ](https://grafana.com/docs/grafana//whatsnew/) document for most releases or a separate [Breaking changes](https://grafana.com/docs/grafana//breaking-changes/) document for releases with many breaking changes. {{% /admonition %}} -For versions of Grafana prior to v9.2, we published additional information in the [Release Notes]({{< relref "../../release-notes/" >}}). +For versions of Grafana prior to v9.2, we published additional information in the [Release Notes](https://grafana.com/docs/grafana//release-notes/). When available, we list all changes with links to pull requests or issues in the [Changelog](https://github.com/grafana/grafana/blob/main/CHANGELOG.md). diff --git a/docs/sources/shared/upgrade/upgrade-common-tasks.md b/docs/sources/shared/upgrade/upgrade-common-tasks.md index 921911614ef42..3c53e3d44f3de 100644 --- a/docs/sources/shared/upgrade/upgrade-common-tasks.md +++ b/docs/sources/shared/upgrade/upgrade-common-tasks.md @@ -67,7 +67,7 @@ To upgrade Grafana installed using RPM or YUM complete the following steps: 1. Perform one of the following steps based on your installation. - - If you [downloaded an RPM package](https://grafana.com/grafana/download) to install Grafana, then complete the steps documented in [Install Grafana on Red Hat, RHEL, or Fedora]({{< relref "../../setup-grafana/installation/redhat-rhel-fedora/" >}}) or [Install Grafana on SUSE or openSUSE]({{< relref "../../setup-grafana/installation/suse-opensuse/" >}}) to upgrade Grafana. + - If you [downloaded an RPM package](https://grafana.com/grafana/download) to install Grafana, then complete the steps documented in [Install Grafana on Red Hat, RHEL, or Fedora](https://grafana.com/docs/grafana//setup-grafana/installation/redhat-rhel-fedora/) or [Install Grafana on SUSE or openSUSE](https://grafana.com/docs/grafana///setup-grafana/installation/suse-opensuse/) to upgrade Grafana. - If you used the Grafana YUM repository, run the following command: ```bash diff --git a/docs/sources/upgrade-guide/upgrade-v10.2/index.md b/docs/sources/upgrade-guide/upgrade-v10.2/index.md new file mode 100644 index 0000000000000..17e706d64ef25 --- /dev/null +++ b/docs/sources/upgrade-guide/upgrade-v10.2/index.md @@ -0,0 +1,21 @@ +--- +description: Guide for upgrading to Grafana v10.2 +keywords: + - grafana + - configuration + - documentation + - upgrade +title: Upgrade to Grafana v10.2 +menuTitle: Upgrade to v10.2 +weight: 1500 +--- + +# Upgrade to Grafana v10.2 + +{{< docs/shared lookup="upgrade/intro.md" source="grafana" version="" >}} + +{{< docs/shared lookup="back-up/back-up-grafana.md" source="grafana" version="" leveloffset="+1" >}} + +{{< docs/shared lookup="upgrade/upgrade-common-tasks.md" source="grafana" version="" >}} + +## Technical notes diff --git a/docs/sources/whatsnew/_index.md b/docs/sources/whatsnew/_index.md index 63ab1a5446ef1..a386419bdf829 100644 --- a/docs/sources/whatsnew/_index.md +++ b/docs/sources/whatsnew/_index.md @@ -76,6 +76,7 @@ For a complete list of every change, with links to pull requests and related iss ## Grafana 10 +- [What's new in 10.2](https://grafana.com/docs/grafana//whatsnew/whats-new-in-v10-2/) - [What's new in 10.1]({{< relref "whats-new-in-v10-1/" >}}) - [What's new in 10.0]({{< relref "whats-new-in-v10-0/" >}}) diff --git a/docs/sources/whatsnew/whats-new-in-v10-2.md b/docs/sources/whatsnew/whats-new-in-v10-2.md new file mode 100644 index 0000000000000..1da21a0fa2e3d --- /dev/null +++ b/docs/sources/whatsnew/whats-new-in-v10-2.md @@ -0,0 +1,476 @@ +--- +description: Feature and improvement highlights for Grafana v10.2 +keywords: + - grafana + - new + - documentation + - '10.2' + - release notes +labels: +products: + - cloud + - enterprise + - oss +title: What's new in Grafana v10.2 +weight: -39 +--- + +# What’s new in Grafana v10.2 + +Welcome to Grafana 10.2! Read on to learn about changes to dashboards and visualizations, data sources, security and authentication, and more. We’re particularly excited about the addition of generative AI features for dashboards, a new kind of basic role, and improvements to visualization transformations. + +For even more detail about all the changes in this release, refer to the [changelog](https://github.com/grafana/grafana/blob/master/CHANGELOG.md). For the specific steps we recommend when you upgrade to v10.2, check out our [Upgrade Guide](https://grafana.com/docs/grafana//upgrade-guide/upgrade-v10.2/). + + + + + +## Share your dashboard with the world: Public dashboards are generally available + + + +_Generally available in all editions of Grafana_ + +Public dashboards allow you to share your visualizations and insights with a broader audience without the requirement of a login. You can effortlessly use our current sharing model and create a public dashboard URL to share with anyone using the generated public URL link. To learn more, refer to the [Public dashboards documentation](https://grafana.com/docs/grafana//dashboards/dashboard-public/), as well as the following video demo: + +{{< video-embed src="/media/docs/grafana/dashboards/public-dashboards-demo.mp4" >}} + +## Navigate lengthy, mixed data in Explore with Content Outline + + + +_Generally available in all editions of Grafana_ + +Introducing Content Outline in Grafana Explore. It's easy to lose track of your place when you're running complex mixed queries or switching between logs and traces. Content outline is our first step towards seamless navigation from log lines to traces and back to queries, ensuring quicker searches while preserving context. Experience efficient, contextual investigations with this update in Grafana Explore. To learn more, refer to the [Content outline documentation](https://grafana.com/docs/grafana//explore/#content-outline), as well as the following video demo. + +{{< video-embed src="/media/docs/grafana/explore/content-outline-demo.mp4" >}} + +## Correlations + +Grafana Correlations is a new public preview feature you can use to establish links from any data source query to any other, carrying forward data like namespace, host, or label values. This is extremely powerful for performing root cause analysis with a diverse set of data sources. For more information, refer to [the documentation](https://grafana.com/docs/grafana//administration/correlations/). + +### Create Correlations the easy way in Grafana Explore + + + +_Available in public preview in all editions of Grafana_ + +Creating correlations has just become easier. Try out our new correlations editor in Explore by selecting the **+ Add > Add correlation** option from the top bar or from the command palette. The editor shows all possible places where you can place data links and guides you through building and testing target queries. For more information, refer to [the documentation](https://grafana.com/docs/grafana//administration/correlations/). + +To try out **Correlations**, enable the `correlations` [feature toggle](https://grafana.com/docs/grafana//setup-grafana/configure-grafana/feature-toggles/#preview-feature-toggles). + +{{< figure src="/media/docs/grafana/correlations-explore-editor-10-2.png" max-width="750px" caption="Create a correlation with variables from within Grafana Explore" >}} + +### Create correlations for provisioned data sources + + + +_Available in public preview in all editions of Grafana_ + +In previous versions of Grafana, if a data source was provisioned, the only way to add correlations to it was also with provisioning. Now, that's no longer the case, and you can easily create new correlations mixing both methods—using the **Administration** page or provisioning. For more information, refer to [the documentation](https://grafana.com/docs/grafana//administration/correlations/). + +To try out **Correlations**, enable the `correlations` [feature toggle](https://grafana.com/docs/grafana//setup-grafana/configure-grafana/feature-toggles/#preview-feature-toggles). + +## Dashboards and visualizations + +### Use AI to generate titles, descriptions, and change summaries + +_Available in public preview in all editions of Grafana_ + + + + +You can now use generative AI to assist you in your Grafana dashboards. So far generative AI can help you with the following tasks: + +- **Generate panel and dashboard titles and descriptions** - You can now generate a title and description for your panel or dashboard based on the data you've added to it. This is useful when you want to quickly visualize your data and don't want to spend time coming up with a title or description. +- **Generate dashboard save changes summary** - You can now generate a summary of the changes you've made to a dashboard when you save it. This is great for effortlessly tracking the history of a dashboard. + +To enable these features, you must first enable the `dashgpt` [feature toggle](https://grafana.com/docs/grafana//setup-grafana/configure-grafana/feature-toggles/#experimental-feature-toggles). Then install and configure Grafana's LLM app plugin. For more information, refer to the [Grafana LLM app plugin documentation](https://grafana.com/docs/grafana-cloud/alerting-and-irm/machine-learning/llm-plugin/). + +When enabled, look for the **✨ Auto generate** option next to the **Title** and **Description** fields in your panels and dashboards, or when you press the **Save** button. + +{{< figure src="/media/docs/grafana/dashboards/auto-generate-description-10-2.gif" max-width="750px" caption="Auto-generate a panel description using AI" >}} + +### Find your dashboard faster with the new Dashboards browse screen + + + +_Generally available in all editions of Grafana_ + +The new browse screen for dashboards features a more compact design, making it easier to navigate, search for, and manage your folders and dashboards. The new interface also has many performance improvements, especially for instances with a large number of folders and dashboards. + +To make using folders easier and more consistent, there's no longer a special **General** folder. Dashboards without a folder, or dashboards previously in the **General** folder, are now shown at the root level. + +To try it out, go to the **Dashboards** section of your Grafana instance. + +{{< video-embed src="/media/docs/grafana/2023-09-11-New-Browse-Dashboards-Enablement-Video.mp4" >}} + +### Create interactive buttons in canvas visualizations + +_Available in public preview in all editions of Grafana_ + + + + +You can now add buttons to your canvas visualizations. Buttons can be configured to call an API endpoint. This pushes Grafana's capabilities to new heights, allowing you to create interactive dashboards that can be used to control external systems. + +To learn more, refer to our [Canvas button element documentation](https://grafana.com/docs/grafana//panels-visualizations/visualizations/canvas/#button). + +{{< video-embed src="/media/docs/grafana/2023-20-10-Canvas-Button-Element-Enablement-Video.mp4" max-width="750px" caption="Canvas button element demo" >}} + +### Zoom in on the y-axis of the time series and candlestick visualizations + +_Generally available in all editions of Grafana_ + + + + +You can now zoom in on the y-axis of your time series and candlestick visualizations. This is useful when you want to focus on a specific range of values. To zoom in on the y-axis on supported visualizations, hold the Shift key while clicking and dragging; double-click to reset the zoom. + +{{< video-embed src="/media/docs/grafana/screen-recording-10-2-y-axis-zoom-demo.mp4" max-width="750px" caption="Y-axis zooming demo" >}} + +### Calculate visualization min/max individually per field + + + +_Generally available in all editions of Grafana_ + +When visualizing multiple fields with a wide spread of values, calculating the min or max value of the visualization based on all fields can hide useful details. + +{{< figure src="/media/docs/grafana/panels-visualizations/globalminmax.png" max-width="300px" caption="Stat visualization with min/max calculated from all fields" >}} + +In this example in the stat visualization, it's hard to get an idea of how the values of each series relate to the historical values of that series. The threshold of 10% is exceeded by the A-series even though the A-series is below 10% of its historical maximum. + +Now, you can automatically calculate the min or max of each visualized field based on the lowest and highest value of the individual field. This setting is available in the standard options of most visualizations. + +{{< figure src="/media/docs/grafana/panels-visualizations/localminmax.png" max-width="300px" caption="Stat visualization with min/max calculated per field" >}} + +In this example, using the same data, with the min and max calculated for each individual field, we get a much better understanding of how the current value relates to the historical values. The A-series no longer exceeds the 10% threshold; in fact, it's now clear that it's at a historical low. + +This isn't only useful in the stat visualization—gauge, bar gauge, and status history visualizations, table cells formatted by thresholds, and gauge table cells all benefit from this addition. + +### Data visualization quality of life improvements + +_Generally available in all editions of Grafana_ + + + + +We've made a number of smaller improvements to the data visualization experience in Grafana. + +#### Geomap marker symbol alignment options + +You can now offset geomap marker symbols from the underlying data point. + +{{< figure src="/media/docs/grafana/gif-grafana-10-2-geomap-marker-symbol-alignment.gif" max-width="750px" caption="Geomap marker symbol alignment" >}} + +#### Gauge visualization overflow support + +You can now visualize gauges in vertical and horizontal orientations with overflow. This resolves an issue where the design would break when the number of gauges exceeded the available space. + +{{< figure src="/media/docs/grafana/gif-grafana-10-2-gauge-overflow.gif" max-width="750px" caption="Gauge overflow" >}} + +#### Bar chart axes improvements + +You can now center bar chart axes on zero and configure axes border and color settings. + +{{< figure src="/media/docs/grafana/screenshot-grafana-10-2-bar-chart-axes-improvements.png" max-width="750px" caption="Bar chart improvements" >}} + +## Data sources and querying + +### Tempo data source + +We've placed special focus on the Tempo data source over the past couple of months with new features, query performance improvements, and a better query experience. + +#### Compute RED metrics over spans aggregated by attribute with the "Aggregate By" Search option + + + +_Experimental in all editions of Grafana_ + +Requires Tempo or Grafana Enterprise Traces (GET) v2.2 or greater. + +We've added an **Aggregate By** option to the [TraceQL query editor](https://grafana.com/docs/grafana//datasources/tempo/query-editor/traceql-search/#write-traceql-queries-using-search) to leverage Tempo's [metrics summary API](https://grafana.com/docs/tempo//api_docs/metrics-summary/). You can calculate RED metrics (total span count, percent erroring spans, and latency information) for spans of `kind=server` received in the last hour that match your filter criteria, grouped by whatever attributes you specify. + +This feature is disabled by default. To enable it, use the `metricsSummary` [experimental feature toggle](https://grafana.com/docs/grafana//setup-grafana/configure-grafana/feature-toggles/#experimental-feature-toggles). + +For more information, refer to the [documentation](https://grafana.com/docs/grafana//datasources/tempo/query-editor/traceql-search/#optional-use-aggregate-by). + +{{< figure src="/media/docs/tempo/metrics-summary-10-2.png" caption="Aggregate by" >}} + +#### Query traces more easily with the Improved TraceQL editor + + + +_Generally available in all editions of Grafana_ + +The [TraceQL query editor](https://grafana.com/docs/tempo/latest/traceql/#traceql-query-editor) has been improved to facilitate the creation of TraceQL queries. In particular, it now features improved autocompletion, syntax highlighting, and error reporting. + +{{< video-embed src="/media/docs/tempo/screen-recording-grafana-10.2-traceql-query-editor-improvements.mp4" >}} + +#### Group multiple spansets per trace + + + +_Generally available in all editions of Grafana_ + +The [TraceQL query editor](https://grafana.com/docs/tempo//traceql/#traceql-query-editor) has been improved to facilitate the grouping of multiple spans per trace in TraceQL queries. For example, when `by(resource.service.name)` is added to your TraceQL query, it will group the spans in each trace by `resource.service.name`. + +{{< figure src="/media/docs/tempo/multiple-spansets-per-trace-10-2.png" max-width="750px" caption="Multiple spansets per trace" >}} + +#### Create query-type template variables for the Tempo data source + + + +_Generally available in all editions of Grafana_ + +The Tempo data source now supports query-type template variables. With this update, you can create variables for which the values are a list of attribute names or attribute values seen on spans received by Tempo. + +To learn more, refer to the following video demo, as well as the [Grafana Variables documentation](/docs/grafana/next/dashboards/variables/). + +{{< video-embed src="/media/docs/tempo/screen-recording-grafana-10.2-tempo-query-type-template-variables.mp4" >}} + +### SAP HANA®: Configure your data source with tenant database instance name and number + + + +_Generally available in Grafana Enterprise and Grafana Cloud_ + +The SAP HANA® data source now supports tenant database connections by using the database name and/or instance number. This is helpful because these are less likely to change than the port for your database. For more information, refer to our [SAP HANA® configuration documentation](/docs/plugins/grafana-saphana-datasource/latest/#configuration). + +{{< video-embed src="/media/docs/sap-hana/tenant.mp4" >}} + +### Datadog: Aggregate logs to compute metrics and time series + + + +_Generally available in Grafana Enterprise and Grafana Cloud_ + +The Datadog data source now supports log aggregation. This feature helps aggregate logs/events into buckets and compute metrics and time series. For more information, refer to [Datadog log aggregation](/docs/plugins/grafana-datadog-datasource/latest#logs-analytics--aggregation). + +{{< video-embed src="/media/docs/datadog/datadog-log-aggregation.mp4" >}} + +### Datadog: Rate-limit requests from the Datadog data source + + + +_Generally available in Grafana Enterprise and Grafana Cloud_ + +In the Datadog data source, you can now block API requests for metric queries based on upstream rate limits. With this update, you can set a rate limit percentage at which the plugin stops sending queries. + +To learn more, refer to [Datadog data source settings](/docs/plugins/grafana-datadog-datasource/latest#configure-the-data-source), as well as the following video demo. + +{{< video-embed src="/media/docs/datadog/datadog-rate-limit.mp4" >}} + +## Transformations + +As our work on improving the user experience of transforming data continues, we've also been adding new capabilities to transformations. + +### Use dashboard variables in transformations + + + +_Experimental in all editions of Grafana_ + +Previously, the only transformation that supported [dashboard variables](https://grafana.com/docs/grafana//dashboards/variables/) was the **Add field from calculation** transformation. We've now extended the support for variables to the **Filter by value**, **Create heatmap**, **Histogram**, **Sort by**, **Limit**, **Filter by name**, and **Join by field** transformations. We've also made it easier to find the correct dashboard variable by displaying available variables in the fields that support them, either in the drop-down or as a suggestion when you type **$** or press Ctrl + Space: + +{{< figure src="/media/docs/grafana/transformations/completion.png" caption="Input with dashboard variable suggestions" >}} + +### New modes for the Add field from calculation transformation + + + +_Generally available in all editions of Grafana_ + +The **Add field from calculation** transformation has been updated. + +**Unary operation** is a new mode that lets you apply mathematical operations to a field. The currently supported operations are: + +- **Absolute value (abs)** - Returns the absolute value of a given expression. It represents its distance from zero as a positive number. +- **Natural exponential (exp)** - Returns _e_ raised to the power of a given expression. +- **Natural logarithm (ln)** - Returns the natural logarithm of a given expression. +- **Floor (floor)** - Returns the largest integer less than or equal to a given expression. +- **Ceiling (ceil)** - Returns the smallest integer greater than or equal to a given expression. + +{{< figure src="/media/docs/grafana/transformations/unary-operation.png" >}} + +Also, **Row index** can now show the index as a percentage. + +Learn more in the [Add field from calculation documentation](https://grafana.com/docs/grafana//panels-visualizations/query-transform-data/transform-data/#add-field-from-calculation). + +### Format strings with transformations + + + +_Experimental in all editions of Grafana_ + +With the new **Format string** transformation, you can manipulate string fields to improve how they're displayed. The currently supported operations are: + +- **Change case** changes the case of your string to upper case, lower case, sentence case, title case, pascal case, camel case, or snake case. +- **Trim** removes white space characters at the start and end of your string. +- **Substring** selects a part of your string field. + +Learn more in the [Format string documentation](https://grafana.com/docs/grafana//panels-visualizations/query-transform-data/transform-data/#format-string). + +### See which transformations will work with your data + + + +_Available in public preview in all editions of Grafana_ + +We've added initial support to detect situations in which various transformations won't work appropriately based on current data. Previously, selecting the appropriate transformation and configuring it correctly required a process of trial and error or already knowing how a given transformation worked. Now, transformations that we've detected can't be used are shaded in the interface to indicate this, along with a helpful message explaining why. + +{{< figure src="/media/docs/grafana/transformations/disabled-transformation.png" caption="Transformation that has been disabled because it doesn't have the necessary data" >}} + +If you have the `transformationsRedesign` feature flag set, you'll be able to access this functionality right away. If you'd like to try it, enable this feature flag in your [Grafana configuration](https://grafana.com/docs/grafana//setup-grafana/configure-grafana/#feature_toggles). + +### Choose your timezome in the Format time and Convert field type transformations + + + +_Generally available in all editions of Grafana_ + +We've added support for setting timezones manually when formatting times as strings using the **Format time** and **Convert field type** transformations. This allows times to be formatted relative to any timezone across the globe. + +{{< figure src="/media/docs/grafana/transformations/format-timezone.png" caption="Timezone support in the Format time transformation" >}} + +## Alerting + +### Grafana OnCall integration for Alerting + + + +_Generally available in all editions of Grafana_ + +Use the Grafana Alerting - Grafana OnCall integration to effortlessly connect alerts generated by Grafana Alerting with Grafana OnCall. From there, you can route them according to defined escalation chains and schedules. + +To learn more, refer to the [Grafana OnCall integration for Alerting documentation](https://grafana.com/docs/grafana//alerting/alerting-rules/manage-contact-points/configure-oncall/). + +### Export alerting resources to Terraform + + + +_Generally available in all editions of Grafana_ + +Export your alerting resources, such as alert rules, contact points, and notification policies as Terraform resources. A new “Modify export” mode for alert rules enables you to edit provisioned alert rules and export a modified version. + +### Additional contact points for external Alertmanager + + + +_Generally available in Grafana Open Source and Enterprise_ + +We've added support for the Microsoft Teams contact points when using an external Alertmanager. + +## Authentication and authorization + +### No basic role + + + +_Generally available in Grafana Enterprise and Grafana Cloud_ + +We're excited to introduce the "No basic role," a new basic role with no permissions. A basic role in Grafana dictates the set of actions a user or entity can perform, known as permissions. This new role is especially beneficial if you're aiming for tailored, customized RBAC permissions for your service accounts or users. You can set this as a basic role through the API or UI. + +Previously, permissions were granted based on predefined sets of capabilities. Now, with the "No basic role," you have the flexibility to be even more granular. + +For more details on basic roles and permissions, refer to the [documentation](https://grafana.com/docs/grafana//administration/roles-and-permissions/). + +### New service account permissions + +[Service accounts](https://grafana.com/docs/grafana//administration/service-accounts/) allow you to create tokens to access Grafana's API and dashboards. Service accounts are a powerful tool for authenticating with Grafana's API and accessing data sources. However, without proper access controls, service accounts can pose a security risk to your Grafana instance. In Grafana 10.2, we've added new tools to limit service accounts to just the resources they need to access. + +#### Add dashboard and folder permissions to service accounts + + + +_Generally available in all editions of Grafana_ + +In this release, we've added the ability to assign dashboard and folder permissions to service accounts. +This means that you can now create a service account that can be used to access a specific dashboard and nothing else. + +This is useful if you want to limit the access service accounts have to your Grafana instance. + +Learn more in our [dashboard and folder permissions documentation](https://grafana.com/docs/grafana//administration/user-management/manage-dashboard-permissions/#manage-dashboard-permissions). + +#### Add data source permissions to service accounts + + + +_Generally available in Grafana Cloud and Grafana Enterprise_ + +Grafana 10.2 also introduces the ability to assign _data source_ permissions to service accounts, for Grafana CLoud and Enterprise users. +With this feature, you can create a service account that has access to a specific data source and nothing else. +This is useful in scenarios where you want to limit the access service accounts have to your Grafana instance. + +For example, imagine you have a team of developers who need to access a specific data source to develop a new feature. +Instead of giving them full access to your Grafana instance, you can create a service account that has access only to that data source. +This way, you can limit the potential damage that could be caused by a compromised service account. + +Learn more in our [data source permissions documentation](https://grafana.com/docs/grafana//administration/data-source-management/#data-source-permissions). + +{{< figure src="/media/docs/grafana/screenshot-grafana-10-2-sa-managed-permissions.png" max-width="600px" caption="Data source permissions in 10.2" >}} + +### Role mapping support for Google OIDC + + + +_Generally available in all editions of Grafana_ + +You can now map Google groups to Grafana organizational roles when using Google OIDC. +This is useful if you want to limit the access users have to your Grafana instance. + +We've also added support for controlling allowed groups when using Google OIDC. + +Refer to the [Google Authentication documentation](http://grafana.com/docs/grafana//setup-grafana/configure-security/configure-authentication/google/) to learn how to use these new options. + +### Configure refresh token handling separately for OAuth providers + + + +_Available in public preview in all editions of Grafana_ + +With Grafana v9.3, we introduced a [feature toggle](https://grafana.com/docs/grafana//setup-grafana/configure-grafana/feature-toggles/) called `accessTokenExpirationCheck`. It improves the security of Grafana by checking the expiration of the access token and automatically refreshing the expired access token when a user is logged in using one of the OAuth providers. + +With the current release, we've introduced a new configuration option for each OAuth provider called `use_refresh_token` that allows you to configure whether the particular OAuth integration should use refresh tokens to automatically refresh access tokens when they expire. In addition, to further improve security and provide secure defaults, `use_refresh_token` is enabled by default for providers that support either refreshing tokens automatically or client-controlled fetching of refresh tokens. It's enabled by default for the following OAuth providers: `AzureAD`, `GitLab`, `Google`. + +For more information on how to set up refresh token handling, please refer to [the documentation of the particular OAuth provider.](https://grafana.com/docs/grafana//setup-grafana/configure-security/configure-authentication/). + +{{% admonition type="note" %}} +The `use_refresh_token` configuration must be used in conjunction with the `accessTokenExpirationCheck` [feature toggle](https://grafana.com/docs/grafana//setup-grafana/configure-grafana/feature-toggles/). If you disable the `accessTokenExpirationCheck` feature toggle, Grafana won't check the expiration of the access token and won't automatically refresh the expired access token, even if the `use_refresh_token` configuration is set to `true`. + +The `accessTokenExpirationCheck` feature toggle will be removed in Grafana v10.3. +{{% /admonition %}} + +### Permission validation on custom role creation and update + + + +_Generally available in Grafana Enterprise and Grafana Cloud_ + +With the current release, we enabled RBAC permission validation (`rbac.permission_validation_enabled` setting) by default. This means that the permissions provided in the request during custom role creation or update are validated against the list of [available permissions and their scopes](https://grafana.com/docs/grafana//administration/roles-and-permissions/access-control/custom-role-actions-scopes/#action-definitions). If the request contains a permission that is not available or the scope of the permission is not valid, the request is rejected with an error message. + +## Recorded queries: Record multiple metrics from a single query + + + +_Generally available in Grafana Enterprise and Grafana Cloud_ + +Recorded queries provide a way to take a _static_ number, (for example, the number of GitHub issues open at a given time, or the number of rows in a database table) and record it periodically as a Prometheus metric. This is great for tracking numbers over time for quick querying later. Previously, recorded queries were limited to a single series, so you needed to narrow your query down to a single number in order to record it. Now, you can record multiple metrics with a single recorded query, which makes them more powerful _and_ easier to create and manage. + +