From ac5d5859026cd4de6795d35053c63d1f98017e50 Mon Sep 17 00:00:00 2001 From: Leonard Gram Date: Mon, 24 Sep 2018 16:31:59 +0200 Subject: [PATCH 01/11] docs: whats new for 5.3 --- docs/sources/guides/whats-new-in-v5-3.md | 32 ++++++++++++++++++++++++ 1 file changed, 32 insertions(+) diff --git a/docs/sources/guides/whats-new-in-v5-3.md b/docs/sources/guides/whats-new-in-v5-3.md index 4a2674c9b39..ed5238d1b94 100644 --- a/docs/sources/guides/whats-new-in-v5-3.md +++ b/docs/sources/guides/whats-new-in-v5-3.md @@ -12,6 +12,38 @@ weight = -9 # What's New in Grafana v5.3 +Grafana v5.3 brings new features, many enhancements and bug fixes. This article will detail the major new features and enhancements. + +- [TV mode]({{< relref "#tv-and-kiosk-mode" >}}) is improved +- [Alerting]({{< relref "#notification-reminders" >}}) with notification reminders +- [Postgres query builder]({{< relref "#postgres-query-builder" >}}) it's finally here! +- [OAuth]({{< relref "#improved-oauth-support-for-gitlab" >}}) support for Gitlab is improved + +## TV and kiosk mode + +We've improved the TV & kiosk mode to make it easier to use. There's now an icon in the top bar that will let you cycle through the different display modes. + +Clicks: + +1. (TV mode) Removes the sidebar and most of the buttons in the top bar +2. (Kiosk mode) Removes the top bar completely so that only the dashboard itself is showing + +Hit the escape key to go back to the default mode. + +**gif here** + +## Notification reminders + +Do you use Grafana alerting and have some notifications that are more important than others? Then it's possible to set reminders so that you get alerted until the problem is fixed. This is done on the notification channel itself and will affect all alerts that use that channel. Read more about reminders [here](http://docs.grafana.org/alerting/notifications/#send-reminders) + +## Postgres query builder + +Grafana 5.3 comes with a new graphical query builder for Postgres. Bringing Postgres integration more in line with some the other datasources and making it easier for both advanced and beginners to work with timeseries in Postgres. + +## Improved OAuth support for Gitlab + +Grafana 5.3 now supports filtering to specific groups when using Gitlab OAuth. This is makes it possible to use Gitlab OAuth with Grafana in a shared environment without giving access to Grafana to everyone. + ## Changelog Checkout the [CHANGELOG.md](https://github.com/grafana/grafana/blob/master/CHANGELOG.md) file for a complete list From 06d24df7b49ecaec30a1c07c21ed8d54f3a76bb9 Mon Sep 17 00:00:00 2001 From: Leonard Gram Date: Mon, 24 Sep 2018 16:58:39 +0200 Subject: [PATCH 02/11] docs: postgres gif. --- docs/sources/guides/whats-new-in-v5-3.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/sources/guides/whats-new-in-v5-3.md b/docs/sources/guides/whats-new-in-v5-3.md index ed5238d1b94..d8e60517ecb 100644 --- a/docs/sources/guides/whats-new-in-v5-3.md +++ b/docs/sources/guides/whats-new-in-v5-3.md @@ -40,6 +40,8 @@ Do you use Grafana alerting and have some notifications that are more important Grafana 5.3 comes with a new graphical query builder for Postgres. Bringing Postgres integration more in line with some the other datasources and making it easier for both advanced and beginners to work with timeseries in Postgres. +{{< docs-imagebox img="/img/docs/v53/postgres_query_still.png" class="docs-image--no-shadow" animated-gif="/img/docs/v53/postgres_query.gif" >}} + ## Improved OAuth support for Gitlab Grafana 5.3 now supports filtering to specific groups when using Gitlab OAuth. This is makes it possible to use Gitlab OAuth with Grafana in a shared environment without giving access to Grafana to everyone. From 00843037d4aeb2120009a6eb761768f8cd21d73d Mon Sep 17 00:00:00 2001 From: Leonard Gram Date: Wed, 3 Oct 2018 13:56:43 +0200 Subject: [PATCH 03/11] docs: better wording and docs links. --- docs/sources/guides/whats-new-in-v5-3.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/sources/guides/whats-new-in-v5-3.md b/docs/sources/guides/whats-new-in-v5-3.md index d8e60517ecb..5c5ff366fda 100644 --- a/docs/sources/guides/whats-new-in-v5-3.md +++ b/docs/sources/guides/whats-new-in-v5-3.md @@ -16,7 +16,7 @@ Grafana v5.3 brings new features, many enhancements and bug fixes. This article - [TV mode]({{< relref "#tv-and-kiosk-mode" >}}) is improved - [Alerting]({{< relref "#notification-reminders" >}}) with notification reminders -- [Postgres query builder]({{< relref "#postgres-query-builder" >}}) it's finally here! +- [Postgres]({{< relref "#postgres-query-builder" >}}) gets a new query builder! - [OAuth]({{< relref "#improved-oauth-support-for-gitlab" >}}) support for Gitlab is improved ## TV and kiosk mode @@ -38,13 +38,13 @@ Do you use Grafana alerting and have some notifications that are more important ## Postgres query builder -Grafana 5.3 comes with a new graphical query builder for Postgres. Bringing Postgres integration more in line with some the other datasources and making it easier for both advanced and beginners to work with timeseries in Postgres. +Grafana 5.3 comes with a new graphical query builder for Postgres. Bringing Postgres integration more in line with some of the other datasources and making it easier for both advanced and beginners to work with timeseries in Postgres. Learn more about it in the [documentation](http://docs.grafana.org/features/datasources/postgres/#query-editor). {{< docs-imagebox img="/img/docs/v53/postgres_query_still.png" class="docs-image--no-shadow" animated-gif="/img/docs/v53/postgres_query.gif" >}} ## Improved OAuth support for Gitlab -Grafana 5.3 now supports filtering to specific groups when using Gitlab OAuth. This is makes it possible to use Gitlab OAuth with Grafana in a shared environment without giving access to Grafana to everyone. +Grafana 5.3 gets native support for Gitlab OAuth with filtering to specific groups. This is makes it possible to use Gitlab OAuth with Grafana in a shared environment without giving everyone access to Grafana. More on usage in the [documentation](http://docs.grafana.org/auth/gitlab/). ## Changelog From d2dc770c793f07b12c50e3a58878155d0466fcf4 Mon Sep 17 00:00:00 2001 From: Marcus Efraimsson Date: Wed, 3 Oct 2018 17:10:41 +0200 Subject: [PATCH 04/11] various fixes and improvements --- docs/sources/guides/whats-new-in-v5-3.md | 36 +++++++++++++++++------- 1 file changed, 26 insertions(+), 10 deletions(-) diff --git a/docs/sources/guides/whats-new-in-v5-3.md b/docs/sources/guides/whats-new-in-v5-3.md index 5c5ff366fda..e52ad4aa7c3 100644 --- a/docs/sources/guides/whats-new-in-v5-3.md +++ b/docs/sources/guides/whats-new-in-v5-3.md @@ -14,37 +14,53 @@ weight = -9 Grafana v5.3 brings new features, many enhancements and bug fixes. This article will detail the major new features and enhancements. -- [TV mode]({{< relref "#tv-and-kiosk-mode" >}}) is improved +- [Google Stackdriver]({{< relref "#google-stackdriver" >}}) as a core datasource! +- [TV mode]({{< relref "#tv-and-kiosk-mode" >}}) is improved and more accessible - [Alerting]({{< relref "#notification-reminders" >}}) with notification reminders - [Postgres]({{< relref "#postgres-query-builder" >}}) gets a new query builder! - [OAuth]({{< relref "#improved-oauth-support-for-gitlab" >}}) support for Gitlab is improved +## Google Stackdriver + +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. + +The datasource is still in a `beta` phase meaning it's currently in active development and could be missing important features. +Please try it out, but be aware of that it might be subject to changes and possible bugs. We would love to hear your feedback. + +Please read [Using Google Stackdriver in Grafana](/features/datasources/stackdriver/) for more detailed information on how to get started and use it. + ## TV and kiosk mode -We've improved the TV & kiosk mode to make it easier to use. There's now an icon in the top bar that will let you cycle through the different display modes. +{{< docs-imagebox img="/img/docs/v53/tv_mode_still.png" max-width="600px" class="docs-image--no-shadow docs-image--right" animated-gif="/img/docs/v53/tv_mode.gif" >}} -Clicks: +We've improved the TV & kiosk mode to make it easier to use. There's now an icon in the top bar that will let you cycle through the different view modes. -1. (TV mode) Removes the sidebar and most of the buttons in the top bar -2. (Kiosk mode) Removes the top bar completely so that only the dashboard itself is showing +1. In the first view mode the sidebar and most of the buttons in the top bar will be hidden +2. In the second view mode the top bar is completely hidden so that only the dashboard itself is showing +3. Hit the escape key to go back to the default view mode -Hit the escape key to go back to the default mode. +When switching view modes the url will be updated to reflect the view mode selected. This allows a dashboard to be opened with a +certain view mode enabled. Additionally, this also enables [playlists](/reference/playlist) to be started with a certain view mode enabled. -**gif here** +
## Notification reminders -Do you use Grafana alerting and have some notifications that are more important than others? Then it's possible to set reminders so that you get alerted until the problem is fixed. This is done on the notification channel itself and will affect all alerts that use that channel. Read more about reminders [here](http://docs.grafana.org/alerting/notifications/#send-reminders) +Do you use Grafana alerting and have some notifications that are more important than others? Then it's possible to set reminders so that you get alerted until the problem is fixed. This is done on the notification channel itself and will affect all alerts that use that channel. +For additional examples of why reminders might be useful for you, see [multiple series](/alerting/rules/#multiple-series). + +Learn how to enable and configure reminders [here](/alerting/notifications/#send-reminders). ## Postgres query builder -Grafana 5.3 comes with a new graphical query builder for Postgres. Bringing Postgres integration more in line with some of the other datasources and making it easier for both advanced and beginners to work with timeseries in Postgres. Learn more about it in the [documentation](http://docs.grafana.org/features/datasources/postgres/#query-editor). +Grafana 5.3 comes with a new graphical query builder for Postgres. Bringing Postgres integration more in line with some of the other datasources and making it easier for both advanced and beginners to work with timeseries in Postgres. Learn more about it in the [documentation](/features/datasources/postgres/#query-editor). {{< docs-imagebox img="/img/docs/v53/postgres_query_still.png" class="docs-image--no-shadow" animated-gif="/img/docs/v53/postgres_query.gif" >}} ## Improved OAuth support for Gitlab -Grafana 5.3 gets native support for Gitlab OAuth with filtering to specific groups. This is makes it possible to use Gitlab OAuth with Grafana in a shared environment without giving everyone access to Grafana. More on usage in the [documentation](http://docs.grafana.org/auth/gitlab/). +Grafana 5.3 comes with a new OAuth integration for Gitlab that enables configuration to only allow users that are member of certain Gitlab groups to authenticate. This makes it possible to use Gitlab OAuth with Grafana in a shared environment without giving everyone access to Grafana. +Learn how to enable and configure it in the [documentation](/auth/gitlab/). ## Changelog From a44e8c5917ddbe9c8cb0db6775f624c77baba3e9 Mon Sep 17 00:00:00 2001 From: Daniel Lee Date: Thu, 4 Oct 2018 17:46:16 +0200 Subject: [PATCH 05/11] docs: whats new in 5.3 - a few tweaks --- docs/sources/guides/whats-new-in-v5-3.md | 24 ++++++++++++------------ 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/docs/sources/guides/whats-new-in-v5-3.md b/docs/sources/guides/whats-new-in-v5-3.md index e52ad4aa7c3..faf6c410291 100644 --- a/docs/sources/guides/whats-new-in-v5-3.md +++ b/docs/sources/guides/whats-new-in-v5-3.md @@ -24,42 +24,42 @@ Grafana v5.3 brings new features, many enhancements and bug fixes. This article 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. -The datasource is still in a `beta` phase meaning it's currently in active development and could be missing important features. +The datasource is still in the `beta` phase, meaning it's currently in active development and is still missing a few important features (templating queries, support for metrics with distribution type). Please try it out, but be aware of that it might be subject to changes and possible bugs. We would love to hear your feedback. Please read [Using Google Stackdriver in Grafana](/features/datasources/stackdriver/) for more detailed information on how to get started and use it. -## TV and kiosk mode +## TV and Kiosk Mode {{< docs-imagebox img="/img/docs/v53/tv_mode_still.png" max-width="600px" class="docs-image--no-shadow docs-image--right" animated-gif="/img/docs/v53/tv_mode.gif" >}} We've improved the TV & kiosk mode to make it easier to use. There's now an icon in the top bar that will let you cycle through the different view modes. -1. In the first view mode the sidebar and most of the buttons in the top bar will be hidden -2. In the second view mode the top bar is completely hidden so that only the dashboard itself is showing -3. Hit the escape key to go back to the default view mode +1. In the first view mode, the sidebar and most of the buttons in the top bar will be hidden. +2. In the second view mode, the top bar is completely hidden so that only the dashboard itself is shown. +3. Hit the escape key to go back to the default view mode. -When switching view modes the url will be updated to reflect the view mode selected. This allows a dashboard to be opened with a +When switching view modes, the url will be updated to reflect the view mode selected. This allows a dashboard to be opened with a certain view mode enabled. Additionally, this also enables [playlists](/reference/playlist) to be started with a certain view mode enabled.
-## Notification reminders +## Notification Reminders -Do you use Grafana alerting and have some notifications that are more important than others? Then it's possible to set reminders so that you get alerted until the problem is fixed. This is done on the notification channel itself and will affect all alerts that use that channel. +Do you use Grafana alerting and have some notifications that are more important than others? Then it's possible to set reminders so that you continue to be alerted until the problem is fixed. This is done on the notification channel itself and will affect all alerts that use that channel. For additional examples of why reminders might be useful for you, see [multiple series](/alerting/rules/#multiple-series). Learn how to enable and configure reminders [here](/alerting/notifications/#send-reminders). -## Postgres query builder +## Postgres Query Builder -Grafana 5.3 comes with a new graphical query builder for Postgres. Bringing Postgres integration more in line with some of the other datasources and making it easier for both advanced and beginners to work with timeseries in Postgres. Learn more about it in the [documentation](/features/datasources/postgres/#query-editor). +Grafana 5.3 comes with a new graphical query builder for Postgres. This brings Postgres integration more in line with some of the other datasources and makes it easier for both advanced users and beginners to work with timeseries in Postgres. Learn more about it in the [documentation](/features/datasources/postgres/#query-editor). {{< docs-imagebox img="/img/docs/v53/postgres_query_still.png" class="docs-image--no-shadow" animated-gif="/img/docs/v53/postgres_query.gif" >}} -## Improved OAuth support for Gitlab +## Improved OAuth Support for Gitlab -Grafana 5.3 comes with a new OAuth integration for Gitlab that enables configuration to only allow users that are member of certain Gitlab groups to authenticate. This makes it possible to use Gitlab OAuth with Grafana in a shared environment without giving everyone access to Grafana. +Grafana 5.3 comes with a new OAuth integration for Gitlab that enables configuration to only allow users that are a member of certain Gitlab groups to authenticate. This makes it possible to use Gitlab OAuth with Grafana in a shared environment without giving everyone access to Grafana. Learn how to enable and configure it in the [documentation](/auth/gitlab/). ## Changelog From b03a25198b7bb06f3720cd122f653bd9847c8947 Mon Sep 17 00:00:00 2001 From: Marcus Efraimsson Date: Thu, 4 Oct 2018 18:25:16 +0200 Subject: [PATCH 06/11] docs: annotations tag filter with template variable support --- docs/sources/guides/whats-new-in-v5-3.md | 8 ++++++++ docs/sources/reference/annotations.md | 4 +++- 2 files changed, 11 insertions(+), 1 deletion(-) diff --git a/docs/sources/guides/whats-new-in-v5-3.md b/docs/sources/guides/whats-new-in-v5-3.md index faf6c410291..6d82a98be56 100644 --- a/docs/sources/guides/whats-new-in-v5-3.md +++ b/docs/sources/guides/whats-new-in-v5-3.md @@ -19,6 +19,7 @@ Grafana v5.3 brings new features, many enhancements and bug fixes. This article - [Alerting]({{< relref "#notification-reminders" >}}) with notification reminders - [Postgres]({{< relref "#postgres-query-builder" >}}) gets a new query builder! - [OAuth]({{< relref "#improved-oauth-support-for-gitlab" >}}) support for Gitlab is improved +- [Annotations]({{< relref "#annotations" >}}) with template variable filtering ## Google Stackdriver @@ -62,6 +63,13 @@ Grafana 5.3 comes with a new graphical query builder for Postgres. This brings P Grafana 5.3 comes with a new OAuth integration for Gitlab that enables configuration to only allow users that are a member of certain Gitlab groups to authenticate. This makes it possible to use Gitlab OAuth with Grafana in a shared environment without giving everyone access to Grafana. Learn how to enable and configure it in the [documentation](/auth/gitlab/). +## Annotations + it possible to use template vari +Grafana 5.3 brings improved support for [native annotations](/reference/annotations/#native-annotations) and makes it possible to use template variables when filtering by tags. +Learn more about it in the [documentation](/reference/annotations/#query-by-tag). + +{{< docs-imagebox img="/img/docs/v53/annotation_tag_filter_variable.png" max-width="600px" >}} + ## Changelog Checkout the [CHANGELOG.md](https://github.com/grafana/grafana/blob/master/CHANGELOG.md) file for a complete list diff --git a/docs/sources/reference/annotations.md b/docs/sources/reference/annotations.md index 3bb50f4badf..8732c8c709b 100644 --- a/docs/sources/reference/annotations.md +++ b/docs/sources/reference/annotations.md @@ -47,7 +47,9 @@ can still show them if you add a new **Annotation Query** and filter by tags. Bu You can create new annotation queries that fetch annotations from the native annotation store via the `-- Grafana --` data source and by setting *Filter by* to `Tags`. Specify at least one tag. For example create an annotation query name `outages` and specify a tag named `outage`. This query will show all annotations you create (from any dashboard or via API) that have the `outage` tag. By default, if you add multiple tags in the annotation query, Grafana will only show annotations that have all the tags you supplied. You can invert the behavior by enabling `Match any` which means that Grafana will show annotations that contains at least one of the tags you supplied. -In 5.4+ it's possible to use template variables in the tag query. So if you have a dashboard showing stats for different services and an template variable that dictates which services to show, you can now use the same template variable in your annotation query to only show annotations for those services. +In Grafana v5.3+ it's possible to use template variables in the tag query. So if you have a dashboard showing stats for different services and a template variable that dictates which services to show, you can now use the same template variable in your annotation query to only show annotations for those services. + +{{< docs-imagebox img="/img/docs/v53/annotation_tag_filter_variable.png" max-width="600px" >}} ## Querying other data sources From c670897c6ade6295ee06521d0df4b0f8c33923fb Mon Sep 17 00:00:00 2001 From: Marcus Efraimsson Date: Thu, 4 Oct 2018 18:45:47 +0200 Subject: [PATCH 07/11] docs: new variable type text box that allows free text input --- docs/sources/guides/whats-new-in-v5-3.md | 8 +++++++- docs/sources/reference/templating.md | 1 + 2 files changed, 8 insertions(+), 1 deletion(-) diff --git a/docs/sources/guides/whats-new-in-v5-3.md b/docs/sources/guides/whats-new-in-v5-3.md index 6d82a98be56..d99612c71e3 100644 --- a/docs/sources/guides/whats-new-in-v5-3.md +++ b/docs/sources/guides/whats-new-in-v5-3.md @@ -20,6 +20,7 @@ Grafana v5.3 brings new features, many enhancements and bug fixes. This article - [Postgres]({{< relref "#postgres-query-builder" >}}) gets a new query builder! - [OAuth]({{< relref "#improved-oauth-support-for-gitlab" >}}) support for Gitlab is improved - [Annotations]({{< relref "#annotations" >}}) with template variable filtering +- [Variables]({{< relref "#variables" >}}) with free text support ## Google Stackdriver @@ -64,12 +65,17 @@ Grafana 5.3 comes with a new OAuth integration for Gitlab that enables configura Learn how to enable and configure it in the [documentation](/auth/gitlab/). ## Annotations - it possible to use template vari + Grafana 5.3 brings improved support for [native annotations](/reference/annotations/#native-annotations) and makes it possible to use template variables when filtering by tags. Learn more about it in the [documentation](/reference/annotations/#query-by-tag). {{< docs-imagebox img="/img/docs/v53/annotation_tag_filter_variable.png" max-width="600px" >}} +## Variables + +Grafana 5.3 ships with a brand new variable type named `Text box` which makes it easier and more convenient to provide free text input to a variable. +This new variable type will display as a free text input field with an optional prefilled default value. + ## Changelog Checkout the [CHANGELOG.md](https://github.com/grafana/grafana/blob/master/CHANGELOG.md) file for a complete list diff --git a/docs/sources/reference/templating.md b/docs/sources/reference/templating.md index 31251fd6389..403dabba8ae 100644 --- a/docs/sources/reference/templating.md +++ b/docs/sources/reference/templating.md @@ -90,6 +90,7 @@ Type | Description *Custom* | Define the variable options manually using a comma separated list. *Constant* | Define a hidden constant. Useful for metric path prefixes for dashboards you want to share. During dashboard export, constant variables will be made into an import option. *Ad hoc filters* | Very special kind of variable that only works with some data sources, InfluxDB & Elasticsearch currently. It allows you to add key/value filters that will automatically be added to all metric queries that use the specified data source. +*Text box* | This variable type will display as a free text input field with an optional default value. ### Query options From 939be514965e2d683c1862e67311689da687677b Mon Sep 17 00:00:00 2001 From: Erik Sundell Date: Wed, 10 Oct 2018 09:57:43 +0200 Subject: [PATCH 08/11] Provide more information about what's included in the Stackdriver plugin --- docs/sources/guides/whats-new-in-v5-3.md | 12 ++++++++++-- 1 file changed, 10 insertions(+), 2 deletions(-) diff --git a/docs/sources/guides/whats-new-in-v5-3.md b/docs/sources/guides/whats-new-in-v5-3.md index d99612c71e3..69126e108fa 100644 --- a/docs/sources/guides/whats-new-in-v5-3.md +++ b/docs/sources/guides/whats-new-in-v5-3.md @@ -24,9 +24,17 @@ Grafana v5.3 brings new features, many enhancements and bug fixes. This article ## Google Stackdriver -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. -The datasource is still in the `beta` phase, meaning it's currently in active development and is still missing a few important features (templating queries, support for metrics with distribution type). +Getting started with the plugin is easy. Simply create a GCE Service account that has access to the Stackdriver api scope, download the JWT file from Google and upload it in 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. + +If you're already accustomed to the Stackdriver Metrics Explorer UI, you'll notice that there are a lot of similarities in the query editor in Grafana. It is possible to add filters using wildcards and regular expressions. You can do Group By, Primary Aggregation and Alignment. + +Alias By allows you to format the legend the way you want, and it's a feature that is not yet present in the Metrics Explorer. Two other features that are only supported in the Grafana plugin is the possibility to manually set the Alignment Period in the query editor and to add Annotations queries. + +The Grafana Stackdriver plugin comes with support for automatic unit detection. I.e Grafana will try to map the Stackdriver unit type to a corresponding unit type in Grafana, and if successfull the panel Y-axes will be updated accordingly to display the correct unit of measure. This is the first core plugin to provide support for unit detection, and it is our intetion to provide support for this in other core plugins in the near future. + +The datasource is still in the `beta` phase, meaning it's currently in active development and is still missing one important feature - templating queries. Please try it out, but be aware of that it might be subject to changes and possible bugs. We would love to hear your feedback. Please read [Using Google Stackdriver in Grafana](/features/datasources/stackdriver/) for more detailed information on how to get started and use it. From 840a6e45daecbd00fc9ea4142e1e3cd899176c39 Mon Sep 17 00:00:00 2001 From: Erik Sundell Date: Wed, 10 Oct 2018 10:02:13 +0200 Subject: [PATCH 09/11] Fix typo --- docs/sources/guides/whats-new-in-v5-3.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sources/guides/whats-new-in-v5-3.md b/docs/sources/guides/whats-new-in-v5-3.md index 69126e108fa..c9c7411c94a 100644 --- a/docs/sources/guides/whats-new-in-v5-3.md +++ b/docs/sources/guides/whats-new-in-v5-3.md @@ -32,7 +32,7 @@ If you're already accustomed to the Stackdriver Metrics Explorer UI, you'll noti Alias By allows you to format the legend the way you want, and it's a feature that is not yet present in the Metrics Explorer. Two other features that are only supported in the Grafana plugin is the possibility to manually set the Alignment Period in the query editor and to add Annotations queries. -The Grafana Stackdriver plugin comes with support for automatic unit detection. I.e Grafana will try to map the Stackdriver unit type to a corresponding unit type in Grafana, and if successfull the panel Y-axes will be updated accordingly to display the correct unit of measure. This is the first core plugin to provide support for unit detection, and it is our intetion to provide support for this in other core plugins in the near future. +The Grafana Stackdriver plugin comes with support for automatic unit detection. I.e Grafana will try to map the Stackdriver unit type to a corresponding unit type in Grafana, and if successful the panel Y-axes will be updated accordingly to display the correct unit of measure. This is the first core plugin to provide support for unit detection, and it is our intetion to provide support for this in other core plugins in the near future. The datasource is still in the `beta` phase, meaning it's currently in active development and is still missing one important feature - templating queries. Please try it out, but be aware of that it might be subject to changes and possible bugs. We would love to hear your feedback. From ae44a6b6e9643f87a782eeb94cacc8b473ae7236 Mon Sep 17 00:00:00 2001 From: Erik Sundell Date: Wed, 10 Oct 2018 10:39:10 +0200 Subject: [PATCH 10/11] Use correct naming convention --- docs/sources/guides/whats-new-in-v5-3.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sources/guides/whats-new-in-v5-3.md b/docs/sources/guides/whats-new-in-v5-3.md index c9c7411c94a..b069b2cfabc 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 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 JWT file from Google and upload it in 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. +Getting started with the plugin is easy. Simply create a GCE Service account that has access to the Stackdriver api scope, download the JWT file from Google and upload it in 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. If you're already accustomed to the Stackdriver Metrics Explorer UI, you'll notice that there are a lot of similarities in the query editor in Grafana. It is possible to add filters using wildcards and regular expressions. You can do Group By, Primary Aggregation and Alignment. From 0a64f0bdc7b4e1be5395b4b2838fbfca37df62f6 Mon Sep 17 00:00:00 2001 From: Daniel Lee Date: Wed, 10 Oct 2018 13:46:10 +0200 Subject: [PATCH 11/11] whatsnew: adds image for Stackdriver Plus a few tweaks to the text --- docs/sources/guides/whats-new-in-v5-3.md | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/docs/sources/guides/whats-new-in-v5-3.md b/docs/sources/guides/whats-new-in-v5-3.md index b069b2cfabc..5dcadc0813d 100644 --- a/docs/sources/guides/whats-new-in-v5-3.md +++ b/docs/sources/guides/whats-new-in-v5-3.md @@ -24,15 +24,17 @@ Grafana v5.3 brings new features, many enhancements and bug fixes. This article ## Google Stackdriver +{{< 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. -Getting started with the plugin is easy. Simply create a GCE Service account that has access to the Stackdriver api scope, download the JWT file from Google and upload it in 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. +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. -If you're already accustomed to the Stackdriver Metrics Explorer UI, you'll notice that there are a lot of similarities in the query editor in Grafana. It is possible to add filters using wildcards and regular expressions. You can do Group By, Primary Aggregation and Alignment. +If you're already accustomed to the Stackdriver Metrics Explorer UI, you'll notice that there are a lot of similarities to the query editor in Grafana. It is possible to add filters using wildcards and regular expressions. You can do Group By, Primary Aggregation and Alignment. -Alias By allows you to format the legend the way you want, and it's a feature that is not yet present in the Metrics Explorer. Two other features that are only supported in the Grafana plugin is the possibility to manually set the Alignment Period in the query editor and to add Annotations queries. +Alias By allows you to format the legend the way you want, and it's a feature that is not yet present in the Metrics Explorer. Two other features that are only supported in the Grafana plugin are the abilities to manually set the Alignment Period in the query editor and to add Annotations queries. -The Grafana Stackdriver plugin comes with support for automatic unit detection. I.e Grafana will try to map the Stackdriver unit type to a corresponding unit type in Grafana, and if successful the panel Y-axes will be updated accordingly to display the correct unit of measure. This is the first core plugin to provide support for unit detection, and it is our intetion to provide support for this in other core plugins in the near future. +The Grafana Stackdriver plugin comes with support for automatic unit detection. Grafana will try to map the Stackdriver unit type to a corresponding unit type in Grafana, and if successful the panel Y-axes will be updated accordingly to display the correct unit of measure. This is the first core plugin to provide support for unit detection, and it is our intention to provide support for this in other core plugins in the near future. The datasource is still in the `beta` phase, meaning it's currently in active development and is still missing one important feature - templating queries. Please try it out, but be aware of that it might be subject to changes and possible bugs. We would love to hear your feedback.