AWS grafana documentation change
Summary
Updated version differences documentation to include Grafana version 12, detailing new features, breaking changes, and updates. Includes security-related changes such as API key migration to service accounts and authentication improvements.
Security assessment
The update adds a new section for Grafana version 12 which includes an 'Authentication and security' subsection and breaking changes related to API key removal. These changes are security enhancements and best practices, but there is no mention of a specific security vulnerability or incident being addressed.
Diff
diff --git a/grafana/latest/userguide/version-differences.md b/grafana/latest/userguide/version-differences.md index 8a50c6477..37d4b200e 100644 --- a//grafana/latest/userguide/version-differences.md +++ b//grafana/latest/userguide/version-differences.md @@ -0,0 +1,2 @@ +[View a markdown version of this page](version-differences.md) + @@ -5 +7 @@ -Grafana version 10Grafana version 9 +Grafana version 12Grafana version 10Grafana version 9 @@ -9 +11 @@ Grafana version 10Grafana version 9 -When [creating a Grafana workspace](./AMG-create-workspace.html), 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. +When [creating a Grafana workspace](./AMG-create-workspace.html), you must choose a Grafana version to create. You can choose between versions compatible with Grafana versions 8, 9, 10, and 12. Each of these has added functionality from the previous version. The following topics describe the changes in versions 9, 10, and 12, including changes that might break functionality that you use in previous versions. @@ -13 +15 @@ When [creating a Grafana workspace](./AMG-create-workspace.html), you must choos -You can read version-specific documentation for using your Grafana workspace in the [Working in Grafana version 8](./using-grafana-v8.html), [Working in Grafana version 9](./using-grafana-v9.html), and [Working in Grafana version 10](./using-grafana-v10.html) topics. +You can read version-specific documentation for using your Grafana workspace in the [Working in Grafana version 12](./using-grafana-v12.html), [Working in Grafana version 10](./using-grafana-v10.html), [Working in Grafana version 9](./using-grafana-v9.html), and [Working in Grafana version 8](./using-grafana-v8.html) topics. @@ -16,0 +19,261 @@ For detailed notes by version, and more information from Grafana Labs, see [What +## Grafana version 12 + +The following features were added in Grafana version 12. + +###### Drilldown apps + + * **Metrics Drilldown** – A queryless, point-and-click experience for exploring Prometheus metric data. See [Metrics Drilldown](./v12-drilldown-metrics.html). + + * **Logs Drilldown** – A queryless experience for browsing Loki logs with volume and text patterns. See [Logs Drilldown](./v12-drilldown-logs.html). + + * **Traces Drilldown** – A queryless experience for exploring distributed Tempo traces. See [Traces Drilldown](./v12-drilldown-traces.html). + + * **Profiles Drilldown** – A queryless experience for browsing Pyroscope profiling data. See [Profiles Drilldown](./v12-drilldown-profiles.html). + + + + +###### Dashboards and visualizations + + * **Scenes-powered dashboards** – The dashboard rendering engine has been rebuilt using the Scenes framework, providing improved performance, better template variable support, and more flexible layouts. + + * **New table visualization** – The table panel has been completely rebuilt for improved performance and new capabilities, including CSS cell styling, tooltip generation from table fields, an improved footer, a new Actions cell type for interactive buttons, and auto-formatted cell values in Cell Inspect. + + * **Canvas visualization improvements** – Canvas panels now support one-click data links and actions, dynamic connection directions, the ability to disable tooltips, and pan and zoom improvements, giving you more control over interactive data-driven layouts. + + * **Visualization actions** – You can now add interactive actions to visualizations that trigger API calls or navigate to URLs, with support for custom variables, one-click data links, and a new Actions cell type for table visualizations. + + * **Colored table rows with conditional formatting** – Table visualizations now support row-level conditional formatting, allowing you to color entire rows based on data values. + + * **Stat visualization percent change** – Stat panels now display percent change with configurable color mode options, making it easier to see trends at a glance. + + * **Legend support in bar gauge** – Bar gauge visualizations now support legends, improving readability when displaying multiple series. + + * **State timeline pagination** – State timeline visualizations now support pagination, making it easier to navigate large datasets. + + * **Redesigned dashboard filters** – Dashboard list filters have been redesigned for a more intuitive browsing experience. + + * **Switch variable type** – A new Switch variable type lets you quickly toggle between values in queries, simplifying dashboard interactions. + + * **Static options for query variables** – Query variables now support static options, giving you more control over variable values without requiring a data source query. + + * **Enhanced ad hoc filters** – Ad hoc filters now provide improved support across data sources, making it easier to dynamically filter dashboard data. + + * **Better time region control with Cron syntax** – Annotations now support Cron syntax for time regions, providing more precise control over time-based annotations. + + * **Improved geomap performance** – Geomap visualizations now render significantly faster with improved performance optimizations. + + * **Navigation bookmarks** – You can now bookmark frequently used pages in the navigation menu for quick access. + + * **Set threshold colors from query** – The Config from query transformation now supports setting threshold colors dynamically based on query results. + + * **Enhanced custom currency format** – A new custom currency format option lets you display exact financial values with precise decimal control. + + * **Server-configurable quick time ranges** – Administrators can now configure the quick time range options available in dashboard time pickers. + + * **Announcement banner** – Administrators can now display announcement banners to communicate important information to workspace users. + + + + +###### Transformations + + * **Substring matcher in Filter by value** – The Filter by value transformation now includes a substring matcher, making it easier to filter data based on partial text matches. + + * **Trendline transformation** – A new Trendline transformation lets you spot patterns in your data by adding trend lines and moving averages to visualizations. + + * **Binary transformation for all number fields** – You can now apply the same binary transformation to all number fields in a table at once, reducing repetitive configuration. + + * **New regex option for Extract fields** – The Extract fields transformation now supports regular expressions, providing more powerful field extraction from text data. + + * **Transformation updates** – Multiple transformation improvements have been added, including new modes and usability enhancements across the transformation pipeline. + + * **Dashboard variables in all transformations** – Dashboard variables are now supported in all transformation types, expanding the flexibility of data processing pipelines. + + + + +###### Alerting + + * **Keep Last State for Grafana Managed Alerting** – Alert rules can now be configured to keep their last state when a query returns no data or an error, preventing unnecessary alert state changes. + + * **Alert detail view redesign** – The alert rule detail view has been redesigned with a clearer layout and more actionable information. + + * **Alerting template selector** – A new template selector in the alerting UI makes it easier to choose and apply notification templates. + + * **Improved paused alert visibility** – Paused alert rules are now more clearly indicated in the UI, making it easier to identify which rules are not actively evaluating. + + * **Only available for Grafana-managed alerts: rule-specific silences** – You can now create silences that apply to specific alert rules with granular permissions, providing more targeted alert suppression. + + * **Recording rules for Grafana-managed alerts** – Recording rules are now available for Grafana-managed alerts, allowing you to precompute frequently used queries for better performance. This replaces the deprecated recorded queries feature. See [Configure recording rules](./v12-alerting-configure-recordingrules.html). + + * **Alert rule version history** – Alert rules now maintain a version history, allowing you to track changes and revert to previous configurations. + + * **Grafana-managed alert rule "Recovering" state** – Alert rules now support a "Recovering" state that indicates when an alert condition is no longer firing but has not yet returned to normal. + + * **Alert rule improvements** – Grafana-managed alert rules include multiple usability improvements, including updated list pages, active time intervals, the ability to import rules from Prometheus YAML, and a redesigned settings page. + + + + +###### Explore and logs + + * **New logs visualization** – A new logs visualization panel provides improved log rendering with a new field selector component for customizing which fields are displayed. + + * **JSON Log Line Viewer** – The Logs Drilldown app now includes a JSON viewer for structured log lines, making it easier to inspect JSON-formatted log data. + + * **Forward direction search for Loki** – Loki queries in Explore now support forward direction search, allowing you to search logs from oldest to newest. + + * **Correlations in Explore** – You can now add correlations to external URLs directly from Explore, enabling seamless navigation between data sources and external systems. See [Correlations in Grafana version 12](./v12-correlations.html). + + + + +###### Data sources + + * **Amazon Managed Service for Prometheus data source migration** – Starting with this release, Sigv4 authentication support in the Core Prometheus plugin has been deprecated. When you upgrade to Grafana version 12, all Amazon Managed Service for Prometheus data sources that were previously using the Core Prometheus plugin are automatically migrated to the Amazon Managed Service for Prometheus plugin. Any dashboards using these data sources are automatically updated to reflect this change. + + * **Amazon CloudWatch Logs Insights with PPL and SQL** – You can now query Amazon CloudWatch Logs Insights using PPL (Piped Processing Language) and SQL syntax in addition to the standard query language. + + * **Amazon CloudWatch Metric Insights cross-account support** – Amazon CloudWatch Metric Insights now supports cross-account observability, allowing you to query metrics across multiple AWS accounts. + + * **Amazon CloudWatch Logs Anomaly Detection and Pattern Analysis** – The Amazon CloudWatch data source now supports log anomaly detection and pattern analysis for identifying unusual patterns in your log data. + + * **OpenSearch PPL and Sample Queries** – The OpenSearch data source now supports PPL language and sample queries for easier query building. + + * **MSSQL Windows Active Directory authentication** – The Microsoft SQL Server data source now supports Windows Active Directory (Kerberos) authentication. + + * **Removal of old Tempo and Loki Search** – The legacy Tempo Search and Loki Search interfaces have been removed in favor of the TraceQL-powered search experience. + + * **BigQuery Service Account Impersonation** – The BigQuery data source now supports service account impersonation for more flexible authentication. + + * **Google Sheets template variables** – The Google Sheets data source now supports template variables for dynamic data queries. + + * **Time series macro support for SQL data sources** – The visual query builder for SQL data sources now supports time series macros, simplifying time-based queries. + + * **Unity Catalog support in Databricks** – The Grafana Databricks plugin now supports Unity Catalog for unified data governance. + + * **Honeycomb raw query support** – The Honeycomb data source now supports raw queries for advanced query capabilities. + + * **GitHub App authentication** – The GitHub data source now supports GitHub App authentication as an alternative to personal access tokens. + + + + +###### Authentication and security + + * **API keys migrated to service accounts** – API keys have been fully deprecated and automatically migrated to service accounts, providing improved security and management capabilities. See [Using service accounts](./v12-authenticating-grafana-apis.html#v12-service-accounts). + + * **OAuth and SAML session handling improvements** – Session handling for OAuth and SAML authentication providers has been improved for better reliability and security. + + * **Entra Workload Identity support** – Grafana now supports Microsoft Entra Workload Identity for authentication in Azure environments. + + * **OAuth2 for Alertmanager and Mimir** – You can now configure OAuth2 authentication in HTTP settings for vanilla Alertmanager and Mimir data sources. + + + + +###### Accessibility + + * **GeoMap keyboard support** – GeoMap visualizations now support keyboard navigation for improved accessibility. + + * **Panel shortcut keyboard support** – Dashboard panels now support keyboard shortcuts for common actions. + + * **Heading and reduced motion improvements** – Heading structure has been improved for screen readers, and reduced motion support has been added for users who prefer minimal animation. + + + + +**Breaking changes** + +###### Important + +**Legacy alerting is entirely removed** – Legacy alerting is completely removed in Amazon Managed Grafana v12, and workspaces with legacy alerting settings will fail to start. You must migrate from legacy alerting to Grafana Alerting before upgrading to v12. See [Migrating classic dashboard alerts to Grafana alerting](./v10-alerting-use-grafana-alerts.html) and [Classic dashboard alerts](./old-alerts-overview.html). + +###### Important + +**AngularJS support is removed** – AngularJS support is completely removed in Amazon Managed Grafana v12, so Angular-based plugins will not load and dashboards using them will display errors. You must migrate all Angular-based plugins to React alternatives before upgrading. See [Find plugins with the plugin catalog](./grafana-plugins.html#plugin-catalog) for managing plugins in your workspace. + +###### Important + +**API keys are removed** – API keys are fully removed in Amazon Managed Grafana v12 in favor of service accounts, and existing API keys will no longer function. You must create service accounts to replace all API keys and update automation to use service account tokens before upgrading. See [Using service accounts](./v12-authenticating-grafana-apis.html#v12-service-accounts). + +###### Important