2016-10-21 04:01:34 -05:00
|
|
|
|
+++
|
2020-02-11 12:35:44 -06:00
|
|
|
|
title = "What's new in Grafana v2.1"
|
2019-10-03 11:20:52 -05:00
|
|
|
|
description = "Feature and improvement highlights for Grafana v2.1"
|
2020-02-11 12:35:44 -06:00
|
|
|
|
keywords = ["grafana", "new", "documentation", "2.1", "release notes"]
|
2021-04-15 16:08:58 -05:00
|
|
|
|
aliases = ["/docs/grafana/latest/guides/whats-new-in-v2-1/"]
|
2020-11-09 14:26:49 -06:00
|
|
|
|
weight = -2
|
2020-11-17 09:16:49 -06:00
|
|
|
|
[_build]
|
|
|
|
|
list = false
|
2016-10-21 04:01:34 -05:00
|
|
|
|
+++
|
2015-07-17 15:58:40 -05:00
|
|
|
|
|
2015-07-29 03:24:46 -05:00
|
|
|
|
# What's new in Grafana v2.1
|
2021-08-06 08:52:36 -05:00
|
|
|
|
|
2015-07-29 03:24:46 -05:00
|
|
|
|
Grafana 2.1 brings improvements in three core areas: dashboarding, authentication, and data sources.
|
2015-07-31 08:22:13 -05:00
|
|
|
|
As with every Grafana release, there is a whole slew of new features, enhancements, and bug fixes.
|
2015-07-29 03:24:46 -05:00
|
|
|
|
|
|
|
|
|
## More Dynamic Dashboards
|
2021-08-06 08:52:36 -05:00
|
|
|
|
|
2015-07-29 03:24:46 -05:00
|
|
|
|
The Templating system is one of the most powerful and well-used features of Grafana.
|
|
|
|
|
The 2.1 release brings numerous improvements that make dashboards more dynamic than ever before.
|
|
|
|
|
|
|
|
|
|
### Multi-Value Template Variables
|
2021-08-06 08:52:36 -05:00
|
|
|
|
|
2015-07-29 08:00:53 -05:00
|
|
|
|
A template variable with Multi-Value enabled allows for the selection of multiple values at the same time.
|
|
|
|
|
These variables can then be used in any Panel to make them more dynamic, and to give you the perfect view of your data.
|
2020-05-13 08:42:54 -05:00
|
|
|
|
Multi-Value variables are also enabling the new `row repeat` and `panel repeat` feature described below.
|
2015-07-17 15:58:40 -05:00
|
|
|
|
|
2021-08-06 08:52:36 -05:00
|
|
|
|
![Multi-Value Select](/static/img/docs/v2/multi-select.gif 'Multi-Value Select')
|
2015-07-17 15:58:40 -05:00
|
|
|
|
<br/><br/>
|
|
|
|
|
|
|
|
|
|
### Repeating Rows and Panels
|
2021-08-06 08:52:36 -05:00
|
|
|
|
|
2015-07-29 08:36:04 -05:00
|
|
|
|
It’s now possible to create a dashboard that automatically adds (or removes) both rows and panels based
|
2015-07-29 03:24:46 -05:00
|
|
|
|
on selected variable values. Any row or any panel can be configured to repeat (duplicate itself) based
|
|
|
|
|
on a multi-value template variable.</p>
|
2015-07-17 15:58:40 -05:00
|
|
|
|
|
2021-08-06 08:52:36 -05:00
|
|
|
|
![Repeating Rows and Panels](/static/img/docs/v2/panel-row-repeat.gif 'Repeating Rows and Panels')
|
2015-07-17 15:58:40 -05:00
|
|
|
|
<br/><br/>
|
|
|
|
|
|
2019-10-03 11:20:52 -05:00
|
|
|
|
### Dashboard Links and Navigation
|
2021-08-06 08:52:36 -05:00
|
|
|
|
|
2015-07-29 08:36:04 -05:00
|
|
|
|
To support better navigation between dashboards, it's now possible to create custom and dynamic links from individual
|
|
|
|
|
panels to appropriate Dashboards. You also have the ability to create flexible top-level links on any
|
|
|
|
|
given dashboard thanks to the new dashboard navigation bar feature.
|
2015-07-17 15:58:40 -05:00
|
|
|
|
|
2021-08-06 08:52:36 -05:00
|
|
|
|
![Dashboard Links](/static/img/docs/v2/dash_links.png 'Dashboard Links')
|
2015-07-29 08:36:04 -05:00
|
|
|
|
|
|
|
|
|
Dashboard links can be added under dashboard settings. Either defined as static URLs with a custom icon or as dynamic
|
|
|
|
|
dashboard links or dropdowns based on custom dashboard search query. These links appear in the same
|
|
|
|
|
row under the top menu where template variables appear.
|
2015-07-17 15:58:40 -05:00
|
|
|
|
|
2021-08-06 08:52:36 -05:00
|
|
|
|
---
|
2015-07-31 03:09:32 -05:00
|
|
|
|
|
2015-07-17 15:58:40 -05:00
|
|
|
|
### Better local Dashboard support
|
2021-08-06 08:52:36 -05:00
|
|
|
|
|
2015-07-31 03:09:32 -05:00
|
|
|
|
Grafana can now index Dashboards saved locally as JSON from a given directory. These file based dashboards
|
|
|
|
|
will appear in the regular dashboard search along regular DB dashboards.
|
2015-07-17 15:58:40 -05:00
|
|
|
|
|
2020-09-30 14:45:07 -05:00
|
|
|
|
> **Note:** Saving local dashboards back the folder is not supported; this feature is meant for statically generated JSON dashboards.
|
2015-07-17 15:58:40 -05:00
|
|
|
|
|
2021-08-06 08:52:36 -05:00
|
|
|
|
---
|
2015-07-17 15:58:40 -05:00
|
|
|
|
|
2015-07-29 03:24:46 -05:00
|
|
|
|
## New Authentication Options
|
2021-08-06 08:52:36 -05:00
|
|
|
|
|
2015-07-29 03:24:46 -05:00
|
|
|
|
New authentication methods add numerous options to manage users, roles and organizations.
|
2015-07-17 15:58:40 -05:00
|
|
|
|
|
|
|
|
|
### LDAP support
|
2021-08-06 08:52:36 -05:00
|
|
|
|
|
2015-07-29 03:24:46 -05:00
|
|
|
|
This highly requested feature now allows your Grafana users to login with their LDAP credentials.
|
|
|
|
|
You can also specify mappings between LDAP group memberships and Grafana Organization user roles.
|
2015-07-17 15:58:40 -05:00
|
|
|
|
|
2015-07-29 03:24:46 -05:00
|
|
|
|
### Basic Auth Support
|
2021-08-06 08:52:36 -05:00
|
|
|
|
|
2015-07-17 15:58:40 -05:00
|
|
|
|
You can now authenticate against the Grafana API utilizing a simple username and password with basic HTTP authentication.
|
|
|
|
|
|
2020-11-03 05:09:49 -06:00
|
|
|
|
> **Note:** This can be useful for provisioning and configuring management systems that need
|
2015-07-29 03:24:46 -05:00
|
|
|
|
> to utilize the API without having to create an API key.
|
2015-07-17 15:58:40 -05:00
|
|
|
|
|
2015-07-29 03:24:46 -05:00
|
|
|
|
### Auth Proxy Support
|
2021-08-06 08:52:36 -05:00
|
|
|
|
|
2015-07-17 15:58:40 -05:00
|
|
|
|
You can now authenticate utilizing a header (eg. X-Authenticated-User, or X-WEBAUTH-USER)
|
|
|
|
|
|
2020-09-30 14:45:07 -05:00
|
|
|
|
> **Note:** this can be useful in situations with reverse proxies.
|
2015-07-17 15:58:40 -05:00
|
|
|
|
|
|
|
|
|
### New “Read-only Editor” User Role
|
2021-08-06 08:52:36 -05:00
|
|
|
|
|
2015-07-29 03:24:46 -05:00
|
|
|
|
There is a new User role available in this version of Grafana: “Read-only Editor”. This role behaves just
|
2021-08-06 08:52:36 -05:00
|
|
|
|
like the Viewer role does in Grafana 2.0. That is you can edit graphs and queries but not save dashboards.
|
2015-07-29 03:24:46 -05:00
|
|
|
|
The Viewer role has been modified in Grafana 2.1 so that users assigned this role can no longer edit panels.
|
2015-07-17 15:58:40 -05:00
|
|
|
|
|
2021-08-06 08:52:36 -05:00
|
|
|
|
---
|
2015-07-17 15:58:40 -05:00
|
|
|
|
|
2015-07-29 03:24:46 -05:00
|
|
|
|
## Data source Improvements
|
2015-07-17 15:58:40 -05:00
|
|
|
|
|
2015-07-29 03:24:46 -05:00
|
|
|
|
### InfluxDB 0.9 Support
|
2021-08-06 08:52:36 -05:00
|
|
|
|
|
2015-07-31 03:09:32 -05:00
|
|
|
|
Grafana 2.1 now comes with full support for InfluxDB 0.9. There is a new query editor designed from scratch
|
2015-07-29 03:24:46 -05:00
|
|
|
|
for the new features InfluxDB 0.9 enables.
|
2015-07-17 15:58:40 -05:00
|
|
|
|
|
2021-08-06 08:52:36 -05:00
|
|
|
|
![InfluxDB Editor](/static/img/docs/v2/influx_09_editor_anim.gif 'InfluxDB Editor')
|
2015-07-17 15:58:40 -05:00
|
|
|
|
|
2015-07-31 03:09:32 -05:00
|
|
|
|
<br/>
|
2015-07-17 15:58:40 -05:00
|
|
|
|
|
2015-07-31 08:22:13 -05:00
|
|
|
|
### OpenTSDB Improvements
|
2021-08-06 08:52:36 -05:00
|
|
|
|
|
2015-07-29 03:24:46 -05:00
|
|
|
|
Grafana OpenTSDB data source now supports template variable values queries. This means you can create
|
|
|
|
|
template variables that fetches the values from OpenTSDB (for example metric names, tag names, or tag values).
|
|
|
|
|
The query editor is also enhanced to limiting tags by metric.
|
2015-07-17 15:58:40 -05:00
|
|
|
|
|
2020-09-30 14:45:07 -05:00
|
|
|
|
> **Note:** OpenTSDB config option tsd.core.meta.enable_realtime_ts must enabled for OpenTSDB lookup API)
|
2015-07-17 15:58:40 -05:00
|
|
|
|
|
|
|
|
|
### New Data Source: KairosDB
|
2021-08-06 08:52:36 -05:00
|
|
|
|
|
2015-07-29 03:24:46 -05:00
|
|
|
|
The Cassandra backed time series database KairosDB is now supported in Grafana out of the box. Thank you to
|
|
|
|
|
<a href="https://github.com/masaori335" target="_blank">masaori335</a> for his hard work in getting it to this point.
|
2015-07-17 15:58:40 -05:00
|
|
|
|
|
2021-08-06 08:52:36 -05:00
|
|
|
|
---
|
2015-07-17 15:58:40 -05:00
|
|
|
|
|
|
|
|
|
## Panel Improvements
|
|
|
|
|
|
2015-07-29 03:24:46 -05:00
|
|
|
|
Grafana 2.1 gives you even more flexibility customizing how individual panels render.
|
|
|
|
|
Overriding the colors of specific series using regular expressions, changing how series stack,
|
|
|
|
|
and allowing string values will help you better understand your data at a glance.
|
|
|
|
|
|
2015-07-17 15:58:40 -05:00
|
|
|
|
### Graph Panel
|
2021-08-06 08:52:36 -05:00
|
|
|
|
|
2015-07-31 03:09:32 -05:00
|
|
|
|
Define series color using regex rule. This is useful when you have templated graphs with series names
|
|
|
|
|
that change depending selected template variables. Using a regex style override rule you could
|
|
|
|
|
for example make all series that contain the word **CPU** `red` and assigned to the second y axis.
|
|
|
|
|
|
2021-08-06 08:52:36 -05:00
|
|
|
|
![Define series color using regex rule](/static/img/docs/v2/regex_color_override.png 'Define series color using regex rule')
|
2015-07-31 03:09:32 -05:00
|
|
|
|
|
2015-10-21 23:13:39 -05:00
|
|
|
|
New series style override, negative-y transform and stack groups. Negative y transform is
|
2015-07-31 03:09:32 -05:00
|
|
|
|
very useful if you want to plot a series on the negative y scale without affecting the legend values like min or max or
|
|
|
|
|
the values shown in the hover tooltip.
|
2015-07-17 15:58:40 -05:00
|
|
|
|
|
2021-08-06 08:52:36 -05:00
|
|
|
|
![Negative-y Transform](/static/img/docs/v2/negative-y.png 'Negative-y Transform')
|
2015-07-17 15:58:40 -05:00
|
|
|
|
|
2021-08-06 08:52:36 -05:00
|
|
|
|
![Negative-y Transform](/static/img/docs/v2/negative-y-form.png 'Negative-y Transform')
|
2015-07-17 15:58:40 -05:00
|
|
|
|
|
|
|
|
|
### Singlestat Panel
|
2021-08-06 08:52:36 -05:00
|
|
|
|
|
2015-07-31 03:09:32 -05:00
|
|
|
|
Now support string values. Useful for time series database like InfluxDB that supports
|
|
|
|
|
string values.
|
2015-07-31 08:22:13 -05:00
|
|
|
|
|
|
|
|
|
### Changelog
|
2021-08-06 08:52:36 -05:00
|
|
|
|
|
2015-07-31 08:22:13 -05:00
|
|
|
|
For a detailed list and link to github issues for everything included in the 2.1 release please
|
2015-10-14 13:00:25 -05:00
|
|
|
|
view the [CHANGELOG.md](https://github.com/grafana/grafana/blob/master/CHANGELOG.md) file.
|