mirror of
https://github.com/grafana/grafana.git
synced 2024-11-28 19:54:10 -06:00
docs: what's new in v5.1 draft
This commit is contained in:
Marcus Efraimsson
parent
ba9c3f60c4
commit
250f85b9bd
126
docs/sources/guides/whats-new-in-v5-1.md
Normal file
126
docs/sources/guides/whats-new-in-v5-1.md
Normal file
@ -0,0 +1,126 @@
|
||||
+++
|
||||
title = "What's New in Grafana v5.1"
|
||||
description = "Feature & improvement highlights for Grafana v5.1"
|
||||
keywords = ["grafana", "new", "documentation", "5.1"]
|
||||
type = "docs"
|
||||
[menu.docs]
|
||||
name = "Version 5.1"
|
||||
identifier = "v5.1"
|
||||
parent = "whatsnew"
|
||||
weight = -7
|
||||
+++
|
||||
|
||||
# What's New in Grafana v5.1
|
||||
|
||||
Grafana v5.1 brings new features, many enhancements and bug fixes. This article will detail the major new features and enhancements.
|
||||
|
||||
* [Scrolling]({{< relref "#scrolling" >}})
|
||||
* [Improved docker image]({{< relref "#improved-docker-image-breaking-change" >}}) with a breaking change!
|
||||
* [Improved workflow for provisioned dashboards]({{< relref "#improved-workflow-for-provisioned-dashboards" >}})
|
||||
* [New template variable interpolation syntax]({{< relref "#new-template-variable-interpolation-syntax" >}})
|
||||
* [Alerting]({{< relref "#alerting" >}})
|
||||
* [Datasources]({{< relref "#datasources" >}}) Enhancements to Prometheus, Cloudwatch, PostgreSQL and MySQL. This release also adds support for [Microsft SQL Server]({{< relref "#microsoft-sql-server" >}}) as metric & table datasource!
|
||||
* [Dashboard & Panels]({{< relref "#dashboard-panels" >}}) Enhancements to Graph and Table panels and improved control for adding new panels.
|
||||
|
||||
## Scrolling
|
||||
|
||||
|
||||
|
||||
## Improved docker image (breaking change)
|
||||
|
||||
Grafana v5.1 brings an improved official docker image which should make it easier to run and use the Grafana docker image and at the same time give more control to the user how to use/run it.
|
||||
|
||||
We've switched the id of the grafana user running Grafana inside a docker container. Unfortunately this means that files created prior to 5.1 won't have the correct permissions for later versions and thereby this introduces a breaking change.
|
||||
We made this change so that it would be easier for you to control what user Grafana is executed as (see examples below).
|
||||
|
||||
Version | User | User ID
|
||||
--------|---------|---------
|
||||
< 5.1 | grafana | 104
|
||||
>= 5.1 | grafana | 472
|
||||
|
||||
Please read the [updated documentation](/installation/docker/#migration-from-a-previous-version-of-the-docker-container-to-5-1-or-later) which includes migration instructions and more information.
|
||||
|
||||
## Improved workflow for provisioned dashboards
|
||||
|
||||
{{< docs-imagebox img="/img/docs/v51/provisioning_cannot_save_dashboard.png" max-width="800px" class="docs-image--right" >}}
|
||||
|
||||
Grafana v5.1 brings an improved workflow for provisioned dashboards:
|
||||
|
||||
* A populated `id` property in JSON is now automatically removed when provisioning dashboards.
|
||||
* When making changes to a provisioned dashboard you can `Save` the dashboard which now will bring up a *Cannot save provisioned dashboard* dialog like seen in the screenshot to the right.
|
||||
|
||||
|
||||
Available options in the dialog will let you `Copy JSON to Clipboard` and/or `Save JSON to file` which can help you synchronize your dashboard changes back to the provisioning source.
|
||||
More information in the [Provisioning documentation](/features/datasources/prometheus/).
|
||||
|
||||
<div class="clearfix"></div>
|
||||
|
||||
## New template variable interpolation syntax
|
||||
|
||||
|
||||
## Alerting
|
||||
|
||||
New enhancements includes support for retries on failed alert queries and updating correct state when pausing/unpausing alerts.
|
||||
|
||||
## Datasources
|
||||
|
||||
### Prometheus
|
||||
|
||||
New enhancements includes support for Prometheus histograms in the heatmap panel and autocomplete of template variables query editor. More information in the [Prometheus data source documentation](/features/datasources/prometheus/).
|
||||
|
||||
### Cloudwatch
|
||||
|
||||
New enhancements includes support for high resolution metrics and dimension filtering. More information in the [Cloudwatch data source documentation](/features/datasources/cloudwatch/).
|
||||
|
||||
### PostgreSQL
|
||||
|
||||
New enhancement includes support for filling in values for missing intervals and better precision handling and data type support for time columns. More information in the [PostgreSQL data source documentation](/features/datasources/postgres/#time-series-queries).
|
||||
|
||||
### MySQL
|
||||
|
||||
New enhancements includes support for filling in values for missing intervals, better precision handling and data type support for time columns and any column except time and metric is now treated as a value column. More information in the [MySQL data source documentation](/features/datasources/mysql/#time-series-queries).
|
||||
|
||||
### Microsoft SQL Server
|
||||
|
||||
{{< docs-imagebox img="/img/docs/v51/mssql_query_editor_showcase.png" max-width= "800px" class="docs-image--right" >}}
|
||||
|
||||
Grafana v5.1 now ships with a built-in Microsoft SQL Server (MSSQL) data source plugin that allows you to query and visualize data from any Microsoft SQL Server 2005 or newer, including Microsoft Azure SQL Database. Have logs or metric data in MSSQL? You can now visualize that data and
|
||||
define alert rules on it like any of our other data sources.
|
||||
|
||||
Same enhancements as described for PostgreSQL and MySQL are included in the MSSQL datasource.
|
||||
|
||||
Please read [Using Microsoft SQL Server in Grafana documentation](/features/datasources/mssql/) for more detailed information on how to get started and use it.
|
||||
|
||||
<div class="clearfix"></div>
|
||||
|
||||
## Dashboard & Panels
|
||||
|
||||
### Adding new panels to a dashboard
|
||||
|
||||
{{< docs-imagebox img="/img/docs/v51/dashboard_add_panel.png" max-width= "800px" class="docs-image--right" >}}
|
||||
|
||||
The control for adding new panels to dashboards now includes functionality to search for the type of panel
|
||||
you want to add. Further, the control has tabs separating functionality for adding and pasting panels:
|
||||
|
||||
* Under the `Add` tab you'll find all of the panel types that you can add.
|
||||
* Under the `Paste` tab you can paste a panel that you've earlier copied.
|
||||
|
||||
By copying a panel in a dashboard, see screenshot below, it will be available in the `Paste` tab in *any* dashboard.
|
||||
This should make it more intuitive to copy/paste panels between dashboards.
|
||||
|
||||
|
||||
|
||||
<div class="clearfix"></div>
|
||||
|
||||
### Graph Panel
|
||||
|
||||
New enhancements includes support for multiple series stacking in histogram mode, thresholds for right Y axis, aligning left and right Y-axes to one level and additional units. More information in the [Graph panel documentation](/features/panels/graph/).
|
||||
|
||||
### Table Panel
|
||||
|
||||
New enhancements includes support for mapping a numeric value/range to text and additional units. More information in the [Table panel documentation](/features/panels/table_panel/#string).
|
||||
|
||||
## 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.
|
||||
Loading…
Reference in New Issue
Block a user