From 13579b76d9a11a729629182eb621f00ec973a542 Mon Sep 17 00:00:00 2001 From: Daniel Lee Date: Mon, 28 Jan 2019 18:43:41 +0100 Subject: [PATCH 01/13] docs: wip - what's new for 6.0 --- .../features/datasources/stackdriver.md | 4 +- docs/sources/features/explore/index.md | 17 ----- docs/sources/guides/whats-new-in-v5-3.md | 2 +- docs/sources/guides/whats-new-in-v6-0.md | 75 +++++++++++++++++++ 4 files changed, 78 insertions(+), 20 deletions(-) create mode 100644 docs/sources/guides/whats-new-in-v6-0.md diff --git a/docs/sources/features/datasources/stackdriver.md b/docs/sources/features/datasources/stackdriver.md index 2c14d897d8e..d1cc1088276 100644 --- a/docs/sources/features/datasources/stackdriver.md +++ b/docs/sources/features/datasources/stackdriver.md @@ -12,8 +12,8 @@ weight = 11 # Using Google Stackdriver in Grafana -> Only available in Grafana v5.3+. -> The datasource is currently a beta feature and is subject to change. +> Available as a beta feature in Grafana v5.3.x and v5.4.x. +> Officially released in Grafana v6.0.0 Grafana ships with built-in support for Google Stackdriver. Just add it as a datasource and you are ready to build dashboards for your Stackdriver metrics. diff --git a/docs/sources/features/explore/index.md b/docs/sources/features/explore/index.md index 0ba3d2f7d44..6580bcf217f 100644 --- a/docs/sources/features/explore/index.md +++ b/docs/sources/features/explore/index.md @@ -27,23 +27,6 @@ For infrastructure monitoring and incident response, you no longer need to switc If you just want to explore your data and do not want to create a dashboard then Explore makes this much easier. Explore will show the results as both a graph and a table enabling you to see trends in the data and more detail at the same time (if the datasource supports both graph and table data). -## Turning the Explore Feature On - -Explore will be officially released in Grafana 6.0. It is however already in the latest nightly builds of Grafana and can be turned using a feature flag in the config file. Restart Grafana after making the config file change. - -```ini -[explore] -# Enable the Explore section -enabled = true -``` - -Or if using docker: - -```bash -docker pull grafana/grafana:master -docker run --name grafana -p 3000:3000 -e "GF_EXPLORE_ENABLED=true" grafana/grafana:master -``` - ## How to Start Exploring There is a new Explore icon on the menu bar to the left. This opens a new empty Explore tab. diff --git a/docs/sources/guides/whats-new-in-v5-3.md b/docs/sources/guides/whats-new-in-v5-3.md index 10592f51648..abd83e7e002 100644 --- a/docs/sources/guides/whats-new-in-v5-3.md +++ b/docs/sources/guides/whats-new-in-v5-3.md @@ -26,7 +26,7 @@ Grafana v5.3 brings new features, many enhancements and bug fixes. This article {{< docs-imagebox img="/img/docs/v53/stackdriver-with-heatmap.png" max-width= "600px" class="docs-image--no-shadow docs-image--right" >}} -Grafana v5.3 ships with built-in support for [Google Stackdriver](https://cloud.google.com/stackdriver/) and enables you to visualize your Stackdriver metrics in Grafana. +Grafana v5.3 ships with built-in support for [Google Stackdriver](https://cloud.google.com/stackdriver/) and enables you to visualize your Stackdriver metrics in Grafana. Getting started with the plugin is easy. Simply create a GCE Service account that has access to the Stackdriver API scope, download the Service Account key file from Google and upload it on the Stackdriver datasource config page in Grafana and you should have a secure server-to-server authentication setup. Like other core plugins, Stackdriver has built-in support for alerting. It also comes with support for heatmaps and basic variables. diff --git a/docs/sources/guides/whats-new-in-v6-0.md b/docs/sources/guides/whats-new-in-v6-0.md new file mode 100644 index 00000000000..70117148dc9 --- /dev/null +++ b/docs/sources/guides/whats-new-in-v6-0.md @@ -0,0 +1,75 @@ ++++ +title = "What's New in Grafana v6.0" +description = "Feature & improvement highlights for Grafana v6.0" +keywords = ["grafana", "new", "documentation", "6.0"] +type = "docs" +[menu.docs] +name = "Version 6.0" +identifier = "v6.0" +parent = "whatsnew" +weight = -11 ++++ + +# What's New in Grafana v6.0 + +This update to Grafana introduces a new way of exploring your data, support for log data and tons of other features. + +The main highlights are: + +- The new query-focused [Explore]({{< relref "#explore" >}}) workflow for troubleshooting and/or for data exploration. +- [Support for Grafana Loki]({{< relref "#explore-and-grafana-loki" >}}) - a new open source log aggregation system from Grafana Labs. +- [Easily Switch Visualization with the Panel Edit UX Update]({{< relref "#easily-switch-visualization-with-panel-edit-ux-update" >}}) +- [Google Stackdriver Datasource]({{< relref "#google-stackdriver-datasource" >}}) is out of beta and is officially released. +- The [Azure Monitor]({{< relref "#azure-monitor-datasource" >}}) plugin is ported from being an external plugin to being a core datasource + +### Explore + +Grafana's dashboard UI is all about building dashboards for visualization. **Explore** strips away all the dashboard and panel options so that you can focus on the query. Iterate until you have a working query and then think about building a dashboard. + +For infrastructure monitoring and incident response, you no longer need to switch to other tools to debug what went wrong. **Explore** allows you to dig deeper into your metrics and logs to find the cause. Grafana's new logging datasource, [Loki](https://github.com/grafana/loki) is tightly integrated into Explore and allows you to correlate metrics and logs by viewing them side-by-side. + +{{< docs-imagebox img="/img/docs/v60/explore_split.png" class="docs-image--no-shadow" caption="Screenshot of the new Explore option in the panel menu" >}} + +**Explore** is a new paradigm for Grafana. It creates a new interactive debugging workflow that integrates two pillars of observability - metrics and logs. + +#### Explore and Prometheus + +The first version of Explore features a [custom querying experience for Prometheus](/features/explore/#prometheus-specific-features) and as well as an integration between Prometheus and Grafana Loki (see more about Loki below). + +### Explore and Grafana Loki + +The Explore feature allows you to combine metric queries and log queries. The first log integration is for the new open source log aggregation system from Grafana Labs called [Grafana Loki](https://github.com/grafana/loki). + +Loki a horizontally-scalable, highly-available, multi-tenant log aggregation system inspired by Prometheus. It is designed to be very cost effective, as it does not index the contents of the logs, but rather a set of labels for each log stream. The logs from Loki are queried in a similar way to querying with label selectors in Prometheus. It uses labels to group log streams which can be made to match up with your Prometheus labels. + +Read more about Grafana Loki [here](https://github.com/grafana/loki) or [Grafana Labs hosted Loki](https://grafana.com/loki). + +The Explore feature allows you to query logs and features a new log panel. + +{{< docs-imagebox img="/img/docs/v60/explore_loki.png" class="docs-image--no-shadow" caption="Explore Loki Log Streams" >}} + +In the near future, we will be adding support for other log sources to Explore and the next planned integration is ElasticSearch logs. + +### Easily Switch Visualization with Panel Edit UX Update + +The UX for editing a panel has gotten an update and the major feature is being able to easily switch visualization using the new Visualization option. This means you can quickly switch from a Graph visualization to a Table visualization or any other visualization without having to create a new panel. + +### Google Stackdriver Datasource + +Built-in support for [Google Stackdriver](https://cloud.google.com/stackdriver/) is officially released in Grafana 6.0. Beta support was added in Grafana 5.3 and we have added lots of improvements since then. + +To get started read the guide: [Using Google Stackdriver in Grafana](/features/datasources/stackdriver/). + +### Azure Monitor Datasource + +One of the goals of the Grafana v6.0 release is to add support for the three major clouds. Amazon Cloudwatch has been a core datasource for years and Google Stackdriver is also now supported. We developed an external plugin for Azure Monitor last year and for this release the [plugin](https://grafana.com/plugins/grafana-azure-monitor-datasource) is being moved into Grafana to be one of the built-in datasources. For users of the external plugin, Grafana will automatically start using the built-in version. As a core datasource, the Azure Monitor datasource will get alerting support for the official 6.0 release. + +The Azure Monitor datasource integrates four Azure services with Grafana - Azure Monitor, Azure Log Analytics, Azure Application Insights and Azure Application Insights Analytics. + +#### Technical Work - moving from Angular to React + +The Grafana team is putting a huge amount of work into converting the frontend code in Grafana from Angular to React. Currently, all external plugins for Grafana are written in Angular but we are planning to also support plugins written in React very soon. + +## Changelog + +Checkout the [CHANGELOG.md](https://github.com/grafana/grafana/blob/master/CHANGELOG.md) file for a complete list of new features, changes, and bug fixes. From 368494bb16d7a3912eb698685b6b85446185c601 Mon Sep 17 00:00:00 2001 From: Daniel Lee Date: Wed, 30 Jan 2019 00:25:32 +0100 Subject: [PATCH 02/13] docs: update to what's new --- docs/sources/guides/whats-new-in-v6-0.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/docs/sources/guides/whats-new-in-v6-0.md b/docs/sources/guides/whats-new-in-v6-0.md index 70117148dc9..57bd9055032 100644 --- a/docs/sources/guides/whats-new-in-v6-0.md +++ b/docs/sources/guides/whats-new-in-v6-0.md @@ -66,6 +66,14 @@ One of the goals of the Grafana v6.0 release is to add support for the three maj The Azure Monitor datasource integrates four Azure services with Grafana - Azure Monitor, Azure Log Analytics, Azure Application Insights and Azure Application Insights Analytics. +### Other features + +- The ElasticSearch datasource now supports [bucket script pipeline aggregations](https://www.elastic.co/guide/en/elasticsearch/reference/current/search-aggregations-pipeline-bucket-script-aggregation.html). This gives the ability to do per bucket computations like the difference or ratio between two metrics. + +- The way session storage works has been refactored to be more secure and to be more performant by doing fewer writes to the database. + +- Support for Google Hangouts Chat alert notifications + #### Technical Work - moving from Angular to React The Grafana team is putting a huge amount of work into converting the frontend code in Grafana from Angular to React. Currently, all external plugins for Grafana are written in Angular but we are planning to also support plugins written in React very soon. From dfd87c3b9342f93a25bc5dcfb7beb469896bfafa Mon Sep 17 00:00:00 2001 From: bergquist Date: Wed, 30 Jan 2019 09:54:08 +0100 Subject: [PATCH 03/13] whats new: provisioning for alert notifiers --- docs/sources/guides/whats-new-in-v6-0.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/sources/guides/whats-new-in-v6-0.md b/docs/sources/guides/whats-new-in-v6-0.md index 57bd9055032..890de9aedf3 100644 --- a/docs/sources/guides/whats-new-in-v6-0.md +++ b/docs/sources/guides/whats-new-in-v6-0.md @@ -66,6 +66,10 @@ One of the goals of the Grafana v6.0 release is to add support for the three maj The Azure Monitor datasource integrates four Azure services with Grafana - Azure Monitor, Azure Log Analytics, Azure Application Insights and Azure Application Insights Analytics. +### Provisioning support for alert notifiers + +Grafana now added support for provisioning alert notifiers from configuration files. Allowing operators to provision notifiers without using the UI or the API. A new field called `uid` has been introduced which is a string identifier that the administrator can set themselves. Same kind of identifier used for dashboards since v5.0. This feature makes it possible to use the same notifier configuration in multiple environments and refer to notifiers in dashboard json by a string identifier instead of the numeric id which depends on insert order and how many notifiers that exists in the instance. + ### Other features - The ElasticSearch datasource now supports [bucket script pipeline aggregations](https://www.elastic.co/guide/en/elasticsearch/reference/current/search-aggregations-pipeline-bucket-script-aggregation.html). This gives the ability to do per bucket computations like the difference or ratio between two metrics. From 445b427fb6124d2424202a14725c69b1687afb58 Mon Sep 17 00:00:00 2001 From: bergquist Date: Wed, 30 Jan 2019 10:52:42 +0100 Subject: [PATCH 04/13] whats new: note about session storage --- docs/sources/guides/whats-new-in-v6-0.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/sources/guides/whats-new-in-v6-0.md b/docs/sources/guides/whats-new-in-v6-0.md index 890de9aedf3..bfd34033912 100644 --- a/docs/sources/guides/whats-new-in-v6-0.md +++ b/docs/sources/guides/whats-new-in-v6-0.md @@ -70,6 +70,12 @@ The Azure Monitor datasource integrates four Azure services with Grafana - Azure Grafana now added support for provisioning alert notifiers from configuration files. Allowing operators to provision notifiers without using the UI or the API. A new field called `uid` has been introduced which is a string identifier that the administrator can set themselves. Same kind of identifier used for dashboards since v5.0. This feature makes it possible to use the same notifier configuration in multiple environments and refer to notifiers in dashboard json by a string identifier instead of the numeric id which depends on insert order and how many notifiers that exists in the instance. +### Auth and session token improvements +The previous session storage implementation in Grafana was causing problems in larger HA setups due to too many write requests to the database. The remember me token also have several security issues which is why we decided to rewrite auth middleware in Grafana and remove the session storage since most operations using the session storage could be rewritten to use cookies or data already made available earlier in the request. +If you are using `Auth proxy` for authentication the session storage will still be used but our goal is to remove this ASAP as well. + +This release will force all users to log in again since their previous token is not valid anymore. + ### Other features - The ElasticSearch datasource now supports [bucket script pipeline aggregations](https://www.elastic.co/guide/en/elasticsearch/reference/current/search-aggregations-pipeline-bucket-script-aggregation.html). This gives the ability to do per bucket computations like the difference or ratio between two metrics. From 0b971d48c296628722a7d9c5a80676ba33a9cb78 Mon Sep 17 00:00:00 2001 From: Daniel Lee Date: Wed, 30 Jan 2019 11:09:45 +0100 Subject: [PATCH 05/13] docs: add video link to what's new --- docs/sources/guides/whats-new-in-v6-0.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/docs/sources/guides/whats-new-in-v6-0.md b/docs/sources/guides/whats-new-in-v6-0.md index bfd34033912..db9a76dedc5 100644 --- a/docs/sources/guides/whats-new-in-v6-0.md +++ b/docs/sources/guides/whats-new-in-v6-0.md @@ -54,6 +54,13 @@ In the near future, we will be adding support for other log sources to Explore a The UX for editing a panel has gotten an update and the major feature is being able to easily switch visualization using the new Visualization option. This means you can quickly switch from a Graph visualization to a Table visualization or any other visualization without having to create a new panel. +
+ +
+ ### Google Stackdriver Datasource Built-in support for [Google Stackdriver](https://cloud.google.com/stackdriver/) is officially released in Grafana 6.0. Beta support was added in Grafana 5.3 and we have added lots of improvements since then. From ce617bc02e6938d02824996ff2a6b16faf591bac Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Torkel=20=C3=96degaard?= Date: Wed, 30 Jan 2019 11:12:07 +0100 Subject: [PATCH 06/13] Minor updates to text and image placements --- docs/sources/guides/whats-new-in-v6-0.md | 23 +++++++++++++++-------- 1 file changed, 15 insertions(+), 8 deletions(-) diff --git a/docs/sources/guides/whats-new-in-v6-0.md b/docs/sources/guides/whats-new-in-v6-0.md index 890de9aedf3..5b6a8cfbf58 100644 --- a/docs/sources/guides/whats-new-in-v6-0.md +++ b/docs/sources/guides/whats-new-in-v6-0.md @@ -22,34 +22,41 @@ The main highlights are: - [Google Stackdriver Datasource]({{< relref "#google-stackdriver-datasource" >}}) is out of beta and is officially released. - The [Azure Monitor]({{< relref "#azure-monitor-datasource" >}}) plugin is ported from being an external plugin to being a core datasource -### Explore +## Explore -Grafana's dashboard UI is all about building dashboards for visualization. **Explore** strips away all the dashboard and panel options so that you can focus on the query. Iterate until you have a working query and then think about building a dashboard. +{{< docs-imagebox img="/img/docs/v60/explore_prometheus.png" max-width="800px" class="docs-image--right" caption="Screenshot of the new Explore option in the panel menu" >}} + +Grafana's dashboard UI is all about building dashboards for visualization. **Explore** strips away all the dashboard and panel options so that you can focus on the query & metric exploration. Iterate until you have a working query and then think about building a dashboard. You can also jump from a dashboard panel into **Explore** and from there do some ad-hoc query exporation with the panel queries as a starting point. For infrastructure monitoring and incident response, you no longer need to switch to other tools to debug what went wrong. **Explore** allows you to dig deeper into your metrics and logs to find the cause. Grafana's new logging datasource, [Loki](https://github.com/grafana/loki) is tightly integrated into Explore and allows you to correlate metrics and logs by viewing them side-by-side. -{{< docs-imagebox img="/img/docs/v60/explore_split.png" class="docs-image--no-shadow" caption="Screenshot of the new Explore option in the panel menu" >}} - **Explore** is a new paradigm for Grafana. It creates a new interactive debugging workflow that integrates two pillars of observability - metrics and logs. #### Explore and Prometheus The first version of Explore features a [custom querying experience for Prometheus](/features/explore/#prometheus-specific-features) and as well as an integration between Prometheus and Grafana Loki (see more about Loki below). +### Explore splits + +Explore supports splitting the view so you can compare different queries, different datasources and metrics & logs side by side! + +{{< docs-imagebox img="/img/docs/v60/explore_split.png" max-width="800px" caption="Screenshot of the new Explore option in the panel menu" >}} + ### Explore and Grafana Loki -The Explore feature allows you to combine metric queries and log queries. The first log integration is for the new open source log aggregation system from Grafana Labs called [Grafana Loki](https://github.com/grafana/loki). +The log exploration & visualization features in Explore are available to any data source but are currently only implemented by the new open source log +aggregation system from Grafana Lab called [Grafana Loki](https://github.com/grafana/loki). -Loki a horizontally-scalable, highly-available, multi-tenant log aggregation system inspired by Prometheus. It is designed to be very cost effective, as it does not index the contents of the logs, but rather a set of labels for each log stream. The logs from Loki are queried in a similar way to querying with label selectors in Prometheus. It uses labels to group log streams which can be made to match up with your Prometheus labels. +Loki is a horizontally-scalable, highly-available, multi-tenant log aggregation system inspired by Prometheus. It is designed to be very cost effective, as it does not index the contents of the logs, but rather a set of labels for each log stream. The logs from Loki are queried in a similar way to querying with label selectors in Prometheus. It uses labels to group log streams which can be made to match up with your Prometheus labels. Read more about Grafana Loki [here](https://github.com/grafana/loki) or [Grafana Labs hosted Loki](https://grafana.com/loki). The Explore feature allows you to query logs and features a new log panel. -{{< docs-imagebox img="/img/docs/v60/explore_loki.png" class="docs-image--no-shadow" caption="Explore Loki Log Streams" >}} - In the near future, we will be adding support for other log sources to Explore and the next planned integration is ElasticSearch logs. +{{< docs-imagebox img="/img/docs/v60/explore_loki.png" max-width="1200px" class="docs-image--left" caption="Explore Loki Log Streams" >}} + ### Easily Switch Visualization with Panel Edit UX Update The UX for editing a panel has gotten an update and the major feature is being able to easily switch visualization using the new Visualization option. This means you can quickly switch from a Graph visualization to a Table visualization or any other visualization without having to create a new panel. From 3bb5930c54bacae7f78f00eacd440130d3ba23be Mon Sep 17 00:00:00 2001 From: Daniel Lee Date: Wed, 30 Jan 2019 11:15:04 +0100 Subject: [PATCH 07/13] docs: whats new tweaks --- docs/sources/guides/whats-new-in-v6-0.md | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/docs/sources/guides/whats-new-in-v6-0.md b/docs/sources/guides/whats-new-in-v6-0.md index 7cc4a4e26a4..6c138aab31c 100644 --- a/docs/sources/guides/whats-new-in-v6-0.md +++ b/docs/sources/guides/whats-new-in-v6-0.md @@ -62,11 +62,11 @@ In the near future, we will be adding support for other log sources to Explore a The UX for editing a panel has gotten an update and the major feature is being able to easily switch visualization using the new Visualization option. This means you can quickly switch from a Graph visualization to a Table visualization or any other visualization without having to create a new panel.
-
+ ### Google Stackdriver Datasource @@ -85,6 +85,7 @@ The Azure Monitor datasource integrates four Azure services with Grafana - Azure Grafana now added support for provisioning alert notifiers from configuration files. Allowing operators to provision notifiers without using the UI or the API. A new field called `uid` has been introduced which is a string identifier that the administrator can set themselves. Same kind of identifier used for dashboards since v5.0. This feature makes it possible to use the same notifier configuration in multiple environments and refer to notifiers in dashboard json by a string identifier instead of the numeric id which depends on insert order and how many notifiers that exists in the instance. ### Auth and session token improvements + The previous session storage implementation in Grafana was causing problems in larger HA setups due to too many write requests to the database. The remember me token also have several security issues which is why we decided to rewrite auth middleware in Grafana and remove the session storage since most operations using the session storage could be rewritten to use cookies or data already made available earlier in the request. If you are using `Auth proxy` for authentication the session storage will still be used but our goal is to remove this ASAP as well. @@ -94,8 +95,6 @@ This release will force all users to log in again since their previous token is - The ElasticSearch datasource now supports [bucket script pipeline aggregations](https://www.elastic.co/guide/en/elasticsearch/reference/current/search-aggregations-pipeline-bucket-script-aggregation.html). This gives the ability to do per bucket computations like the difference or ratio between two metrics. -- The way session storage works has been refactored to be more secure and to be more performant by doing fewer writes to the database. - - Support for Google Hangouts Chat alert notifications #### Technical Work - moving from Angular to React From 909acb08efcce81b647f4e59581cff3747f2ca6c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Torkel=20=C3=96degaard?= Date: Wed, 30 Jan 2019 14:17:34 +0100 Subject: [PATCH 08/13] updated what's new article --- docs/sources/guides/whats-new-in-v6-0.md | 44 ++++++++++++++++++------ 1 file changed, 34 insertions(+), 10 deletions(-) diff --git a/docs/sources/guides/whats-new-in-v6-0.md b/docs/sources/guides/whats-new-in-v6-0.md index 7cc4a4e26a4..4fe5e14aa56 100644 --- a/docs/sources/guides/whats-new-in-v6-0.md +++ b/docs/sources/guides/whats-new-in-v6-0.md @@ -51,22 +51,46 @@ Loki is a horizontally-scalable, highly-available, multi-tenant log aggregation Read more about Grafana Loki [here](https://github.com/grafana/loki) or [Grafana Labs hosted Loki](https://grafana.com/loki). -The Explore feature allows you to query logs and features a new log panel. +The Explore feature allows you to query logs and features a new log panel. In the near future, we will be adding support +for other log sources to Explore and the next planned integration is Elasticsearch. -In the near future, we will be adding support for other log sources to Explore and the next planned integration is ElasticSearch logs. +{{< docs-imagebox img="/img/docs/v60/explore_loki.png" max-width="1200px" caption="Explore Loki Log Streams" >}} -{{< docs-imagebox img="/img/docs/v60/explore_loki.png" max-width="1200px" class="docs-image--left" caption="Explore Loki Log Streams" >}} +## New Panel Editor -### Easily Switch Visualization with Panel Edit UX Update - -The UX for editing a panel has gotten an update and the major feature is being able to easily switch visualization using the new Visualization option. This means you can quickly switch from a Graph visualization to a Table visualization or any other visualization without having to create a new panel. +Grafana v6.0 has a completely redesigned UX around editing panels. You can now resize the visualization area if you want +more space for queries & options and vice versa. You can now also change visualization (panel type) from within the new +panel edit mode. No need to add a new panel to try out different visualizations! Checkout the +video below to see the new Panel Editor in action.
-
+ + +
+ +### Gauge Panel + +We have created a new seperate Gauge panel as we felt having this visualization be a hidden option in the Singlestat panel +was not ideal. When it supports 100% of the Singlestat Gauge features we plan to add a migration so all +singlestats that use it become Gauge panels instead. This new panel contains a new **Threshold** editor that we will +continue to refine and start using in other panels. + +{{< docs-imagebox img="/img/docs/v60/gauge_panel.png" max-width="600px" caption="Gauge Panel" >}} + +
+ +### React Panels & Query Editors + +A major part of all the work that has gone into Grafana v6.0 has been on the migration to React. This investment +is part of the future proofing of Grafana and it's code base and ecosystem. Starting in v6.0 **Panels** and **Data +source** plugins can be written in React using our published `@grafana/ui` sdk library. More information on this +will be shared closer to or just after release. + +{{< docs-imagebox img="/img/docs/v60/react_panels.png" max-width="600px" caption="React Panel" >}} ### Google Stackdriver Datasource @@ -85,7 +109,7 @@ The Azure Monitor datasource integrates four Azure services with Grafana - Azure Grafana now added support for provisioning alert notifiers from configuration files. Allowing operators to provision notifiers without using the UI or the API. A new field called `uid` has been introduced which is a string identifier that the administrator can set themselves. Same kind of identifier used for dashboards since v5.0. This feature makes it possible to use the same notifier configuration in multiple environments and refer to notifiers in dashboard json by a string identifier instead of the numeric id which depends on insert order and how many notifiers that exists in the instance. ### Auth and session token improvements -The previous session storage implementation in Grafana was causing problems in larger HA setups due to too many write requests to the database. The remember me token also have several security issues which is why we decided to rewrite auth middleware in Grafana and remove the session storage since most operations using the session storage could be rewritten to use cookies or data already made available earlier in the request. +The previous session storage implementation in Grafana was causing problems in larger HA setups due to too many write requests to the database. The remember me token also have several security issues which is why we decided to rewrite auth middleware in Grafana and remove the session storage since most operations using the session storage could be rewritten to use cookies or data already made available earlier in the request. If you are using `Auth proxy` for authentication the session storage will still be used but our goal is to remove this ASAP as well. This release will force all users to log in again since their previous token is not valid anymore. From 2ca34376a0887442341759e0ea49e51a4d86466c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Torkel=20=C3=96degaard?= Date: Wed, 30 Jan 2019 14:33:49 +0100 Subject: [PATCH 09/13] fixe merge issue --- docs/sources/guides/whats-new-in-v6-0.md | 20 -------------------- 1 file changed, 20 deletions(-) diff --git a/docs/sources/guides/whats-new-in-v6-0.md b/docs/sources/guides/whats-new-in-v6-0.md index 7ab9698989b..77f6944b9af 100644 --- a/docs/sources/guides/whats-new-in-v6-0.md +++ b/docs/sources/guides/whats-new-in-v6-0.md @@ -64,19 +64,10 @@ panel edit mode. No need to add a new panel to try out different visualizations! video below to see the new Panel Editor in action.
-<<<<<<< HEAD

@@ -100,11 +91,6 @@ source** plugins can be written in React using our published `@grafana/ui` sdk l will be shared closer to or just after release. {{< docs-imagebox img="/img/docs/v60/react_panels.png" max-width="600px" caption="React Panel" >}} -||||||| merged common ancestors - -======= - ->>>>>>> 3bb5930c54bacae7f78f00eacd440130d3ba23be ### Google Stackdriver Datasource @@ -123,14 +109,8 @@ The Azure Monitor datasource integrates four Azure services with Grafana - Azure Grafana now added support for provisioning alert notifiers from configuration files. Allowing operators to provision notifiers without using the UI or the API. A new field called `uid` has been introduced which is a string identifier that the administrator can set themselves. Same kind of identifier used for dashboards since v5.0. This feature makes it possible to use the same notifier configuration in multiple environments and refer to notifiers in dashboard json by a string identifier instead of the numeric id which depends on insert order and how many notifiers that exists in the instance. ### Auth and session token improvements -<<<<<<< HEAD -The previous session storage implementation in Grafana was causing problems in larger HA setups due to too many write requests to the database. The remember me token also have several security issues which is why we decided to rewrite auth middleware in Grafana and remove the session storage since most operations using the session storage could be rewritten to use cookies or data already made available earlier in the request. -||||||| merged common ancestors -The previous session storage implementation in Grafana was causing problems in larger HA setups due to too many write requests to the database. The remember me token also have several security issues which is why we decided to rewrite auth middleware in Grafana and remove the session storage since most operations using the session storage could be rewritten to use cookies or data already made available earlier in the request. -======= The previous session storage implementation in Grafana was causing problems in larger HA setups due to too many write requests to the database. The remember me token also have several security issues which is why we decided to rewrite auth middleware in Grafana and remove the session storage since most operations using the session storage could be rewritten to use cookies or data already made available earlier in the request. ->>>>>>> 3bb5930c54bacae7f78f00eacd440130d3ba23be If you are using `Auth proxy` for authentication the session storage will still be used but our goal is to remove this ASAP as well. This release will force all users to log in again since their previous token is not valid anymore. From 5fa8c53d2e4904332cddd4a10c0fb46f2511e6d8 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Torkel=20=C3=96degaard?= Date: Wed, 30 Jan 2019 14:44:35 +0100 Subject: [PATCH 10/13] Updated explore section --- docs/sources/guides/whats-new-in-v6-0.md | 12 +++++++++--- 1 file changed, 9 insertions(+), 3 deletions(-) diff --git a/docs/sources/guides/whats-new-in-v6-0.md b/docs/sources/guides/whats-new-in-v6-0.md index 77f6944b9af..40b5d2dcb1b 100644 --- a/docs/sources/guides/whats-new-in-v6-0.md +++ b/docs/sources/guides/whats-new-in-v6-0.md @@ -30,11 +30,17 @@ Grafana's dashboard UI is all about building dashboards for visualization. **Exp For infrastructure monitoring and incident response, you no longer need to switch to other tools to debug what went wrong. **Explore** allows you to dig deeper into your metrics and logs to find the cause. Grafana's new logging datasource, [Loki](https://github.com/grafana/loki) is tightly integrated into Explore and allows you to correlate metrics and logs by viewing them side-by-side. -**Explore** is a new paradigm for Grafana. It creates a new interactive debugging workflow that integrates two pillars of observability - metrics and logs. +**Explore** is a new paradigm for Grafana. It creates a new interactive debugging workflow that integrates two pillars +of observability - metrics and logs. Explore works with every datasource but for Prometheus we have customized the +query editor and the experiance to provide the best possible exploration UX. #### Explore and Prometheus -The first version of Explore features a [custom querying experience for Prometheus](/features/explore/#prometheus-specific-features) and as well as an integration between Prometheus and Grafana Loki (see more about Loki below). +The first version of Explore features our new [query editor for +Prometheus](/features/explore/#prometheus-specific-features). This new editor has improved autocomplete, metric tree selector, +integrations with the Explore table view for easy label filtering and useful query hints that can automatically apply +functions to your query. There is also integration between Prometheus and Grafana Loki (see more about Loki below) that +enabled jumping between metrics query and logs query with preserved label filters. ### Explore splits @@ -110,7 +116,7 @@ Grafana now added support for provisioning alert notifiers from configuration fi ### Auth and session token improvements -The previous session storage implementation in Grafana was causing problems in larger HA setups due to too many write requests to the database. The remember me token also have several security issues which is why we decided to rewrite auth middleware in Grafana and remove the session storage since most operations using the session storage could be rewritten to use cookies or data already made available earlier in the request. +The previous session storage implementation in Grafana was causing problems in larger HA setups due to too many write requests to the database. The remember me token also have several security issues which is why we decided to rewrite auth middleware in Grafana and remove the session storage since most operations using the session storage could be rewritten to use cookies or data already made available earlier in the request. If you are using `Auth proxy` for authentication the session storage will still be used but our goal is to remove this ASAP as well. This release will force all users to log in again since their previous token is not valid anymore. From 8aed40164047ff65f5e5ceac695e66c2a4d3924b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Torkel=20=C3=96degaard?= Date: Wed, 30 Jan 2019 14:47:23 +0100 Subject: [PATCH 11/13] Updated explore section again --- docs/sources/guides/whats-new-in-v6-0.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/docs/sources/guides/whats-new-in-v6-0.md b/docs/sources/guides/whats-new-in-v6-0.md index 40b5d2dcb1b..4733a9b0e30 100644 --- a/docs/sources/guides/whats-new-in-v6-0.md +++ b/docs/sources/guides/whats-new-in-v6-0.md @@ -36,8 +36,7 @@ query editor and the experiance to provide the best possible exploration UX. #### Explore and Prometheus -The first version of Explore features our new [query editor for -Prometheus](/features/explore/#prometheus-specific-features). This new editor has improved autocomplete, metric tree selector, +Explore features a new [Prometheus query editor](/features/explore/#prometheus-specific-features). This new editor has improved autocomplete, metric tree selector, integrations with the Explore table view for easy label filtering and useful query hints that can automatically apply functions to your query. There is also integration between Prometheus and Grafana Loki (see more about Loki below) that enabled jumping between metrics query and logs query with preserved label filters. From 26096c65a54705f7ed43d961eca90c29d56b9071 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Torkel=20=C3=96degaard?= Date: Wed, 30 Jan 2019 16:15:56 +0100 Subject: [PATCH 12/13] spell fixes --- docs/sources/guides/whats-new-in-v6-0.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/sources/guides/whats-new-in-v6-0.md b/docs/sources/guides/whats-new-in-v6-0.md index 4733a9b0e30..d31ce48794e 100644 --- a/docs/sources/guides/whats-new-in-v6-0.md +++ b/docs/sources/guides/whats-new-in-v6-0.md @@ -32,7 +32,7 @@ For infrastructure monitoring and incident response, you no longer need to switc **Explore** is a new paradigm for Grafana. It creates a new interactive debugging workflow that integrates two pillars of observability - metrics and logs. Explore works with every datasource but for Prometheus we have customized the -query editor and the experiance to provide the best possible exploration UX. +query editor and the experience to provide the best possible exploration UX. #### Explore and Prometheus @@ -79,7 +79,7 @@ video below to see the new Panel Editor in action. ### Gauge Panel -We have created a new seperate Gauge panel as we felt having this visualization be a hidden option in the Singlestat panel +We have created a new separate Gauge panel as we felt having this visualization be a hidden option in the Singlestat panel was not ideal. When it supports 100% of the Singlestat Gauge features we plan to add a migration so all singlestats that use it become Gauge panels instead. This new panel contains a new **Threshold** editor that we will continue to refine and start using in other panels. From 70c35d646f716aae93692f71e04bc5f24123a6b7 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Torkel=20=C3=96degaard?= Date: Wed, 30 Jan 2019 16:51:59 +0100 Subject: [PATCH 13/13] Added loki video --- docs/sources/guides/whats-new-in-v6-0.md | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/docs/sources/guides/whats-new-in-v6-0.md b/docs/sources/guides/whats-new-in-v6-0.md index d31ce48794e..a2969b32197 100644 --- a/docs/sources/guides/whats-new-in-v6-0.md +++ b/docs/sources/guides/whats-new-in-v6-0.md @@ -59,7 +59,12 @@ Read more about Grafana Loki [here](https://github.com/grafana/loki) or [Grafana The Explore feature allows you to query logs and features a new log panel. In the near future, we will be adding support for other log sources to Explore and the next planned integration is Elasticsearch. -{{< docs-imagebox img="/img/docs/v60/explore_loki.png" max-width="1200px" caption="Explore Loki Log Streams" >}} +
+ +
## New Panel Editor