2016-10-21 04:01:34 -05:00
|
|
|
|
+++
|
2020-02-11 12:35:44 -06:00
|
|
|
|
title = "What's new in Grafana v3.0"
|
2019-10-03 11:20:52 -05:00
|
|
|
|
description = "Feature and improvement highlights for Grafana v3.0"
|
2020-02-11 12:35:44 -06:00
|
|
|
|
keywords = ["grafana", "new", "documentation", "3.0", "release notes"]
|
2016-10-21 04:01:34 -05:00
|
|
|
|
type = "docs"
|
|
|
|
|
[menu.docs]
|
|
|
|
|
name = "Version 3.0"
|
|
|
|
|
identifier = "v3.0"
|
|
|
|
|
parent = "whatsnew"
|
2017-01-17 07:56:11 -06:00
|
|
|
|
weight = 6
|
2016-10-21 04:01:34 -05:00
|
|
|
|
+++
|
2016-05-02 08:35:49 -05:00
|
|
|
|
|
2020-02-11 12:35:44 -06:00
|
|
|
|
# What's new in Grafana v3.0
|
2016-05-02 08:35:49 -05:00
|
|
|
|
|
|
|
|
|
## Commercial Support
|
|
|
|
|
|
2017-03-20 04:20:32 -05:00
|
|
|
|
Commercial Support subscriptions for Grafana are now [generally available](https://grafana.com/support/plans/).
|
2016-05-02 08:35:49 -05:00
|
|
|
|
|
|
|
|
|
Raintank is committed to a 100% open-source strategy for Grafana. We
|
|
|
|
|
do not want to go down the “open core” route. If your organization
|
|
|
|
|
finds Grafana valuable, please consider purchasing a subscription. Get
|
|
|
|
|
direct support, bug fixes, and training from the core Grafana team.
|
|
|
|
|
|
|
|
|
|
## Plugins
|
|
|
|
|
|
|
|
|
|
With the popularity of Grafana continuing to accelerate, it has been
|
|
|
|
|
challenging to keep up with all the requests for new features, new
|
|
|
|
|
panels, new data sources, and new functionality. Saying “no” so often
|
|
|
|
|
has been frustrating, especially for an open source project with such
|
|
|
|
|
a vibrant community.
|
|
|
|
|
|
|
|
|
|
The team felt that it was time to dramatically improve extensibility
|
|
|
|
|
through plugin support. Grafana 3.0 comes with a completely revamped
|
|
|
|
|
plugin SDK / API.
|
|
|
|
|
|
|
|
|
|
We’ve refactored our **Data Source** plugin architecture and added
|
|
|
|
|
two new plugin types:
|
|
|
|
|
|
|
|
|
|
* **Panel** plugins let you add new panel types for your Dashboards.
|
|
|
|
|
* **App** plugins bundle **Panels** plugins, **Data Sources** plugins,
|
|
|
|
|
Dashboards, and Grafana **Pages**. Apps are a great way to provide an
|
|
|
|
|
entire experience right within Grafana.
|
|
|
|
|
|
2017-03-20 04:20:32 -05:00
|
|
|
|
## Grafana.com
|
2016-05-02 08:35:49 -05:00
|
|
|
|
|
2016-11-04 14:29:17 -05:00
|
|
|
|
<img src="/img/docs/v3/grafana_net_tour.png">
|
2016-05-02 08:35:49 -05:00
|
|
|
|
|
2017-03-20 04:20:32 -05:00
|
|
|
|
[Grafana.com](https://grafana.com) offers a central repository where the community can come together to discover, create and
|
2016-05-10 13:33:29 -05:00
|
|
|
|
share plugins (data sources, panels, apps) and dashboards.
|
2016-05-02 08:35:49 -05:00
|
|
|
|
|
2016-05-10 13:33:29 -05:00
|
|
|
|
We are also working on a hosted Graphite-compatible data source that will be optimized for use with Grafana.
|
2017-03-20 04:20:32 -05:00
|
|
|
|
It’ll be easy to combine your existing data source(s) with this OpenSaaS option. Finally, Grafana.com can
|
2016-05-10 13:33:29 -05:00
|
|
|
|
also be a hub to manage all your Grafana instances. You’ll be able to monitor their health and availability,
|
|
|
|
|
perform dashboard backups, and more.
|
2016-05-02 08:35:49 -05:00
|
|
|
|
|
|
|
|
|
We are also working on a hosted Graphite-compatible Data Source that
|
|
|
|
|
will be optimized for use with Grafana. It’ll be easy to combine your
|
|
|
|
|
existing Data Source(s) with this OpenSaaS option.
|
|
|
|
|
|
2017-03-20 04:20:32 -05:00
|
|
|
|
Finally, Grafana.com will also be a hub to manage all your Grafana
|
2016-05-02 08:35:49 -05:00
|
|
|
|
instances. You’ll be able to monitor their health and availability,
|
|
|
|
|
perform Dashboard backups, and more.
|
|
|
|
|
|
|
|
|
|
Grafana.net will officially launch along with the stable version of
|
2017-03-20 04:20:32 -05:00
|
|
|
|
Grafana 3.0, but go to <a href=https://grafana.com> and check out the preview
|
2016-05-02 08:35:49 -05:00
|
|
|
|
and sign up for an account</a> in the meantime.
|
|
|
|
|
|
|
|
|
|
## grafana-cli
|
|
|
|
|
|
|
|
|
|
Grafana 3.0 comes with a new command line tool called grafana-cli. You
|
|
|
|
|
can easily install plugins from Grafana.net with it. For
|
|
|
|
|
example:
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
grafana-cli install grafana-pie-chart-panel
|
|
|
|
|
```
|
|
|
|
|
|
2019-10-03 11:20:52 -05:00
|
|
|
|
## Personalization and Preferences
|
2016-05-02 08:35:49 -05:00
|
|
|
|
|
|
|
|
|
The home dashboard, timezone and theme can now be customized on Organization
|
|
|
|
|
and user Profile level. Grafana can also track recently viewed dashboards, which
|
|
|
|
|
can then be displayed in the dashboard list panel.
|
|
|
|
|
|
|
|
|
|
## Improved Playlists
|
|
|
|
|
|
|
|
|
|
You can now save Playlists, and start them by using a Playlist URL. If
|
|
|
|
|
you update a running Playlist, it will update after its next cycle.
|
|
|
|
|
|
|
|
|
|
This is powerful as it allows you to remote control Grafana. If you
|
|
|
|
|
have a big TV display showing Grafana in your company lobby, create a
|
|
|
|
|
playlist named Lobby, and start it on the computer connected to the
|
|
|
|
|
Lobby TV.
|
|
|
|
|
|
|
|
|
|
You can now change the Lobby playlist and have the dashboards shown in
|
|
|
|
|
the Lobby update accordingly, automatically.
|
|
|
|
|
|
|
|
|
|
The playlist does not even have to contain multiple Dashboards; you
|
|
|
|
|
can use this feature to reload the whole Dashboard (and Grafana)
|
|
|
|
|
periodically and remotely.
|
|
|
|
|
|
|
|
|
|
You can also make Playlists dynamic by using Dashboard **tags** to
|
|
|
|
|
define the Playlist.
|
|
|
|
|
|
2016-11-04 14:29:17 -05:00
|
|
|
|
<img src="/img/docs/v3/playlist.png">
|
2016-05-02 08:35:49 -05:00
|
|
|
|
|
|
|
|
|
## Improved UI
|
|
|
|
|
|
|
|
|
|
We’ve always tried to focus on a good looking, usable, and responsive
|
|
|
|
|
UI. We’ve continued to pay a lot of attention to these areas in this
|
|
|
|
|
release.
|
|
|
|
|
|
|
|
|
|
Grafana 3.0 has a dramatically updated UI that not only looks better
|
|
|
|
|
but also has a number of usability improvements. The side menu now
|
|
|
|
|
works as a dropdown that you can pin to the side. The Organization /
|
|
|
|
|
Profile / Sign out side menu links have been combined into an on hover
|
|
|
|
|
slide out menu.
|
|
|
|
|
|
|
|
|
|
In addition, all the forms and the layouts of all pages have been
|
|
|
|
|
updated to look and flow better, and be much more consistent. There
|
|
|
|
|
are literally hundreds of UI improvements and refinements.
|
|
|
|
|
|
|
|
|
|
Here’s the new side menu in action:
|
|
|
|
|
|
2016-11-04 14:29:17 -05:00
|
|
|
|
<img src="/img/docs/v3/menu.gif">
|
2016-05-02 08:35:49 -05:00
|
|
|
|
|
|
|
|
|
And here's the new look for Dashboard settings:
|
|
|
|
|
|
2016-11-04 14:29:17 -05:00
|
|
|
|
<img src="/img/docs/v3/dashboard_settings.png">
|
2016-05-02 08:35:49 -05:00
|
|
|
|
|
2020-01-06 10:25:13 -06:00
|
|
|
|
Check out the <a href="https://play.grafana.org" target="_blank">Play
|
2016-05-02 08:35:49 -05:00
|
|
|
|
Site</a> to get a feel for some of the UI changes.
|
|
|
|
|
|
|
|
|
|
## Improved Annotations
|
|
|
|
|
|
|
|
|
|
It is now possible to define a link in each annotation. You can hover
|
|
|
|
|
over the link and click the annotation text. This feature is very
|
|
|
|
|
useful for linking to particular commits or tickets where more
|
|
|
|
|
detailed information can be presented to the user.
|
|
|
|
|
|
2016-11-04 14:29:17 -05:00
|
|
|
|
<img src="/img/docs/v3/annotation_links.gif">
|
2016-05-02 08:35:49 -05:00
|
|
|
|
|
|
|
|
|
## Data source variables
|
|
|
|
|
|
|
|
|
|
This has been a top requested feature for very long we are exited to finally provide
|
|
|
|
|
this feature. You can now add a new `Data source` type variable. That will
|
|
|
|
|
automatically be filled with instance names of your data sources.
|
|
|
|
|
|
2016-11-04 14:29:17 -05:00
|
|
|
|
<img src="/img/docs/v3/data_source_variable.png">
|
2016-05-02 08:35:49 -05:00
|
|
|
|
|
|
|
|
|
You can then use this variable as the panel data source:
|
|
|
|
|
|
2016-11-04 14:29:17 -05:00
|
|
|
|
<img src="/img/docs/v3/data_source_variable_use.png">
|
2016-05-02 08:35:49 -05:00
|
|
|
|
|
|
|
|
|
This will allow you to quickly change data source server and reuse the
|
|
|
|
|
same dashboard for different instances of your metrics backend. For example
|
|
|
|
|
you might have Graphite running in multiple data centers or environments.
|
|
|
|
|
|
|
|
|
|
## Prometheus, InfluxDB, and OpenTSDB improvements
|
|
|
|
|
|
|
|
|
|
All three of these popular included Data Sources have seen a variety
|
|
|
|
|
of improvements in this release. Here are some highlights:
|
|
|
|
|
|
|
|
|
|
### Prometheus
|
|
|
|
|
|
|
|
|
|
The Prometheus Data Source now supports annotations.
|
|
|
|
|
|
|
|
|
|
### InfluxDB
|
|
|
|
|
|
|
|
|
|
You can now select the InfluxDB policy from the query editor.
|
2016-11-04 14:29:17 -05:00
|
|
|
|
<img src="/img/docs/v3/influxdb_policy.png">
|
2016-05-02 08:35:49 -05:00
|
|
|
|
|
|
|
|
|
Grafana 3.0 also comes with support for InfluxDB 0.11 and InfluxDB 0.12.
|
|
|
|
|
|
|
|
|
|
### OpenTSDB
|
|
|
|
|
|
|
|
|
|
OpenTSDB 2.2 is better supported and now supports millisecond precision.
|
|
|
|
|
|
|
|
|
|
## Breaking changes
|
|
|
|
|
|
|
|
|
|
Dashboards from v2.6 are compatible; no manual updates should be necessary. There could
|
|
|
|
|
be some edge case scenarios where dashboards using templating could stop working.
|
|
|
|
|
If that is the case just enter the edit view for the template variable and hit Update button.
|
|
|
|
|
This is due to a simplification of the variable format system where template variables are
|
|
|
|
|
now stored without any formatting (glob/regex/etc), this is done on the fly when the
|
|
|
|
|
variable is interpolated.
|
|
|
|
|
|
|
|
|
|
* Plugin API: The plugin API has changed so if you are using a custom
|
|
|
|
|
data source (or panel) they need to be updated as well.
|
|
|
|
|
|
|
|
|
|
* InfluxDB 0.8: This data source is no longer included in releases,
|
2017-03-20 04:20:32 -05:00
|
|
|
|
you can still install manually from [Grafana.com](https://grafana.com)
|
2016-05-02 08:35:49 -05:00
|
|
|
|
|
|
|
|
|
* KairosDB: This data source has also no longer shipped with Grafana,
|
2017-03-20 04:20:32 -05:00
|
|
|
|
you can install it manually from [Grafana.com](https://grafana.com)
|
2016-05-02 08:35:49 -05:00
|
|
|
|
|
2016-05-10 13:33:29 -05:00
|
|
|
|
## Plugin showcase
|
|
|
|
|
|
2017-03-20 04:20:32 -05:00
|
|
|
|
Discovering and installing plugins is very quick and easy with Grafana 3.0 and [Grafana.com](https://grafana.com). Here
|
2018-10-06 10:09:41 -05:00
|
|
|
|
are a couple that I encourage you try!
|
2016-05-10 13:33:29 -05:00
|
|
|
|
|
2017-03-20 04:20:32 -05:00
|
|
|
|
#### [Clock Panel](https://grafana.com/plugins/grafana-clock-panel)
|
2016-05-10 13:33:29 -05:00
|
|
|
|
Support's both current time and count down mode.
|
2016-11-04 14:29:17 -05:00
|
|
|
|
<img src="/img/docs/v3/clock_panel.png">
|
2016-05-10 13:33:29 -05:00
|
|
|
|
|
2017-03-20 04:20:32 -05:00
|
|
|
|
#### [Pie Chart Panel](https://grafana.com/plugins/grafana-piechart-panel)
|
2016-05-10 13:33:29 -05:00
|
|
|
|
A simple pie chart panel is now available as an external plugin.
|
2016-11-04 14:29:17 -05:00
|
|
|
|
<img src="/img/docs/v3/pie_chart_panel.png">
|
2016-05-10 13:33:29 -05:00
|
|
|
|
|
2017-03-20 04:20:32 -05:00
|
|
|
|
#### [WorldPing App](https://grafana.com/plugins/raintank-worldping-app)
|
2016-05-10 13:33:29 -05:00
|
|
|
|
This is full blown Grafana App that adds new panels, data sources and pages to give
|
|
|
|
|
feature rich global performance monitoring directly from your on-prem Grafana.
|
|
|
|
|
|
2016-11-04 14:29:17 -05:00
|
|
|
|
<img src="/img/docs/v3/wP-Screenshot-dash-web.png">
|
2016-05-10 13:33:29 -05:00
|
|
|
|
|
2017-03-20 04:20:32 -05:00
|
|
|
|
#### [Zabbix App](https://grafana.com/plugins/alexanderzobnin-zabbix-app)
|
2016-05-10 13:33:29 -05:00
|
|
|
|
This app contains the already very pouplar Zabbix data source plugin, 2 dashboards and a triggers panel. It is
|
|
|
|
|
created and maintained by [Alexander Zobnin](https://github.com/alexanderzobnin/grafana-zabbix).
|
|
|
|
|
|
2016-11-04 14:29:17 -05:00
|
|
|
|
<img src="/img/docs/v3/zabbix_app.png">
|
2016-05-10 13:33:29 -05:00
|
|
|
|
|
2019-12-10 12:23:07 -06:00
|
|
|
|
Check out the full list of plugins on [Grafana.com](https://grafana.com/plugins)
|
2016-05-10 13:33:29 -05:00
|
|
|
|
|
2016-05-02 08:35:49 -05:00
|
|
|
|
## CHANGELOG
|
|
|
|
|
|
|
|
|
|
For a detailed list and link to github issues for everything included
|
|
|
|
|
in the 3.0 release please view the
|
2020-02-11 12:35:44 -06:00
|
|
|
|
[CHANGELOG.md](https://github.com/grafana/grafana/blob/master/CHANGELOG.md) file.
|