[v10.0.x] docs: What's New & Upgrade Guide 10.0 (#69306)

docs: What's New & Upgrade Guide 10.0 (#64927) * updated what's new index and added v10.0 what's new and upgrade guide * Update _index.md * Added nested folders * Nested folders screenshot * Add draft of Correlations what's new content * Correlations minor edit * add dashboards whats new * What's new: Query multiple data sources in Explore * Update docs/sources/whatsnew/whats-new-in-v10-0.md Co-authored-by: Dominik Prokop <dominik.prokop@grafana.com> * AuthNZ: What's new in Grafana 10.0 (#66362) * AuthNZ: What's new in Grafana 10.0 * Add upgrade guides * Apply suggestions from code review Co-authored-by: Ieva <ieva.vasiljeva@grafana.com> * Apply suggestions from code review Co-authored-by: Jo <joao.guerreiro@grafana.com> * Apply suggestions from code review Co-authored-by: Jo <joao.guerreiro@grafana.com> --------- Co-authored-by: Ieva <ieva.vasiljeva@grafana.com> Co-authored-by: Jo <joao.guerreiro@grafana.com> * Added span filters section * add info about dashboard previews removal * Update docs/sources/whatsnew/whats-new-in-v10-0.md Co-authored-by: Ivan Ortega Alba <ivanortegaalba@gmail.com> * add datagrid and drag and drop * combine new ds picker and panel onboarding content * Logs: Add LogContext to What's New v10 (#66575) * add log context description * change `eyeball button` to `eye icon` * Adds Alerting entries for 10 * Add Azure Monitor entry for v10 * add public dashboards features * small tweaks to public dashboards content * Add Security: Trusted types section * Add DataViz: initial placeholder sections with some content * Adds alerting entry for templates * Adds an and * update headings * fix link format and update wording * nesting topics under dashboards and visualizations, updated headers * Adds oncall contact point entry * Copyedits for oncall alerting entry * add incremental querying blurb to whats-new * Renaming nested folders to subfolders * Update what's new to indicate availability of features and improve messaging (#66755) * Added image for time regions * update wording for feature release stage * Add section about Phlare data source rename * restructuring and styling fixes * add datasource picker recording * Log Context: Improved "Whats New" text (#67285) * improve "Log context" whats new * change screenshot * Update docs/sources/whatsnew/whats-new-in-v10-0.md Co-authored-by: Matias Chomicki <matyax@gmail.com> * fix spelling * Update docs/sources/whatsnew/whats-new-in-v10-0.md Co-authored-by: J Stickler <julie.stickler@grafana.com> * Update docs/sources/whatsnew/whats-new-in-v10-0.md Co-authored-by: J Stickler <julie.stickler@grafana.com> * Update docs/sources/whatsnew/whats-new-in-v10-0.md Co-authored-by: J Stickler <julie.stickler@grafana.com> * Update docs/sources/whatsnew/whats-new-in-v10-0.md Co-authored-by: J Stickler <julie.stickler@grafana.com> * change image --------- Co-authored-by: Matias Chomicki <matyax@gmail.com> Co-authored-by: J Stickler <julie.stickler@grafana.com> * wording and style edits * Update how to use Trusted Types * Adding opentracing deprecation notes * Adding opentracing deprecation notes * added breaking changes with raw markdown * updated page weight * state location of public dashboards list more explicitly * added email sharing user admin info * clarified what was fixed * Deletes oncall entry * added heading markdown * replaced absolute links with relrefs * fixed relrefs * Update canvas GA section to include connection properties * canvas: slight grammar update * updated template and name of contributor field for each item * adding contributor name * added contributor names to what's new * added contributor names to what's new and upgrade guide * fixed typo * Docs: What is new 10 - add Data plane (#68125) * Remove drag & drop to dashboard * Add PDC to 10.0 what's new * reorder sections, edit copy * update order, format and copy * grammar fix add "and" * add intro text to breaking changes pages * fix Explore mixed DS what's new doc (#68303) Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com> * Remove datagrid from what's new, drag and drop to experimental * Update docs/sources/whatsnew/whats-new-in-v10-0.md * updates to data source picker availability * Update what's new for canvas / trend panel (finalized) * Update ds picker recording * Add deprecation notice for changing folder UID * docs: update with angular plugin list * Update with documentations links for annotation filtering and time regions * Update annotation filtering section in docs/sources/whatsnew/whats-new-in-v10-0.md * add datagrid as experimental * modify datagrid doc accordingly * Update docs/sources/whatsnew/whats-new-in-v10-0.md Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com> * adds alerting screenshot * deletes sentence * adds state history pic * resolving outstanding suggestions Co-authored-by: David Harris <david.harris@grafana.com> Co-authored-by: Nathan Marrs <nathanielmarrs@gmail.com> Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com> * changed order of sections * updated text about breaking changes in whats new and upgrade guide * fixed links * copy edits * general copy edits * removed TO DOs from whats new, copy edited upgrade guide, some copy edits of breaking changes * fix doc validator errors * added availability information, updated preview notes, replaced screenshot * copy edit, added links, added breaking changes content * general copy edit of breaking changes; small update to common tasks * replaced notes with admonitions * link fixes * reverted blog links to full addresses * fixed heading inconsisency * fix doc validator error * added availability note * added missing availability notes * replaced screenshot and fixed wording * replaced screenshot and fixed wording * Updated subfolders description To call out missing features and stress that it can only be used in dev/test environments * added availability note --------- Co-authored-by: Christopher Moyer <35463610+chri2547@users.noreply.github.com> Co-authored-by: Zsofia <zsofia.komaromi@gmail.com> Co-authored-by: Josiah (Jay) Goodson <josiah.goodson@gmail.com> Co-authored-by: natellium <natalia.bernarte@grafana.com> Co-authored-by: Piotr Jamróz <pm.jamroz@gmail.com> Co-authored-by: Natalia Bernarte Oses <74534993+natellium@users.noreply.github.com> Co-authored-by: Dominik Prokop <dominik.prokop@grafana.com> Co-authored-by: Vardan Torosyan <vardants@gmail.com> Co-authored-by: Ieva <ieva.vasiljeva@grafana.com> Co-authored-by: Jo <joao.guerreiro@grafana.com> Co-authored-by: Joey Tawadrous <joey.tawadrous@grafana.com> Co-authored-by: Artur Wierzbicki <artur.wierzbicki@grafana.com> Co-authored-by: Ivan Ortega Alba <ivanortegaalba@gmail.com> Co-authored-by: Oscar Kilhed <oscar.kilhed@grafana.com> Co-authored-by: Sven Grossmann <sven.grossmann@grafana.com> Co-authored-by: brendamuir <100768211+brendamuir@users.noreply.github.com> Co-authored-by: Andreas Christou <andreas.christou@grafana.com> Co-authored-by: Tobias Skarhed <1438972+tskarhed@users.noreply.github.com> Co-authored-by: nmarrs <nathanielmarrs@gmail.com> Co-authored-by: Galen <galen.kistler@grafana.com> Co-authored-by: Adela Almasan <adela.almasan@grafana.com> Co-authored-by: Andrej Ocenas <mr.ocenas@gmail.com> Co-authored-by: Matias Chomicki <matyax@gmail.com> Co-authored-by: J Stickler <julie.stickler@grafana.com> Co-authored-by: Timur Olzhabayev <timur.olzhabayev@grafana.com> Co-authored-by: Kyle Brandt <kyle@grafana.com> Co-authored-by: Mitchel Seaman <mitchel.seaman@gmail.com> Co-authored-by: Giordano Ricci <me@giordanoricci.com> Co-authored-by: Ezequiel Victorero <ezequiel.victorero@grafana.com> Co-authored-by: Sofia Papagiannaki <1632407+papagian@users.noreply.github.com> Co-authored-by: David Harris <david.harris@grafana.com> Co-authored-by: Victor Marin <victor.marin@grafana.com> Co-authored-by: Joey <90795735+joey-grafana@users.noreply.github.com> Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com> (cherry picked from commit d4ef06451c) Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>
2023-05-31 09:15:15 -04:00
parent e5f99bf7e5
commit c0627d8a16
8 changed files with 866 additions and 6 deletions
@@ -9,7 +9,7 @@ keywords:
  - documentation
  - upgrade
 title: Upgrade Grafana
-weight: 380
+weight: 3
 ---

 # Upgrade Grafana
@@ -0,0 +1,94 @@
+---
+description: Guide for upgrading to Grafana v10.0
+keywords:
+  - grafana
+  - configuration
+  - documentation
+  - upgrade
+title: Upgrade to Grafana v10.0
+menutitle: Upgrade to v10.0
+weight: 1700
+---
+
+# Upgrade to Grafana v10.0
+
+{{< docs/shared "upgrade/upgrade-common-tasks.md" >}}
+
+## Technical notes
+
+### Role-based access control changes
+
+<!-- Vardan Torosyan -->
+
+Role-based access control (RBAC) is now always enabled and we've removed the option to disable it.
+
+No action is required.
+
+However, if you decide to **downgrade** for any reason and **disable RBAC**, you'll need to run through the following guide before upgrading again.
+
+The aforementioned sequence of actions (upgrade, downgrade, disable RBAC, upgrade again) causes legacy access control and role-based access control systems to be out of sync.
+As a side effect, permissions for some Grafana resources, like dashboards, might be lost.
+To prevent that from happening, before you upgrade Grafana back again, please take the following steps:
+
+1. Stop Grafana.
+2. In your database, run the following SQL queries:
+
+```sql
+DELETE
+FROM builtin_role
+where role_id IN (SELECT id
+                  FROM role
+                  WHERE name LIKE 'managed:%');
+
+DELETE
+FROM team_role
+where role_id IN (SELECT id
+                  FROM role
+                  WHERE name LIKE 'managed:%');
+
+DELETE
+FROM user_role
+where role_id IN (SELECT id
+                  FROM role
+                  WHERE name LIKE 'managed:%');
+
+DELETE
+FROM permission
+where role_id IN (SELECT id
+                  FROM role
+                  WHERE name LIKE 'managed:%');
+
+DELETE
+FROM role
+WHERE name LIKE 'managed:%';
+
+DELETE
+FROM migration_log
+WHERE migration_id IN ('teams permissions migration',
+                       'dashboard permissions',
+                       'dashboard permissions uid scopes',
+                       'data source permissions',
+                       'data source uid permissions',
+                       'managed permissions migration',
+                       'managed folder permissions alert actions repeated migration',
+                       'managed permissions migration enterprise');
+```
+
+3. Start Grafana again.
+
+### Case-insensitive usernames and email addresses
+
+<!-- Vardan Torosyan -->
+
+Usernames and email addresses are now treated as case-insensitive in Grafana. If you're not using MySQL as a database, potential user identity conflicts may arise when users try to log in.
+We recommend you resolve any potential conflicts in advance by using the [Grafana CLI tool for managing user conflicts](/blog/2022/12/12/guide-to-using-the-new-grafana-cli-user-identity-conflict-tool-in-grafana-9.3/).
+
+### Dashboard previews removal
+
+<!-- Artur Wierzbicki -->
+
+We've removed the Dashboard previews feature introduced behind a feature flag in Grafana version 9.0.
+
+No action is required.
+
+The `dashboardPreviews` feature flag is no longer available and can be safely removed from the Grafana server configuration.