Project: Grafana (Observability and Analysis / Observability)
File: whats-new-in-v8-1.md

_build: list: false aliases: ../guides/whats-new-in-v8-1/ description: Learn about new and updated features in Grafana v8.1 keywords: grafana new documentation '8.1' release notes labels: products: cloud enterprise oss title: What's new in Grafana v8.1 weight: -33 Note: This topic will be updated frequently between now and the final release. Grafana 8.1 builds upon our promise of a composable, open observability platform with new panels and extends functionality launched in Grafana 8.0. Weve got new Geomap and Annotations panels, and some great updates to the Time Series panel. Weve also got new transformations and updates to data sources. For our enterprise customers, there are additions to fine grained access control, updates to the reporting schedule and query caching, and more. Read on to learn more. In addition to what is summarized here, you might also be interested in our announcement blog post. For all the technical details, check out the complete . These features are included in the Grafana open source edition. Grafana 8.1 introduces the foundation for our new map panel. This new panel leverages and gives us a flexible solution for extending the way we use the new Geomap panel moving forward. The new Geomap panel includes multiple base layer styles (map layer options), as well as a more open data layer. The data layer can use coordinates and geo-hashed data in addition to a lookup table. The Geomap panel is also able to share views across multiple Geomap panels on the same dashboard, making it straightforward to visualize and explore multiple types of geospatial data using the same map zoom and focus settings. For more information, refer to . {{< figure src="/static/img/docs/geomap-panel/geomapwithheatmap.png" max-width="850px" caption="Geomap panel: Heatmap" >}} The new Annotations panel shows a list of available annotations you can use to create lists of annotated data available within your organization. Various options are available to filter the list based on the tags and on the current dashboard. This panel makes it easy to find and filter annotated data within and across multiple dashboards. {{< figure src="/static/img/docs/annotations-panel/annolist.png" max-width="900px" caption="Annotations panel" >}} The time series panel has been updated with the ability to color series and line by thresholds or gradient color scales. This allows users to create panels where the line color can change dynamically based on thresholds or using gradient color scales. It adds a layer of visibility to your data, making it easier to view the changes across thresholds at a glance quickly. Color scheme From thresholds: {{< figure src="/static/img/docs/time-series-panel/gradientmodeschemethresholdsline.png" max-width="1200px" caption="Colors scheme: From thresholds" >}} Color scheme: Green-Yellow-Red (by value) {{< figure src="/static/img/docs/time-series-panel/gradientmodescheme_line.png" max-width="1200px" caption="Color scheme: Green-Yellow-Red" >}} For more on how to configure Graphs with by value color schemes read . You can also create annotations in the new Time series panel bringing it closer to parity with the legacy Graph panel. To learn more, refer to the . Grafana 8.1 includes some significant enhancements to transformations, including two new transformations designed around providing dynamic configuration to your panels and visualizations. This transformation enables panel config (Threshold, Min, Max, etc.) to be derived from query results. For more information, refer to

This transformation enables rows in returned data to be converted into separate fields. Prior to this enhancement, you could style and configure fields individually, but not rows. For more information, refer to [Rows to fields transform]. Example, Input: | Name | Value | Max | | - | -- | | | ServerA | 10 | 100 | | ServerB | 20 | 200 | | ServerC | 30 | 300 | Output: | ServerA (config: max=100) | ServerB (config: max=200) | ServerC (config: max=300) | | - | - | - | | 10 | 20 | 30 | As you can see each row in the source data becomes a separate field. Each field now also has a max config option set. Options like Min, Max, Unit and Thresholds are all part of field configuration and if set like this will be used by the visualization instead of any options manually configured in the panel editor options pane. For more on how to use this transformation, refer to . Additional inline help will be available for Transformations. We can now share examples of how to use specific transformations and point users directly to the appropriate place in the docs for more information. The following data source updates are included with this Grafana release. We have added timezone support. As a result, you can now specify the time zone used in the database session, such as `Europe/Berlin` or `+02:00`. We changed the default behavior from creating a 1-hour span Loki query to the only query at the exact time the trace span started for the duration of it. For more fine grained control over this, you can shift this time in the tracing data source settings. Also, it is now possible to shift the start time and end time of the Loki query by the set amount. For more information, refer to . Added the ability to format JSON to make it easier to view, review and find relevant data in JSON format logs. This is a regular JSON log. {{< figure src="/static/img/docs/panels/pretty-json/regular-log-line.png" max-width="1200px" caption="Regular log line" >}} And here is the prettified JSON log. {{< figure src="/static/img/docs/panels/pretty-json/prettified-json.png" max-width="1200px" caption="Prettified JSON" >}} For more on how to prettify JSON logs, refer to and options. Weve made some changes to the plugins UI to help make it easier to discover and manage your plugins. Enterprise users can now also manage enterprise plugins from within the catalog. New panel summaries and preview on the top level page to help users pick or learn about specific visualizations more easily. The `@grafana/ui` exposes a `Select` component, and its variants `MultiSelect`, `AsyncSelect`, and `AsyncMultiSelect`. We have made some internal changes to these components to make the behavior and positioning more consistent in all scenarios. To test the changes, you can use the `menuShouldPortal` property: ```jsx <Select menuShouldPortal {...otherProps} /> ``` Tests are most likely to be affected. There are some tips for fixing these in the original pull request at

Wed love as much feedback as possible about this change, because we are considering making this the default behavior in a future release of Grafana. We have added an experimental HA setup support for Grafana Live with Redis. This resolves the limitation when clients were connected to different Grafana instances and those instances had no shared state. For additional information, refer to . These features are included in the Grafana Enterprise edition. Role-based access control remains in beta. You can now grant or revoke permissions for Viewers, Editors, or Admins to use Explore mode, configure LDAP or SAML settings, or view the admin/stats page. These new permissions enhance the existing permissions that can be customized, namely permissions to access Users, Orgs, LDAP settings, and Reports in Grafana. Fine grained access control allows you to customize roles and permissions in Grafana beyond the built-in Viewer, Editor, and Admin roles. As of 8.1, you can modify some of the permissions for any of these built-in roles. This is helpful if youd like users to have more or fewer access permissions than a given role allows for by default. For an overview of role-based access control and a complete list of available permissions, refer to the documentation. Weve enhanced the scheduler for Reports to be more flexible, so you can send reports at just the right time. When scheduling a report, you can now choose to send a report at custom intervals such as every 4 hours or every 2 weeks. You can also send a report for a limited time period by providing a start and end date, or send a report only on weekdays or on the last day of each month. This change accompanies some other recent improvements to Reporting, like the ability to choose template variables for reports and an improved UX for authoring reports. To learn more, refer to the documentation. Query caching was released in Grafana 8.0 and allows you to temporarily store the results of data source queries in a cache, so that Grafana reads repeated queries from there instead of from the data source itself. This reduces load on data sources, improves dashboard load times, and can save money for data sources that charge per query. To learn more about query caching see its page. To find out how to turn on encryption, refer to the documentation. You can now encrypt the query data cached by Grafana. This improves the security of query data, especially when your cache (like Redis) is shared with other services. You can now customize Grafanas loading logo, which displays while Grafana is loading in a users browser. White labeling in Grafana Enterprise allows you to customize the look and feel of Grafana to match your products or companys brand. This makes Grafana a more integrated part of your observability stack and keep Grafana consistent with other visualizations displayed in public. To find out how you can configure it along with other Grafana UI elements, like the corner logo and application footer, refer to the topic of the Grafana Enterprise docs. With Team Sync you can map your Generic OAuth groups to teams in Grafana so that the users are automatically added to the correct teams.