grafana/CHANGELOG.md

26 KiB

1.8.0 (unreleased)

UI polish / changes

  • Issue #725. UI: All modal editors are removed and replaced by an edit pane under menu. The look of editors is also updated and polished. Search dropdown is also shown as pane under menu and has seen some UI polish.

Filtering feature overhaul

  • Filtering renamed to Templating, and filter items to variables
  • Filter editing has gotten its own edit pane with much improved UI and options
  • Issue #296. Templating: Can now retrieve variable values from a non-default data source
  • Issue #219. Templating: Template variable value selection is now a typeahead autocomplete dropdown

InfluxDB Breaking changes

  • To better support templating, fill(0) and group by time low limit some changes has been made to the editor and query model schema
  • Currently some of these changes are breaking
  • If you used custom condition filter you need to open the graph in edit mode, the editor will update the schema, and the queries should work again
  • If you used a raw query you need to remove the time filter and replace it with $timeFilter (this is done automatically when you switch from query editor to raw query, but old raw queries needs to updated)
  • If you used group by and later removed the group by the graph could break, open in editor and should correct it
  • InfluxDB annotation queries that used timeFilter should be updated to use $timeFilter syntax instead
  • Might write an upgrade tool to update dashboards automatically, but right now master (1.8) includes the above breaking changes

InfluxDB query editor enhancements

  • Issue #756. InfluxDB: Add option for fill(0) and fill(null), integrated help in editor for why this option is important when stacking series
  • Issue #743. InfluxDB: A group by time option for all queries in graph panel that supports a low limit for auto group by time, very important for stacking and fill(0)
  • The above to enhancements solves the problems associated with stacked bars and lines when points are missing, these issues are solved:
  • Issue #673. InfluxDB: stacked bars missing intermediate data points, unless lines also enabled
  • Issue #674. InfluxDB: stacked chart ignoring series without latest values
  • Issue #534. InfluxDB: No order in stacked bars mode

New features and improvements

  • Issue #117. Graphite: Graphite query builder can now handle functions that multiple series as arguments!
  • Issue #281. Graphite: Metric node/segment selection is now a textbox with autocomplete dropdown, allow for custom glob expression for single node segment without entering text editor mode.
  • Issue #304. Dashboard: View dashboard json, edit/update any panel using json editor, makes it possible to quickly copy a graph from one dashboard to another.
  • Issue #578. Dashboard: Row option to display row title even when the row is visible
  • Issue #672. Dashboard: panel fullscreen & edit state is present in url, can now link to graph in edit & fullscreen mode.
  • Issue #709. Dashboard: Small UI look polish to search results, made dashboard title link are larger
  • Issue #425. Graph: New section in 'Display Styles' tab to override any display setting on per series bases (mix and match lines, bars, points, fill, stack, line width etc)
  • Issue #634. Dashboard: Dashboard tags now in different colors (from fixed palette) determined by tag name.
  • Issue #685. Dashboard: New config.js option to change/remove window title prefix.

Fixes

  • Issue #696. Graph: Fix for y-axis format 'none' when values are in scientific notation (ex 2.3e-13)
  • Issue #733. Graph: Fix for tooltip current value decimal precision when 'none' axis format was selected
  • Issue #697. Graphite: Fix for Glob syntax in graphite queries ([1-9] and ?) that made the query editor / parser bail and fallback to a text box.
  • Issue #702. Graphite: Fix for nonNegativeDerivative function, now possible to not include optional first parameter maxValue
  • Issue #277. Dashboard: Fix for timepicker date & tooltip when UTC timezone selected.
  • Issue #699. Dashboard: Fix for bug when adding rows from dashboard settings dialog.
  • Issue #723. Dashboard: Fix for hide controls setting not used/initialized on dashboard load
  • Issue #724. Dashboard: Fix for zoom out causing right hand "to" range to be set in the future.

Tech

  • Upgraded from angularjs 1.1.5 to 1.3 beta 17;
  • Switch from underscore to lodash
  • helpers to easily unit test angularjs controllers and services
  • Test coverage through coveralls
  • Upgrade from jquery 1.8.0 to 2.1.1 (Removes support for IE7 & IE8)

1.7.1 (unreleased)

Fixes

  • Issue #691. Dashboard: Tooltip fixes, sometimes they would not show, and sometimes they would get stuck.
  • Issue #695. Dashboard: Tooltip on goto home menu icon would get stuck after clicking on it

1.7.0 (2014-08-11)

Fixes

  • Issue #652. Timepicker: Entering custom date range impossible when refresh is low (now is constantly reset)
  • Issue #450. Graph: Tooltip does not disappear sometimes and would get stuck
  • Issue #655. General: Auto refresh not initiated / started after dashboard loading
  • Issue #657. General: Fix for refresh icon in IE browsers
  • Issue #661. Annotations: Elasticsearch querystring with filter template replacements was not interpolated
  • Issue #660. OpenTSDB: fix opentsdb queries that returned more than one series

Change

  • Issue #681. Dashboard: The panel error bar has been replaced with a small error indicator, this indicator does not change panel height and is a lot less intrusive. Hover over it for short details, click on it for more details.

1.7.0-rc1 (2014-08-05)

New features or improvements

  • Issue #581. InfluxDB: Add continuous query in series results (series typeahead).
  • Issue #584. InfluxDB: Support for alias & alias patterns when using raw query mode
  • Issue #394. InfluxDB: Annotation support
  • Issue #633. InfluxDB: InfluxDB can now act as a datastore for dashboards
  • Issue #610. InfluxDB: Support for InfluxdB v0.8 list series response schemea (series typeahead)
  • Issue #525. InfluxDB: Enhanced series aliasing (legend names) with pattern replacements
  • Issue #266. Graphite: New option cacheTimeout to override graphite default memcache timeout
  • Issue #606. General: New global option in config.js to specify admin password (useful to hinder users from accidentally make changes)
  • Issue #201. Annotations: Elasticsearch datasource support for events
  • Issue #344. Annotations: Annotations can now be fetched from non default datasources
  • Issue #631. Search: max_results config.js option & scroll in search results (To show more or all dashboards)
  • Issue #511. Text panel: Allow .. filter notation in all text panels (markdown/html/text)
  • Issue #136. Graph: New legend display option "Align as table"
  • Issue #556. Graph: New legend display option "Right side", will show legend to the right of the graph
  • Issue #604. Graph: New axis format, 'bps' (SI unit in steps of 1000) useful for network gear metics
  • Issue #626. Graph: Downscale y axis to more precise unit, value of 0.1 for seconds format will be formated as 100 ms. Thanks @kamaradclimber
  • Issue #618. OpenTSDB: Series alias option to override metric name returned from opentsdb. Thanks @heldr

Documentation

  • Issue #635. Docs for features and changes in v1.7, new troubleshooting guide, new Getting started guide, improved install & config guide.

Changes

  • Issue #536. Graphite: Use unix epoch for Graphite from/to for absolute time ranges
  • Issue #641. General: Dashboard save temp copy feature settings moved from dashboard to config.js, default is enabled, and ttl to 30 days
  • Issue #532. Schema: Dashboard schema changes, "Unsaved changes" should not appear for schema changes. All changes are backward compatible with old schema.

Fixes

  • Issue #545. Graph: Fix formatting negative values (axis formats, legend values)
  • Issue #460. Graph: fix for max legend value when max value is zero
  • Issue #628. Filtering: Fix for nested filters, changing a child filter could result in infinite recursion in some cases
  • Issue #528. Graphite: Fix for graphite expressions parser failure when metric expressions starts with curly brace segment

1.6.1 (2014-06-24)

New features or improvements

  • Issue #360. Ability to set y min/max for right y-axis (RR #519)

Fixes

  • Issue #500. Fixes regex InfluxDB queries intoduced in 1.6.0
  • Issue #506. Bug in when using % sign in legends (aliases), fixed by removing url decoding of metric names
  • Issue #522. Series names and column name typeahead cache fix
  • Issue #504. Fixed influxdb issue with raw query that caused wrong value column detection
  • Issue #526. Default property that marks which datasource is default in config.js is now optional
  • Issue #342. Auto-refresh caused 2 refreshes (and hence mulitple queries) each time (at least in firefox)

1.6.0 (2014-06-16)

New features or improvements

  • Issue #427. New Y-axis formater for metric values that represent seconds, Thanks @jippi
  • Issue #390. Allow special characters in serie names (influxdb datasource), Thanks @majst01
  • Issue #428. Refactoring of filterSrv, Thanks @Tetha
  • Issue #445. New config for playlist feature. Set playlist_timespan to set default playlist interval, Thanks @rmca
  • Issue #461. New graphite function definition added isNonNull, Thanks @tmonk42
  • Issue #455. New InfluxDB function difference add to function dropdown
  • Issue #459. Added parameter to keepLastValue graphite function definition (default 100) Issue #418. to the browser cache when upgrading grafana and improve load performance
  • Issue #327. Partial support for url encoded metrics when using Graphite datasource. Thanks @axe-felix
  • Issue #473. Improvement to InfluxDB query editor and function/value column selection
  • Issue #375. Initial support for filtering (templated queries) for InfluxDB. Thanks @mavimo
  • Issue #475. Row editing and adding new panel is now a lot quicker and easier with the new row menu
  • Issue #211. New datasource! Initial support for OpenTSDB, Thanks @mpage
  • Issue #492. Improvement and polish to the OpenTSDB query editor
  • Issue #441. Influxdb group by support, Thanks @piis3
  • improved asset (css/js) build pipeline, added revision to css and js. Will remove issues related

Changes

  • Issue #475. Add panel icon and Row edit button is replaced by the Row edit menu
  • New graphs now have a default empty query
  • Add Row button now creates a row with default height of 250px (no longer opens dashboard settings modal)
  • Clean up of config.sample.js, graphiteUrl removed (still works, but depricated, removed in future) Use datasources config instead. panel_names removed from config.js. Use plugins.panels to add custom panels
  • Graphite panel is now renamed graph (Existing dashboards will still work)

Fixes

  • Issue #126. Graphite query lexer change, can now handle regex parameters for aliasSub function
  • Issue #447. Filter option loading when having muliple nested filters now works better. Options are now reloaded correctly and there are no multiple renders/refresh inbetween.
  • Issue #412. After a filter option is changed and a nested template param is reloaded, if the current value exists after the options are reloaded the current selected value is kept.
  • Issue #460. Legend Current value did not display when value was zero
  • Issue #328. Fix to series toggling bug that caused annotations to be hidden when toggling/hiding series.
  • Issue #293. Fix for graphite function selection menu that some times draws outside screen. It now displays upward
  • Issue #350. Fix for exclusive series toggling (hold down CTRL, SHIFT or META key) and left click a series for exclusive toggling
  • Issue #472. CTRL does not work on MAC OSX but SHIFT or META should (depending on browser)

1.5.4 (2014-05-13)

New features and improvements

  • InfluxDB enhancement: support for multiple hosts (with retries) and raw queries (Issue #318, thx @toddboom)
  • Added rounding for graphites from and to time range filters for very short absolute ranges (Issue #320)
  • Increased resolution for graphite datapoints (maxDataPoints), now equal to panel pixel width. (Issue #5)
  • Improvement to influxdb query editor, can now add where clause and alias (Issue #331, thanks @mavimo)
  • New config setting for graphite datasource to control if json render request is POST or GET (Issue #345)
  • Unsaved changes warning feature (Issue #324)
  • Improvement to series toggling, CTRL+MouseClick on series name will now hide all others (Issue #350)

Changes

  • Graph default setting for Y-Min changed from zero to auto scalling (will not effect existing dashboards). (Issue #386) - thx @kamaradclimber

Fixes

  • Fixes to filters and "All" option. It now never uses "*" as value, but all options in a {node1, node2, node3} expression (Issue #228, #359)
  • Fix for InfluxDB query generation with columns containing dots or dashes (Issue #369, #348) - Thanks to @jbripley

1.5.3 (2014-04-17)

  • Add support for async scripted dashboards (Issue #274)
  • Text panel now accepts html (for links to other dashboards, etc) (Issue #236)
  • Fix for Text panel, now changes take effect directly (Issue #251)
  • Fix when adding functions without params that did not cause graph to update (Issue #267)
  • Graphite errors are now much easier to see and troubleshoot with the new inspector (Issue #265)
  • Use influxdb aliases to distinguish between multiple columns (Issue #283)
  • Correction to ms axis formater, now formats days correctly. (Issue #189)
  • Css fix for Firefox and using top menu dropdowns in panel fullscren / edit mode (Issue #106)
  • Browser page title is now Grafana - {{dashboard title}} (Issue #294)
  • Disable auto refresh zooming in (every time you change to an absolute time range), refresh will be restored when you change time range back to relative (Issue #282)
  • More graphite functions

1.5.2 (2014-03-24)

New Features and improvements

  • Support for second optional params for functions like aliasByNode (Issue #167). Read the wiki on the Function Editor for more info.
  • More functions added to InfluxDB query editor (Issue #218)
  • Filters can now be used inside other filters (templated segments) (Issue #128)
  • More graphite functions added

Fixes

  • Float arguments now work for functions like scale (Issue #223)
  • Fix for graphite function editor, the graph & target was not updated after adding a function and leaving default params as is #191

The zip files now contains a sub folder with project name and version prefix. (Issue #209)

1.5.1 (2014-03-10)

Fixes

  • maxDataPoints must be an integer #184 (thanks @frejsoya for fixing this)

For people who are find Grafana slow for large time spans or high resolution metrics. This is most likely due to graphite returning a large number of datapoints. The maxDataPoints parameter solves this issue. For maxDataPoints to work you need to run the latest graphite-web (some builds of 0.9.12 does not include this feature).

Read this for more info: Performance for large time spans

1.5.0 (2014-03-09)

New Features and improvements

Fixes

1.4.0 (2014-02-21)

New Features

  • #44 Annotations! Required a lot of work to get right. Read wiki article for more info. Supported annotations data sources are graphite metrics and graphite events. Support for more will be added in the future!
  • #35 Support for multiple graphite servers! (Read wiki article for more)
  • #116 Back to dashboard link in top menu to easily exist full screen / edit mode.
  • #114, #97 Legend values now use the same y axes formatter
  • #77 Improvements and polish to the light theme

Changes

  • #98 Stack is no longer by default turned on in graph display settings.
  • Hide controls (Ctrl+h) now hides the sub menu row (where filtering, and annotations are). So if you had filtering enabled and hide controls enabled you will not see the filtering sub menu.

Fixes:

  • #94 Fix for bug that caused dashboard settings to sometimes not contain timepicker tab.
  • #110 Graph with many many metrics caused legend to push down graph editor below screen. You can now scroll in edit mode & full screen mode for graphs with lots of series & legends.
  • #104 Improvement to graphite target editor, select wildcard now gives you a "select metric" link for the next node.
  • #105 Added zero as a possible node value in groupByAlias function

1.3.0 (2014-02-13)

New features or improvements

  • #86 Dashboard tags and search (see wiki article for details)
  • #54 Enhancement to filter / template. "Include All" improvement
  • #82 Dashboard search result sorted in alphabetical order

Fixes

  • #91 Custom date selector is one day behind
  • #89 Filter / template does not work after switching dashboard
  • #88 Closed / Minimized row css bug
  • #85 Added all parameters to summarize function
  • #83 Stack as percent should now work a lot better!

1.2.0 (2014-02-10)

New features

  • #70 Grid Thresholds (warning and error regions or lines in graph)
  • #72 Added an example of a scripted dashboard and a short wiki article documenting scripted dashboards.

Fixes

  • #81 Grid min/max values are ignored bug
  • #80 "stacked as percent" graphs should always use "max" value of 100 bug
  • #73 Left Y format change did not work
  • #42 Fixes to grid min/max auto scaling
  • #69 Fixes to lexer/parser for metrics segments like "10-20".
  • #67 Allow decimal input for scale function
  • #68 Bug when trying to open dashboard while in edit mode

1.1.0 (2014-02-06)

New features:

  • #22 Support for native graphite png renderer, does not support click and select zoom yet
  • #60 Support for legend values (cactiStyle, min, max, current, total, avg). The options for these are found in the new "Axes & Grid" tab for now.
  • #62 There is now a "New" button in the search/open dashboard view to quickly open a clean empty dashboard.
  • #55 Basic auth is now supported for elastic search as well
  • some new function definitions added (will focus more on this for next release).

Fixes

  • #45 zero values from graphite was handled as null.
  • #63 Kibana / Grafana on same host would use same localStorage keys, now fixed
  • #46 Impossible to edit graph without a name fixed.
  • #24 fix for dashboard search when elastic search is configured to disable _all field.
  • #38 Improvement to lexer / parser to support pure numeric literals in metric segments

Thanks to everyone who contributed fixes and provided feedback 👍

1.0.4 (2014-01-24)

  • Issue #28 - Relative time range caused 500 graphite error in some cases (thx rsommer for the fix)

1.0.3 (2014-01-23)

1.0.2 (2014-01-21)

  • Issue #12, should now work ok without ElasticSearch

1.0.1 (2014-01-21)

  • Resize fix
  • Improvements to drag & drop
  • Added a few graphite function definitions
  • Fixed duplicate panel bug
  • Updated default dashboard with welcome message and randomWalk graph

1.0.0 (2014-01-19)

First public release