Docs: What’s new & Upgrade guide & Breaking changes v11.0 (#86369)

* Updated g11-preview pags for g11 release

* Added items to breaking changes guide

* Added and updated What's new content from latest Cloud file

* Updated link text

* Removed Azure Monitor item
pull/87725/head
Isabel Matwawana 1 year ago committed by GitHub
parent 77686da969
commit c2e8384090
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
  1. 2
      docs/sources/_index.md
  2. 24
      docs/sources/breaking-changes/breaking-changes-v11-0.md
  3. 8
      docs/sources/upgrade-guide/upgrade-v11.0/index.md
  4. 2
      docs/sources/whatsnew/_index.md
  5. 42
      docs/sources/whatsnew/whats-new-in-v11-0.md

@ -82,7 +82,7 @@ title: Grafana documentation
<p>Learn how to automate your Grafana configuration.</p>
</a>
<a href="{{< relref "whatsnew/whats-new-in-v11-0/" >}}" class="nav-cards__item nav-cards__item--guide">
<h4>What's new in v11.0-preview</h4>
<h4>What's new in v11.0</h4>
<p>Explore the features and enhancements in the latest release.</p>
</a>

@ -1,5 +1,5 @@
---
description: Breaking changes for Grafana v11.0-preview
description: Breaking changes for Grafana v11.0
keywords:
- grafana
- breaking changes
@ -12,16 +12,16 @@ labels:
- cloud
- enterprise
- oss
title: Breaking changes in Grafana v11.0-preview
title: Breaking changes in Grafana v11.0
weight: -3
---
<!-- vale GoogleWe = NO -->
<!-- vale We = NO -->
# Breaking changes in Grafana v11.0-preview
# Breaking changes in Grafana v11.0
Following are breaking changes that you should be aware of when upgrading to Grafana v11.0-preview.
Following are breaking changes that you should be aware of when upgrading to Grafana v11.0.
For our purposes, a breaking change is any change that requires users or operators to do something. This includes:
@ -38,7 +38,7 @@ For each change, the provided information:
- Guides you in how to mitigate for the change or migrate
- Provides more learning resources
For release highlights and deprecations, refer to our [v11.0-preview What’s new](https://grafana.com/docs/grafana/<GRAFANA_VERSION>/whatsnew/whats-new-in-v11-0/). For the specific steps we recommend when you upgrade to v11.0, check out our [Upgrade guide](https://grafana.com/docs/grafana/<GRAFANA_VERSION>/upgrade-guide/upgrade-v11.0/).
For release highlights and deprecations, refer to our [v11.0 What’s new](https://grafana.com/docs/grafana/<GRAFANA_VERSION>/whatsnew/whats-new-in-v11-0/). For the specific steps we recommend when you upgrade to v11.0, check out our [Upgrade guide](https://grafana.com/docs/grafana/<GRAFANA_VERSION>/upgrade-guide/upgrade-v11.0/).
<!--
## Feature
@ -104,7 +104,7 @@ Ensure deprecated endpoints are updated to new corresponding endpoints and depre
#### Learn more
The [Reporting documentation](https://grafana.com/docs/grafana/<GRAFANA_VERSION>/developers/http_api/reporting/) lists all supported endpoints and fields.
The [Reporting API documentation](https://grafana.com/docs/grafana/<GRAFANA_VERSION>/developers/http_api/reporting/) lists all supported endpoints and fields.
### Change custom branding public dashboard footer behavior
@ -157,6 +157,8 @@ We’re also moving the call to the `datasource.filterQuery` method to the query
If data is missing in panels, make sure the query editor **Hide response** button is not clicked.
For data sources that extend `DataSourceWithBackend`, the filterQuery method is now called before the data source query method. If the `filterQuery` method assumes that some kind of query migration happens before this method is called, you now need to do the migration inside this method too.
#### Learn more
[GitHub PR](https://github.com/grafana/grafana/pull/84656)
@ -201,6 +203,16 @@ For a complete guide, please follow our [migration docs on the developer portal]
- Official react-router v5 to v6 [migration guide](https://reactrouter.com/en/main/upgrading/v5)
- Grafana community forum [topic](https://community.grafana.com/t/migrating-app-plugins-to-use-react-router-v6/115410)
### The grafana/e2e testing tool is deprecated
#### Description
The Cypress based grafana/e2e end-to-end testing tool is now deprecated.
#### Migration/mitigation
We recommend all plugin authors to migrate their end-to-end tests to use the new Playwright-based [grafana/plugin-e2e](https://www.npmjs.com/package/@grafana/plugin-e2e?activeTab=readme) package instead. Find details on how to migrate from grafana/e2e to grafana/plugin-e2e in the [migration guide](https://grafana.com/developers/plugin-tools/e2e-test-a-plugin/migrate-from-grafana-e2e).
### Chore: Taint ArrayVector with `never` to further discourage
[GitHub PR](https://github.com/grafana/grafana/pull/83681)

@ -1,5 +1,5 @@
---
description: Guide for upgrading to Grafana v11.0-preview
description: Guide for upgrading to Grafana v11.0
keywords:
- grafana
- configuration
@ -7,12 +7,12 @@ keywords:
- upgrade
- '11.0'
- '11.0-preview'
title: Upgrade to Grafana v11.0-preview
menuTitle: Upgrade to v11.0-preview
title: Upgrade to Grafana v11.0
menuTitle: Upgrade to v11.0
weight: 1200
---
# Upgrade to Grafana v11.0-preview
# Upgrade to Grafana v11.0
{{< docs/shared lookup="upgrade/intro.md" source="grafana" version="<GRAFANA VERSION>" >}}

@ -76,7 +76,7 @@ For a complete list of every change, with links to pull requests and related iss
# Grafana 11
- [What's new in 11.0-preview](https://grafana.com/docs/grafana/<GRAFANA_VERSION>/whatsnew/whats-new-in-v11-0/)
- [What's new in 11.0](https://grafana.com/docs/grafana/<GRAFANA_VERSION>/whatsnew/whats-new-in-v11-0/)
## Grafana 10

@ -1,5 +1,5 @@
---
description: Feature and improvement highlights for Grafana v11.0-preview
description: Feature and improvement highlights for Grafana v11.0
keywords:
- grafana
- new
@ -12,24 +12,22 @@ products:
- cloud
- enterprise
- oss
title: What's new in Grafana v11.0-preview
title: What's new in Grafana v11.0
weight: -42
---
<!-- vale GoogleWe = NO -->
<!-- vale We = NO -->
# What’s new in Grafana v11.0-preview
# What’s new in Grafana v11.0
Welcome to Grafana 11.0-preview! This release contains some major improvements: most notably, the ability to explore your Prometheus metrics and Loki logs without writing any PromQL or LogQL, using Explore Metrics and Explore Logs. The dashboard experience is better than ever with edit mode for dashboards, AI-generated dashboard names and descriptions, and general availability for subfolders. You can also take advantage of improvements to the canvas and table visualizations, new transformations, a revamp of the Alert Rule page, and more.
Welcome to Grafana 11.0! This release contains some major improvements: most notably, the ability to explore your Prometheus metrics and Loki logs without writing any PromQL or LogQL, using Explore Metrics and Explore Logs. The dashboard experience is better than ever with edit mode for dashboards, AI-generated dashboard names and descriptions, and general availability for subfolders. You can also take advantage of improvements to the canvas and table visualizations, new transformations, a revamp of the Alert Rule page, and more.
Why "preview?" The Grafana 11.0 stable release is planned for this May. This is an early release to coincide with [Grafanacon 2024](https://grafana.com/about/events/grafanacon/2024/), so that you can try the new functionality early. To understand the differences between preview and GA releases, review the [release life cycle](https://grafana.com/docs/release-life-cycle/).
For even more detail about all the changes in this release, refer to the [changelog](https://github.com/grafana/grafana/blob/main/CHANGELOG.md). For the specific steps we recommend when you upgrade to v11.0-preview, check out our [Upgrade Guide](https://grafana.com/docs/grafana/<GRAFANA_VERSION>/upgrade-guide/upgrade-v11.0/).
For even more detail about all the changes in this release, refer to the [changelog](https://github.com/grafana/grafana/blob/main/CHANGELOG.md). For the specific steps we recommend when you upgrade to v11.0, check out our [Upgrade Guide](https://grafana.com/docs/grafana/<GRAFANA_VERSION>/upgrade-guide/upgrade-v11.0/).
## Breaking changes
For Grafana v11.0-preview, we've also provided a list of [breaking changes](https://grafana.com/docs/grafana/<GRAFANA_VERSION>/breaking-changes/breaking-changes-v11-0) to help you upgrade with greater confidence. For information about these along with guidance on how to proceed, refer to [Breaking changes in Grafana v11.0-preview](https://grafana.com/docs/grafana/<GRAFANA_VERSION>/breaking-changes/breaking-changes-v11-0/).
For Grafana v11.0, we've also provided a list of [breaking changes](https://grafana.com/docs/grafana/<GRAFANA_VERSION>/breaking-changes/breaking-changes-v11-0) to help you upgrade with greater confidence. For information about these along with guidance on how to proceed, refer to [Breaking changes in Grafana v11.0](https://grafana.com/docs/grafana/<GRAFANA_VERSION>/breaking-changes/breaking-changes-v11-0/).
<!-- Template below
@ -56,10 +54,10 @@ Use full URLs for links. When linking to versioned docs, replace the version wit
_Public preview in all editions of Grafana_
Explore Metrics is a query-less experience for browsing Prometheus-compatible metrics. Search or filter to find a metric. Quickly find related metrics - all in just a few clicks. No PromQL to be found anywhere! With Explore Metrics, you can:
Explore Metrics is a query-less experience for browsing Prometheus-compatible metrics. Search for or filter to find a metric. Quickly find related metrics - all in just a few clicks. You do not need to learn PromQL! With Explore Metrics, you can:
- easily slice and dice metrics based on their labels, so you can see anomalies right away
- See the right visualization for your metric based on its type (e.g. gauge vs. counter) without writing it yourself
- See the right visualization for your metric based on its type (e.g. gauge vs. counter) without building it yourself
- surface other metrics relevant to the current metric
- “explore in a drawer” - expand a drawer over a dashboard with more content, so you don’t lose your place
- view a history of user steps when navigating through metrics and their filters
@ -67,7 +65,7 @@ Explore Metrics is a query-less experience for browsing Prometheus-compatible me
… all without writing any queries!
To learn more, refer to the Explore Metrics [documentation](https://grafana.com/docs/grafana/<GRAFANA_VERSION>/explore/explore-metrics/) as well as the following video demo:
To learn more, refer to [Explore Metrics](https://grafana.com/docs/grafana/<GRAFANA_VERSION>/explore/explore-metrics/) as well as the following video demo:
{{< youtube id="JbaPufQs5LY" >}}
@ -310,25 +308,19 @@ Debug or audit using the alert rule metadata and view the alert rule annotations
![Image shows details of an alert rule](/media/docs/alerting/alert-detail-view.png)
## Data sources
### Azure Monitor: Current User authentication
<!-- #grafana-partner-datasources, @Andreas -->
### RBAC for alert rule provisioning APIs
_Experimental in all editions of Grafana_
<!-- Yuri Tseretyan -->
You can now configure the Azure Monitor data source to authenticate as the logged-in Grafana user when making query and resource requests if you also use Azure Entra to sign your users into Grafana.
Current User authentication allows you to enforce Azure RBAC restrictions on your Grafana users by removing the need to provide broad service credentials. Once a data source is configured with Current User authentication a user will **only** have access to resources they can access directly in Azure.
Additionally, data sources configured to use Current User authentication are less likely to be impacted by throttling issues due to the individual level of access.
_Generally available in all editions of Grafana_
Current User authentication does not inherently support backend features such as alerting. To account for this, data sources configured with Current User authentication can optionally specify service credentials that will be utilized for backend features when no signed-in user is available.
The Alerting Provisioning HTTP API has been updated to enforce Role-Based Access Control (RBAC).
To get started with Current User authentication, refer to the [Azure Monitor data source documentation](https://grafana.com/docs/grafana/<GRAFANA_VERSION>/datasources/azure-monitor/#configure-current-user-authentication).
- For Grafana OSS, users with the **Editor** role can now use the API.
- For Grafana Enterprise and Grafana Cloud, users with the role **Rules Writer** and **Set Provisioning status** can access the API and limit access to alert rules that use a particular data source.
- Other roles related to provisioning, for example **Access to alert rules** provisioning API still work.
{{< figure src="/media/docs/grafana/data-sources/screenshot-current-user.png" alt="Data source configured with Current User authentication" >}}
## Data sources
### Removal of old Tempo Search and Loki Search in Tempo

Loading…
Cancel
Save