Important: This documentation is about an older version. It's relevant only to the release noted, many of the features and functions have been updated or replaced. Please view the current version.
Release notes for Grafana 8.2.0-beta1
Features and enhancements
- AccessControl: Introduce new permissions to restrict access for reloading provisioning configuration. #38906, @vtorosyan
- Alerting: Add UI to edit Cortex/Loki namespace, group names, and group evaluation interval. #38543, @domasx2
- Alerting: Add a Test button to test contact point. #37475, @domasx2
- Alerting: Allow creating/editing recording rules for Loki and Cortex. #38064, @domasx2
- Alerting: Sort notification channels by name to make them easier to locate. #37426, @jstangroome
- AzureMonitor: Add data links to deep link to Azure Portal Azure Resource Graph. #35591, @shuotli
- AzureMonitor: Add support for annotations from Azure Monitor Metrics and Azure Resource Graph services. #37633, @joshhunt
- AzureMonitor: Show error message when subscriptions request fails in ConfigEditor. #37837, @joshhunt
- Chore: Update to Golang 1.16.7. #38604, @dsotirakis
- CloudWatch Logs: Add link to X-Ray data source for trace IDs in logs. #39135, @aocenas
- CloudWatch Logs: Disable query path using websockets (Live) feature. #39231, @aocenas
- CloudWatch/Logs: Don’t group dataframes for non time series queries. #37998, @aocenas
- Cloudwatch: Migrate queries that use multiple stats to one query per stat. #36925, @sunker
- Dashboard: Keep live timeseries moving left (v2). #37769, @ryantxu
- Datasources: Introduce
response_limit
for datasource responses. #38962, @dsotirakis - Explore: Add filter by trace or span ID to
trace to logs
feature. #38943, @connorlindsey - Explore: Download traces as JSON in Explore Inspector. #38614, @connorlindsey
- Explore: Reuse Dashboard’s QueryRows component. #38942, @Elfo404
- Explore: Support custom display label for derived fields buttons for Loki datasource. #37273, @connorlindsey
- Grafana UI: Update monaco-related dependencies. #39027, @gabor
- Graphite: Deprecate browser access mode. #38783, @ifrost
- InfluxDB: Improve handling of intervals in alerting. #37588, @gabor
- InfluxDB: InfluxQL query editor: Handle unusual characters in tag values better. #39170, @gabor
- Jaeger: Add ability to upload JSON file for trace data. #37205, @zoltanbedi
- LibraryElements: Enable specifying UID for new and existing library elements. #39019, @hugohaggmark
- LibraryPanels: Remove library panel icon from the panel header so you can no longer tell that a panel is a library panel from the dashboard view. #38749, @hugohaggmark
- Logs panel: Scroll to the bottom on page refresh when sorting in ascending order. #37634, @ivanahuckova
- Loki: Add fuzzy search to label browser. #36864, @connorlindsey
- Navigation: Implement active state for items in the Sidemenu. #39030, @ashharrison90
- Packaging: Add stricter systemd unit options. #38109, @erdnaxe
- Packaging: Update PID file location from
/var/run
to/run
. #35739, @MichaIng - Plugins: Add Hide OAuth Forward config option. #36306, @wbrowne
- Postgres/MySQL/MSSQL: Add setting to limit the maximum number of rows processed. #38986, @marefr
- Prometheus: Add browser access mode deprecation warning. #37578, @ivanahuckova
- Prometheus: Add interpolation for built-in-time variables to backend. #39051, @ivanahuckova
- Tempo: Add ability to upload trace data in JSON format. #37407, @zoltanbedi
- TimeSeries/XYChart: Allow grid lines visibility control in XYChart and TimeSeries panels. #38502, @dprokop
- Transformations: Convert field types to time string number or boolean. #38517, @nikki-kiga
- Value mappings: Add regular-expression based value mapping. #38931, @mcdee
- Zipkin: Add ability to upload trace JSON. #37483, @zoltanbedi
Bug fixes
- Admin: Prevent user from deleting user’s current/active organization. #38056, @idafurjes
- LibraryPanels: Fix library panel getting saved in the dashboard’s folder. #38978, @hugohaggmark
- OAuth: Make generic teams URL and JMES path configurable. #37233, @djairhogeuens
- QueryEditor: Fix broken copy-paste for mouse middle-click (#39117). #39117, @glintik
- Thresholds: Fix undefined color in “Add threshold”. #39113, @glintik
- Timeseries: Add wide-to-long, and fix multi-frame output. #38670, @ryantxu
- TooltipPlugin: Fix behavior of Shared Crosshair when Tooltip is set to All. #37285, @nikki-kiga
Breaking changes
The monaco-editor
dependency in grafana-ui
has been updated to a newer version (0.27.0
), which is not completely backward compatible with the old version (0.21.2
). The backward incompatible changes are fairly small, but they do exist, so if your code accesses the raw monaco-objects through the grafana-ui
package, please check the monaco-editor changelog and apply any necessary changes. Issue #39027
The mandatory css
prop in grafana/ui
components has been removed.
Previous versions of grafana/ui
components were typed incorrectly due to a dependency mismatch between emotion 10 and 11 causing a css
prop to be added to components that extended react types.
Issue #38078
Panel queries and/or annotation queries that used more than one statistic will be converted into one query/annotation per statistic. In case an alerting rule was based on a query row that had more than one statistic, it would now be based only on the first statistic for that query row. New alerting rules will not be created for migrated queries. Please note that in most cases it would not make sense to have an alerting rule that is based on multiple statistics anyway. Issue #36925
Deprecations
getHighlighterExpressions
in datasource APIs ( used to highlight logs while editing queries) has been deprecated and will be removed in a future release.
Deprecation notice
ExploreQueryFieldProps
interface for query editors has been deprecated and will be removed in a future release. Use QueryEditorProps
instead. Issue #38942
Plugin development fixes & changes
Grafana 8 alerts fixes
- Organisation level isolation: The fix for organization level isolation introduced a new migration flow that deletes all Grafana 8 alerting data and migrates the dashboard alerts to the new system again so that an Alertmanager configuration is created properly for each organization. It removes any manually created (or modified) Grafana 8 alerts or Alertmanager configuration after upgrading.