| 
									
										
										
										
											2016-10-21 17:01:34 +08:00
										 |  |  |  | +++ | 
					
						
							|  |  |  |  | title = "What's New in Grafana v3.0" | 
					
						
							|  |  |  |  | description = "Feature & improvement highlights for Grafana v3.0" | 
					
						
							|  |  |  |  | keywords = ["grafana", "new", "documentation", "3.0"] | 
					
						
							|  |  |  |  | type = "docs" | 
					
						
							|  |  |  |  | [menu.docs] | 
					
						
							|  |  |  |  | name = "Version 3.0" | 
					
						
							|  |  |  |  | identifier = "v3.0" | 
					
						
							|  |  |  |  | parent = "whatsnew" | 
					
						
							| 
									
										
										
										
											2017-01-17 21:56:11 +08:00
										 |  |  |  | weight = 6 | 
					
						
							| 
									
										
										
										
											2016-10-21 17:01:34 +08:00
										 |  |  |  | +++ | 
					
						
							| 
									
										
										
										
											2016-05-02 21:35:49 +08:00
										 |  |  |  | 
 | 
					
						
							|  |  |  |  | # What's New in Grafana v3.0
 | 
					
						
							|  |  |  |  | 
 | 
					
						
							|  |  |  |  | ## Commercial Support
 | 
					
						
							|  |  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2017-03-20 17:20:32 +08:00
										 |  |  |  | Commercial Support subscriptions for Grafana are now [generally available](https://grafana.com/support/plans/). | 
					
						
							| 
									
										
										
										
											2016-05-02 21:35:49 +08: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 17:20:32 +08:00
										 |  |  |  | ## Grafana.com
 | 
					
						
							| 
									
										
										
										
											2016-05-02 21:35:49 +08:00
										 |  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2016-11-05 03:29:17 +08:00
										 |  |  |  | <img src="/img/docs/v3/grafana_net_tour.png"> | 
					
						
							| 
									
										
										
										
											2016-05-02 21:35:49 +08:00
										 |  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2017-03-20 17:20:32 +08:00
										 |  |  |  | [Grafana.com](https://grafana.com) offers a central repository where the community can come together to discover, create and | 
					
						
							| 
									
										
										
										
											2016-05-11 02:33:29 +08:00
										 |  |  |  | share plugins (data sources, panels, apps) and dashboards. | 
					
						
							| 
									
										
										
										
											2016-05-02 21:35:49 +08:00
										 |  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2016-05-11 02:33:29 +08:00
										 |  |  |  | We are also working on a hosted Graphite-compatible data source that will be optimized for use with Grafana. | 
					
						
							| 
									
										
										
										
											2017-03-20 17:20:32 +08:00
										 |  |  |  | It’ll be easy to combine your existing data source(s) with this OpenSaaS option. Finally, Grafana.com can | 
					
						
							| 
									
										
										
										
											2016-05-11 02:33:29 +08: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 21:35:49 +08: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 17:20:32 +08:00
										 |  |  |  | Finally, Grafana.com will also be a hub to manage all your Grafana | 
					
						
							| 
									
										
										
										
											2016-05-02 21:35:49 +08: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 17:20:32 +08:00
										 |  |  |  | Grafana 3.0, but go to <a href=https://grafana.com> and check out the preview | 
					
						
							| 
									
										
										
										
											2016-05-02 21:35:49 +08: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 | 
					
						
							|  |  |  |  | ``` | 
					
						
							|  |  |  |  | 
 | 
					
						
							|  |  |  |  | ## Personalization & Preferences
 | 
					
						
							|  |  |  |  | 
 | 
					
						
							|  |  |  |  | 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-05 03:29:17 +08:00
										 |  |  |  | <img src="/img/docs/v3/playlist.png"> | 
					
						
							| 
									
										
										
										
											2016-05-02 21:35:49 +08: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-05 03:29:17 +08:00
										 |  |  |  | <img src="/img/docs/v3/menu.gif"> | 
					
						
							| 
									
										
										
										
											2016-05-02 21:35:49 +08:00
										 |  |  |  | 
 | 
					
						
							|  |  |  |  | And here's the new look for Dashboard settings: | 
					
						
							|  |  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2016-11-05 03:29:17 +08:00
										 |  |  |  | <img src="/img/docs/v3/dashboard_settings.png"> | 
					
						
							| 
									
										
										
										
											2016-05-02 21:35:49 +08:00
										 |  |  |  | 
 | 
					
						
							|  |  |  |  | Check out the <a href="http://play.grafana.org" target="_blank">Play | 
					
						
							|  |  |  |  | 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-05 03:29:17 +08:00
										 |  |  |  | <img src="/img/docs/v3/annotation_links.gif"> | 
					
						
							| 
									
										
										
										
											2016-05-02 21:35:49 +08: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-05 03:29:17 +08:00
										 |  |  |  | <img src="/img/docs/v3/data_source_variable.png"> | 
					
						
							| 
									
										
										
										
											2016-05-02 21:35:49 +08:00
										 |  |  |  | 
 | 
					
						
							|  |  |  |  | You can then use this variable as the panel data source: | 
					
						
							|  |  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2016-11-05 03:29:17 +08:00
										 |  |  |  | <img src="/img/docs/v3/data_source_variable_use.png"> | 
					
						
							| 
									
										
										
										
											2016-05-02 21:35:49 +08: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-05 03:29:17 +08:00
										 |  |  |  | <img src="/img/docs/v3/influxdb_policy.png"> | 
					
						
							| 
									
										
										
										
											2016-05-02 21:35:49 +08: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 17:20:32 +08:00
										 |  |  |  | you can still install manually from [Grafana.com](https://grafana.com) | 
					
						
							| 
									
										
										
										
											2016-05-02 21:35:49 +08:00
										 |  |  |  | 
 | 
					
						
							|  |  |  |  | * KairosDB: This data source has also no longer shipped with Grafana, | 
					
						
							| 
									
										
										
										
											2017-03-20 17:20:32 +08:00
										 |  |  |  | you can install it manually from [Grafana.com](https://grafana.com) | 
					
						
							| 
									
										
										
										
											2016-05-02 21:35:49 +08:00
										 |  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2016-05-11 02:33:29 +08:00
										 |  |  |  | ## Plugin showcase
 | 
					
						
							|  |  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2017-03-20 17:20:32 +08:00
										 |  |  |  | Discovering and installing plugins is very quick and easy with Grafana 3.0 and [Grafana.com](https://grafana.com). Here | 
					
						
							| 
									
										
										
										
											2018-10-06 23:09:41 +08:00
										 |  |  |  | are a couple that I encourage you try! | 
					
						
							| 
									
										
										
										
											2016-05-11 02:33:29 +08:00
										 |  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2017-03-20 17:20:32 +08:00
										 |  |  |  | #### [Clock Panel](https://grafana.com/plugins/grafana-clock-panel)
 | 
					
						
							| 
									
										
										
										
											2016-05-11 02:33:29 +08:00
										 |  |  |  | Support's both current time and count down mode. | 
					
						
							| 
									
										
										
										
											2016-11-05 03:29:17 +08:00
										 |  |  |  | <img src="/img/docs/v3/clock_panel.png"> | 
					
						
							| 
									
										
										
										
											2016-05-11 02:33:29 +08:00
										 |  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2017-03-20 17:20:32 +08:00
										 |  |  |  | #### [Pie Chart Panel](https://grafana.com/plugins/grafana-piechart-panel)
 | 
					
						
							| 
									
										
										
										
											2016-05-11 02:33:29 +08:00
										 |  |  |  | A simple pie chart panel is now available as an external plugin. | 
					
						
							| 
									
										
										
										
											2016-11-05 03:29:17 +08:00
										 |  |  |  | <img src="/img/docs/v3/pie_chart_panel.png"> | 
					
						
							| 
									
										
										
										
											2016-05-11 02:33:29 +08:00
										 |  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2017-03-20 17:20:32 +08:00
										 |  |  |  | #### [WorldPing App](https://grafana.com/plugins/raintank-worldping-app)
 | 
					
						
							| 
									
										
										
										
											2016-05-11 02:33:29 +08: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-05 03:29:17 +08:00
										 |  |  |  | <img src="/img/docs/v3/wP-Screenshot-dash-web.png"> | 
					
						
							| 
									
										
										
										
											2016-05-11 02:33:29 +08:00
										 |  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2017-03-20 17:20:32 +08:00
										 |  |  |  | #### [Zabbix App](https://grafana.com/plugins/alexanderzobnin-zabbix-app)
 | 
					
						
							| 
									
										
										
										
											2016-05-11 02:33:29 +08: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-05 03:29:17 +08:00
										 |  |  |  | <img src="/img/docs/v3/zabbix_app.png"> | 
					
						
							| 
									
										
										
										
											2016-05-11 02:33:29 +08:00
										 |  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2017-03-20 17:20:32 +08:00
										 |  |  |  | Checkout the full list of plugins on [Grafana.com](https://grafana.com/plugins) | 
					
						
							| 
									
										
										
										
											2016-05-11 02:33:29 +08:00
										 |  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2016-05-02 21:35:49 +08:00
										 |  |  |  | ## CHANGELOG
 | 
					
						
							|  |  |  |  | 
 | 
					
						
							|  |  |  |  | For a detailed list and link to github issues for everything included | 
					
						
							|  |  |  |  | in the 3.0 release please view the | 
					
						
							|  |  |  |  | [CHANGELOG.md](https://github.com/grafana/grafana/blob/master/CHANGELOG.md) | 
					
						
							|  |  |  |  | file. |