Differences between Grafana versions - Amazon Managed Grafana

Differences between Grafana versions

When creating a Grafana workspace, you must choose a Grafana version to create. You can choose between versions compatible with Grafana versions 8, 9, and 10. Each of these has added functionality from the previous version. The following topics describe the changes in versions 9 and 10, including changes in version 10 that might break functionality that you use in version 9.

Note

You can read version-specific documentation for using your Grafana workspace in the Working in Grafana version 8, Working in Grafana version 9, and Working in Grafana version 10 topics.

For detailed notes by version, and more information from Grafana Labs, see What's new in Grafana in the Grafana Labs documentation.

Grafana version 10

The following features were added in Grafana version 10.

  • Correlations – Correlations define how data in one data source is used to query data in another data source, and allow the Explore visualization to easily run queries related to the shown data. For more details, see Correlations in Grafana version 10.

  • Subfolders – When organizing your dashboards, you can now use subfolders to create a nested hierarchy. For more details, see Creating dashboard folders.

  • Alerting upgrade preview – Before upgrading from classic dashboard alerts to Grafana alerts, you can see what your alerts will look like, and even make changes that are applied when migrating. For more details, see Migrating classic dashboard alerts to Grafana alerting.

  • Support bundles – Support bundles provide a simple way to collect information about your Grafana workspace to share with product support. You can quickly create a support bundle containing data about migrations, plugins, settings, and more. For more details, see Gather information for support.

  • New visualizations – Three new visualizations are available. XY Chart, Datagrid, and Trend panel are all available for workspaces compatible with version 10. Version 9 workspaces can also use XY Charts.

  • PagerDuty – The Enterprise plugins now include a plugin for PagerDuty.

  • Transformations redesign – The transformations tab has an improved user experience and visual design. Transformations are categorized, and each transformation type has an illustration to help you choose the right one.

  • Prometheus metric encyclopedia – The metrics dropdown for Prometheus metrics in the Prometheus query builder has been replaced with a paginated and searchable metric encyclopedia.

  • API key UI deprecationService accounts are the recommended way to authenticate calls to the Grafana HTTP APIs. As part of Grafana Labs work toward deprecating API keys, you can no longer create API keys through the workspace user interface. You can only create API keys through the AWS APIs.

    For more information about the deprecation of API keys by Grafana Labs, see APIKeys: Sunsetting of API keys in the Grafana GitHub issues list.

Breaking changes

The Grafana version 10.4 release includes changes from Grafana versions 9.5 through 10.4. Grafana versions 10.0 and 10.3 had some changes that might break functionality in some cases. When updating to a new version, it is recommended to test in a non-production environment before updating your production workspaces.

The following changes might affect some users updating to Grafana version 10.

  • Angular deprecated – Plugins that use Angular will no longer be supported in future releases of Grafana. In version 10, panels that use angular will show a banner stating that they use a deprecated feature, to give a notice that they won't work in future versions.

  • Alias in CloudWatch removed – Alias patterns in the CloudWatch query editor were replaced by Label (dynamic labels).

    Open any dashboard that uses the Alias field, and save it. Alias is migrated to Label automatically.

  • Older plugins need to be upgraded – The plugins for Athena and Amazon Redshift data source must be updated in Grafana v10 workspaces. The Athena data source plugin must be version 2.9.3 or newer; the Amazon Redshift data source plugin must be version 1.8.3 or newer.

    For information on installing or upgrading plugins, see Find plugins with the plugin catalog.

  • DoiT BigQuery plugin no longer supported – The DoiT BigQuery data source plugin is no longer supported. Use the official Grafana Labs BigQuery data source plugin instead.

  • Transformation changes – Grafana version 10 has made a few bug fix changes to field names and keys. For full details, see Transformation breaking changes in the Grafana Labs documentation.

  • Data source permissions APIs – The endpoints for accessing data source permissions have changed. For full details, see Data source permissions changes in the Grafana Labs documentation.

For more details on breaking changes, and changes that affect plugin developers, see the following topics in the Grafana Labs documentation:

Grafana version 9

The following features were added in Grafana v9.

  • Alerting: Grafana-managed alert rules now supports group names.

  • Explore: Create a dashboard from within Explore view.

  • Prometheus queries: A new query builder for Prometheus queries (using PromQL) makes writing queries easier.

  • Loki queries: A new query builder for Loki queries (using LogQL) makes writing queries easier.

  • API tokens / Service accounts: Service accounts simplify machine access in Grafana, helping you to manage API tokens.

  • Plugin management: You can enable plugin management to install, remove, or update community plugins in your workspace. This gives you access to more data sources and visualizations, and gives you control over the version of each plugin that you use.

  • Trace to metrics: Configure a tracing data source to add links to metrics with queries and tags.

  • Canvas panel: A new panel visualization with static and dynamic elements to create data-driven, custom panels with images and overlain text.

  • Reorganized interface: Updated UI with easier navigation in the Grafana console.

  • CloudWatch: The Amazon CloudWatch data source can now monitor metrics across AWS accounts and across AWS Regions.

  • Logs: The interface for log details has been improved.

  • General: Bug fixes and minor improvements throughout.