From 9138b38b93ba2a419b3210af57a0cb571a7472d4 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Torkel=20=C3=96degaard?= Date: Mon, 5 Feb 2018 16:32:30 +0100 Subject: [PATCH 1/6] Update CHANGELOG.md --- CHANGELOG.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 62d9385a526..c24983bf38d 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,4 +1,6 @@ -# 5.0.0 (unreleased / master branch) +# 5.0.0-beta2 (unrelased) + +# 5.0.0-beta1 (2018-02-05) Grafana v5.0 is going to be the biggest and most foundational release Grafana has ever had, coming with a ton of UX improvements, a new dashboard grid engine, dashboard folders, user teams and permissions. Checkout out this [video preview](https://www.youtube.com/watch?v=BC_YRNpqj5k) of Grafana v5. From e86fe0b1444bb0ec33a952be1f14c81dacc4bcad Mon Sep 17 00:00:00 2001 From: Marcus Efraimsson Date: Mon, 5 Feb 2018 16:40:49 +0100 Subject: [PATCH 2/6] docs: update dashboard model, new url structure and api changes in what's new in v5 --- docs/sources/guides/whats-new-in-v5.md | 19 +++++++++++++------ 1 file changed, 13 insertions(+), 6 deletions(-) diff --git a/docs/sources/guides/whats-new-in-v5.md b/docs/sources/guides/whats-new-in-v5.md index 0cda207d650..6c70682d3f6 100644 --- a/docs/sources/guides/whats-new-in-v5.md +++ b/docs/sources/guides/whats-new-in-v5.md @@ -111,10 +111,17 @@ in sync with dashboards in Grafana's database. The dashboard provisioner has mul which makes it possible to star them, use one as the home dashboard, set permissions and other features in Grafana that expects the dashboards to exist in the database. More info in the [dashboard provisioning docs](/administration/provisioning/#dashboards) -# Dashboard model & API +# Dashboard model, new url structure & API changes -We are introducing a new identifier (`uid`) in the dashboard JSON model. The new identifier will be a 9-12 character long unique id. -We are also changing the route for getting dashboards to use this `uid` instead of the slug that the current route and API are using. -We will keep supporting the old route for backward compatibility. This will make it possible to change the title on dashboards without breaking links. -Sharing dashboards between instances becomes much easier since the uid is unique (unique enough). This might seem like a small change, -but we are incredibly excited about it since it will make it much easier to manage, collaborate and navigate between dashboards. +We are introducing a new unique identifier (`uid`) in the dashboard JSON model. It's automatically +generated if not provided when creating a dashboard and will have a length of 9-12 characters. + +The unique identifier allows having consistent URL's for accessing dashboards and sharing them +between instances. The new routes and API's for accessing dashboards will use the `uid` instead +of the `slug`. We'll keep supporting the old routes for accessing dashboards for backward +compatibility, but please note that we'll deprecate the old slug-based routes in the future. +This means that changing the title of dashboards will not break any bookmarked links. + +Sharing dashboards between instances becomes much easier since the `uid` is unique (unique enough). +This might seem like a small change, but we are incredibly excited about it since it will make it +much easier to manage, collaborate and navigate between dashboards. From 24a1abaab2b98a59f589acfee39efbdeca28790b Mon Sep 17 00:00:00 2001 From: Marcus Efraimsson Date: Mon, 5 Feb 2018 16:50:33 +0100 Subject: [PATCH 3/6] Update CHANGELOG.md --- CHANGELOG.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index c24983bf38d..68470d6a1c5 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -11,6 +11,7 @@ Grafana v5.0 is going to be the biggest and most foundational release Grafana ha - **Templating**: Vertical repeat direction for panel repeats. - **UX**: Major update to page header and navigation - **Dashboard settings**: Combine dashboard settings views into one with side menu, [#9750](https://github.com/grafana/grafana/issues/9750) +- **Persistent dashboard url's**: New url's for dashboards that allows renaming dashboards without breaking links. [#7883](https://github.com/grafana/grafana/issues/7883) ## Breaking changes @@ -21,7 +22,7 @@ From `/etc/grafana/datasources` to `/etc/grafana/provisioning/datasources` when * **Pagerduty** The notifier now defaults to not auto resolve incidents. More details at [#10222](https://github.com/grafana/grafana/issues/10222) * **HTTP API** -- `GET /api/alerts` property dashboardUri renamed to url and is now the full url (that is including app sub url). +- `GET /api/alerts` property dashboardUri renamed to url and is now the full url (that is including app sub url). ## New Dashboard Grid From 7a968c10251538225a8f3f9f45e45f73dfbe6668 Mon Sep 17 00:00:00 2001 From: Marcus Efraimsson Date: Mon, 5 Feb 2018 16:53:32 +0100 Subject: [PATCH 4/6] Update CHANGELOG.md --- CHANGELOG.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 68470d6a1c5..901a2145e0f 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -22,7 +22,7 @@ From `/etc/grafana/datasources` to `/etc/grafana/provisioning/datasources` when * **Pagerduty** The notifier now defaults to not auto resolve incidents. More details at [#10222](https://github.com/grafana/grafana/issues/10222) * **HTTP API** -- `GET /api/alerts` property dashboardUri renamed to url and is now the full url (that is including app sub url). + - `GET /api/alerts` property dashboardUri renamed to url and is now the full url (that is including app sub url). ## New Dashboard Grid From e9aadab3552b2ea21da7dc2cf0106591528b4a1c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Torkel=20=C3=96degaard?= Date: Mon, 5 Feb 2018 16:59:06 +0100 Subject: [PATCH 5/6] docs: updated whats new --- docs/sources/guides/whats-new-in-v5.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/sources/guides/whats-new-in-v5.md b/docs/sources/guides/whats-new-in-v5.md index 6c70682d3f6..5eef8b73615 100644 --- a/docs/sources/guides/whats-new-in-v5.md +++ b/docs/sources/guides/whats-new-in-v5.md @@ -12,6 +12,8 @@ weight = -6 # What's New in Grafana v5.0 +> Out in beta: [Download now!](https://grafana.com/grafana/download/5.0.0-beta1) + This is the most substantial update that Grafana has ever seen. This article will detail the major new features and enhancements. - [New Dashboard Layout Engine]({{< relref "#new-dashboard-layout-engine" >}}) enables a much easier drag, drop and resize experience and new types of layouts. From 061320ba7b2d8cbfc498ffb7e8fb2c7f1fca5a6f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Torkel=20=C3=96degaard?= Date: Mon, 5 Feb 2018 17:26:44 +0100 Subject: [PATCH 6/6] docs: minor update --- docs/sources/administration/permissions.md | 11 ++++++++++- docs/sources/guides/whats-new-in-v5.md | 8 ++++++-- 2 files changed, 16 insertions(+), 3 deletions(-) diff --git a/docs/sources/administration/permissions.md b/docs/sources/administration/permissions.md index 34459e2319a..5796d50f1fe 100644 --- a/docs/sources/administration/permissions.md +++ b/docs/sources/administration/permissions.md @@ -31,7 +31,7 @@ Can do everything scoped to the organization. For example: - Add & Edit data sources. - Add & Edit organization users & teams. - Configure App plugins & set org settings. - + ### Editor Role - Can create and modify dashboards & alert rules. This can be disabled on specific folders and dashboards. @@ -74,3 +74,12 @@ Access Control List (ACL). - You cannot override permissions for users with **Org Admin Role** - A more specific permission with lower permission level will not have any effect if a more general rule exists with higher permission level. For example if "Everyone with Editor Role Can Edit" exists in the ACL list then **John Doe** will still have Edit permission even after you have specifically added a permission for this user with the permission set to **View**. You need to remove or lower the permission level of the more general rule. + +### Data source permissions + +Permissions on dashboards and folders **do not** include permissions on data sources. A user with `Viewer` role +can still issue any possible query to a data source, not just those queries that exist on dashboards he/she has access to. +We hope to add permissions on data sources in a future release. Until then **do not** view dashboard permissions as a secure +way to restrict user data access. Dashboard permissions only limits what dashboards & folders a user can view & edit not which +data sources a user can access nor what queries a user can issue. + diff --git a/docs/sources/guides/whats-new-in-v5.md b/docs/sources/guides/whats-new-in-v5.md index 5eef8b73615..0dd9337e404 100644 --- a/docs/sources/guides/whats-new-in-v5.md +++ b/docs/sources/guides/whats-new-in-v5.md @@ -12,7 +12,7 @@ weight = -6 # What's New in Grafana v5.0 -> Out in beta: [Download now!](https://grafana.com/grafana/download/5.0.0-beta1) +> Out in beta: [Download now!](https://www.youtube.com/watch?v=Izr0IBgoTZQ) This is the most substantial update that Grafana has ever seen. This article will detail the major new features and enhancements. @@ -87,7 +87,11 @@ We hope to do more with teams in future releases like integration with LDAP and {{< docs-imagebox img="/img/docs/v50/folder_permissions.png" max-width="1000px" class="docs-image--right" >}} -You can assign permissions to folders and dashboards. The default user role-based permissions can be removed and replaced with specific teams or users enabling more control over what a user can see and edit. +You can assign permissions to folders and dashboards. The default user role-based permissions can be removed and +replaced with specific teams or users enabling more control over what a user can see and edit. + +Dashboard permissions only limits what dashboards & folders a user can view & edit not which +data sources a user can access nor what queries a user can issue.