From 01e6d1c977bae5a3d3964138ea60cd9b9ffd1d59 Mon Sep 17 00:00:00 2001 From: Jack Baldry Date: Wed, 29 Nov 2023 14:34:10 +0000 Subject: [PATCH] [v10.2.x] Update in repository guidance for contributing to What's new in Grafana Cloud (#78788) Update in repository guidance for contributing to What's new in Grafana Cloud (#78731) (cherry picked from commit ea54d679fd3e6b69376782abf290a8503c74c79f) Signed-off-by: Jack Baldry --- .../sources/whatsnew/whats-new-next/README.md | 87 +--- docs/sources/whatsnew/whats-new-next/index.md | 397 ------------------ 2 files changed, 2 insertions(+), 482 deletions(-) delete mode 100644 docs/sources/whatsnew/whats-new-next/index.md diff --git a/docs/sources/whatsnew/whats-new-next/README.md b/docs/sources/whatsnew/whats-new-next/README.md index 2fbaf560b8e..8ce45f6906c 100644 --- a/docs/sources/whatsnew/whats-new-next/README.md +++ b/docs/sources/whatsnew/whats-new-next/README.md @@ -1,86 +1,3 @@ -# Contribute to 'What's New in Grafana Cloud' +# Contribute to 'What's new in Grafana Cloud' -To have a feature presented in [What's New in Grafana Cloud](https://grafana.com/docs/grafana-cloud/whatsnew/), add an entry to the [`index.md`](./index.md) file in this directory. - -Use the following template, replace any `` with the appropriate text (explained after the template): - -```markdown -## - - - - - - -_Available in in Grafana _ - - -``` - -## _`CONTRIBUTOR`_ - -The name of the contributor of the feature. -The information is intentionally commented out so that it isn't displayed in the published page. - -## _`ON-PREMISE OFFERING`_ - -One or both of: - -- OSS -- Enterprise - -Intended availability of the feature when released outside of Grafana Cloud. -The information is intentionally commented out so that it isn't displayed in the published page. -If the feature is not going to be released outside of Grafana Cloud, omit the HTML comment entirely. - -## _`DATE`_ - -The release date of the feature, fully written out. For example: September 12, 2023. - -## _`CLOUD AVAILABILITY`_ - -One of the following [release life cycle stages](https://grafana.com/docs/release-life-cycle/): - -- Generally available -- Available in public preview -- Available in private preview -- Experimental - -## _`CLOUD OFFERING`_ - -List the appropriate combination of: - -- Cloud Free -- Cloud Pro -- Cloud Advanced - -Or if all three: - -- Cloud - -## _`DESCRIPTION`_ - -Include an overview of the feature and problem it solves, and where to learn more. -Link to any appropriate documentation and, optionally, embed a video or image to illustrate the feature, following our [image and media guidelines](https://grafana.com/docs/writers-toolkit/write/image-guidelines/#image-diagram-and-screenshot-guidelines). -You must use relative path references when linking to documentation within the Grafana repository. -Use the Hugo `relref` shortcode for build time link checking. -For more information about the `relref` shortcode, refer to [Links and references](https://grafana.com/docs/writers-toolkit/writing-guide/references/). - -Grafana Cloud documentation uses the "next" version of Grafana documentation. -For consistency, links to Grafana OSS documentation should also link to the "next" version. -For example, using the partial URL `/docs/grafana/next/explore/` to link to the Grafana OSS explore documentation. - -## Example - -```markdown -## Updated navigation - - - - -September 12, 2023 - -_Available in public preview in Grafana Cloud Pro and Advanced_ - -The navigation in Grafana Cloud has been updated in the following ways... -``` +To contribute to [What's new in Grafana Cloud](https://grafana.com/docs/grafana-cloud/whatsnew/), refer to [Contribute to What’s new or release notes](https://grafana.com/docs/writers-toolkit/contribute-documentation/contribute-release-notes/). diff --git a/docs/sources/whatsnew/whats-new-next/index.md b/docs/sources/whatsnew/whats-new-next/index.md deleted file mode 100644 index 395fe077a73..00000000000 --- a/docs/sources/whatsnew/whats-new-next/index.md +++ /dev/null @@ -1,397 +0,0 @@ ---- -canonical: https://grafana.com/docs/grafana/latest/whatsnew/whats-new-next/ -description: Feature and improvement highlights for Grafana Cloud -keywords: - - grafana - - new - - documentation - - cloud - - release notes -labels: - products: - - cloud -title: What's new in Grafana Cloud -weight: -37 ---- - -# What’s new in Grafana Cloud - -Welcome to Grafana Cloud! Read on to learn about the newest changes to Grafana Cloud. - -## Alerting insights - - - -October 30, 2023 - -_Generally available in Grafana Cloud_ - -Use Alerting insights to monitor your alerting data, discover key trends about your organization’s alert management performance, and find patterns in why things go wrong. - -## Correlations editor in Explore - - - - - -October 3, 2023 - -_Available in public preview in Grafana Cloud_ - -Creating correlations has just become easier. Try out our new correlations editor in **Explore** by selecting the **+ Add > Add correlation** option from the top bar or from the command palette. The editor shows all possible places where you can place data links and guides you through building and testing target queries. For more information, refer to [the documentation](https://grafana.com/docs/grafana//administration/correlations/). - -To enable this feature, contact Grafana Support. - -## Create correlations for provisioned data sources - - - - - -September 13, 2023 - -_Available in public preview in Grafana Cloud_ - -You can now create correlations using either the **Administration** page or provisioning, regardless of whether a data source was provisioned or not. In previous versions of Grafana, if a data source was provisioned, the only way to add correlations to it was also with provisioning. Now, that's no longer the case, and you can easily create new correlations mixing both methods—using the **Administration** page or provisioning. - -To enable this feature, contact Grafana Support. - -## Tempo data source: "Aggregate By" Search option to compute RED metrics over spans aggregated by attribute - - - - -October 24, 2023 - -_Experimental in Grafana Cloud_ - -We've added an **Aggregate By** option to the [TraceQL query editor](https://grafana.com/docs/grafana//datasources/tempo/query-editor/traceql-search/#write-traceql-queries-using-search) to leverage Grafana Cloud Traces' [metrics summary API](https://grafana.com/docs/grafana-cloud/monitor-infrastructure/traces/metrics-summary-api/). You can calculate RED metrics (total span count, percent erroring spans, and latency information) for spans of `kind=server` received in the last hour that match your filter criteria, grouped by whatever attributes you specify. - -This feature is disabled by default. To enable it, file contact Grafana Support. - -For more information, refer to the [documentation](https://grafana.com/docs/grafana//datasources/tempo/query-editor/traceql-search/#optional-use-aggregate-by). - -{{< figure src="/media/docs/tempo/metrics-summary-10-2.png" caption="Aggregate by" >}} - -## No basic role - - - - -_Generally available in Grafana Cloud_ - -We're excited to introduce the "No basic role," a new basic role with no permissions. A basic role in Grafana dictates the set of actions a user or entity can perform, known as permissions. This new role is especially beneficial if you're aiming for tailored, customized RBAC permissions for your service accounts or users. You can set this as a basic role through the API or UI. - -Previously, permissions were granted based on predefined sets of capabilities. Now, with the "No basic role," you have the flexibility to be even more granular. - -For more details on basic roles and permissions, refer to the [documentation](https://grafana.com/docs/grafana//administration/roles-and-permissions/). - -## Content outline - - - - -October 12, 2023 - -_Generally Available in Grafana Cloud_ - -Introducing Content Outline in Grafana **Explore**. We recognized the challenges of complex mixed queries, as well as, lengthy logs and traces results, leading to time-consuming navigation and the loss of context. Content outline is our first step towards seamless navigation from log lines to traces and back to queries ensuring quicker searches while preserving context. Experience efficient, contextual investigations with this update in Grafana Explore. To learn more, refer to the [Content outline documentation](https://grafana.com/docs/grafana//explore/#content-outline), as well as the following video demo. - -{{< video-embed src="/media/docs/grafana/explore/content-outline-demo.mp4" >}} - -## Issues snapshot in Kubernetes Monitoring - - - -September 29, 2023 - -_Generally available in Grafana Cloud_ - -To provide quicker identification and troubleshooting, the home page contains a snapshot of issues that reach the following thresholds: - -- Pods that have been in a non-running state for more than 15 minutes -- Nodes with CPU usage above 90% for more than five minutes -- Nodes using more than 90% of memory for more than five minutes -- Persistent Volumes with capacity above 90% -- Node disks with capacity above 90% - -(Release 1.3.1) -{{< figure max-width="80%" src="/media/docs/grafana-cloud/k8s/K8smon-snapshotview.png" caption="Home page snapshot view" >}} - -## Tabs navigation in Kubernetes Monitoring - - - -September 14, 2023 - -_Generally available in Grafana Cloud_ - -Quickly switch between the Cluster, namespace, workload, and Node views on the **Cluster Navigation** page using tabs. (Release 1.3.0) - -{{< figure max-width="40%" src="/media/docs/grafana-cloud/k8s/k8smon-clusternav-tabs.png" caption="Tabs on **Cluster Navigation** page" >}} - -## Data source menu on Cost and Efficiency views in Kubernetes Monitoring - - - -September 14, 2023 - -_Generally available in Grafana Cloud_ - -You can change the data source you are viewing on the **Cost** and **Efficiency** views. (Release 1.2.1) - -## Predict namespace memory usage in Kubernetes Monitoring - - - -September 14, 2023 - -_Generally available in Grafana Cloud_ - -Click **Predict Memory usage** to predict namespace memory usage on the namespace detail page. (Release 1.2.1) - -{{< figure max-width="50%" src="/media/docs/grafana-cloud/k8s/k8smon-predict-memusage-namespace.png" caption="**Predict Memory usage** button" >}} - -## Streamlined configuration of Kubernetes Monitoring - - - -September 15, 2023 - -_Generally available in Grafana Cloud_ - -Configure with [Grafana Kubernetes Monitoring Helm chart](https://grafana.com/docs/grafana-cloud/monitor-infrastructure/kubernetes-monitoring/configuration/config-k8s-agent-flow) using a streamlined process. With this method, you can set on/off switches to gather metrics, logs, events, traces, and cost metrics. (Release 1.2.0) - -{{< figure max-width="60%" src="/media/docs/grafana-cloud/k8s/k8smon-config-wizard.png" caption="Configuration wizard" >}} - -## Traces collection with Kubernetes Monitoring - - - -September 14, 2023 - -_Generally available in Grafana Cloud_ - -Collect traces when you configure Kubernetes Monitoring, and then use Tempo to create search queries. Refer to [Navigate to traces](/docs/grafana-cloud/monitor-infrastructure/kubernetes-monitoring/navigate-k8s-monitoring/#navigate-to-traces) for more information. (Release 1.3.0) - -## Kafka integration in Kubernetes Monitoring - - - -September 14, 2023 - -_Generally available in Grafana Cloud_ - -The Kafka integration is available for use in Kubernetes Monitoring. (Release 1.3.6) - -## Public dashboards - - - - -October 12, 2023 - -_Generally Available in Grafana Cloud_ - -Public dashboards allow you to share your visualizations and insights to a broader audience without the requirement of a login. You can effortlessly use our current sharing model and create a public dashboard URL to share with anyone using the generated public URL link. To learn more, refer to the [Public dashboards documentation](https://grafana.com/docs/grafana//dashboards/dashboard-public/), as well as the following video demo: - -{{< video-embed src="/media/docs/grafana/dashboards/public-dashboards-demo.mp4" >}} - -## Support for dashboard variables in transformations - - - - -October 24, 2023 - -_Experimental in Grafana Cloud_ - -Previously, the only transformation that supported [dashboard variables](https://grafana.com/docs/grafana//dashboards/variables/) was the **Add field from calculation** transformation. We've now extended the support for variables to the **Filter by value**, **Create heatmap**, **Histogram**, **Sort by**, **Limit**, **Filter by name**, and **Join by field** transformations. - -We've also made it easier to find the correct dashboard variable by displaying available variables in the fields that support them, either in the drop-down or as a suggestion when you type **$** or press Ctrl + Space: - -{{< figure src="/media/docs/grafana/transformations/completion.png" caption="Input with dashboard variable suggestions" >}} - -## Role mapping support for Google OIDC - - - - -October 24, 2023 - -_Generally available in Grafana Cloud_ - -You can now map Google groups to Grafana organizational roles when using Google OIDC. -This is useful if you want to limit the access users have to your Grafana instance. - -We've also added support for controlling allowed groups when using Google OIDC. - -Refer to the [Google Authentication documentation](https://grafana.com/docs/grafana//setup-grafana/configure-security/configure-authentication/google/) to learn how to use these new options. - -## Distributed tracing in Grafana Cloud k6 - - - -September 19, 2023 - -_Generally available in Grafana Cloud_ - -You can now use the Grafana Cloud Traces integration with Grafana Cloud k6 to quickly debug failed performance tests and proactively improve application reliability. - -Distributed tracing in Grafana Cloud k6 only requires two things: - -- An application instrumented for tracing with Grafana Cloud Traces. -- Adding a few lines of code to your existing k6 scripts. - -The integration works by having k6 inject tracing metadata into the requests it sends to your backend services when you run a test. The tracing data is then correlated with k6 test run data, so you can understand how your services and operations behaved during the whole test run. The collected tracing data is aggregated to generate real-time metrics—such as frequency of calls, error rates, and percentile latencies—that can help you narrow your search space and quickly spot anomalies. - -To learn more, refer to the [Integration with Grafana Cloud Traces documentation](/docs/grafana-cloud/k6/analyze-results/integration-with-grafana-cloud-traces/) and [Distributed Tracing in Grafana Cloud k6 blog post](https://grafana.com/blog/2023/09/19/troubleshoot-failed-performance-tests-faster-with-distributed-tracing-in-grafana-cloud-k6/). - -## Tenant database instance name and number for SAP HANA® data source - - - - -September 25, 2023 - -_Generally available in Grafana Cloud_ - -The SAP HANA® data source now supports tenant databases connections by using the database name and/or instance number. For more information, refer to [SAP HANA® configuration](/docs/plugins/grafana-saphana-datasource/latest/#configuration). - -{{< video-embed src="/media/docs/sap-hana/tenant.mp4" >}} - -## Log aggregation for Datadog data source - - - - -August 31, 2023 - -_Generally available in Grafana Cloud_ - -The Datadog data source now supports log aggregation. This feature helps aggregate logs/events into buckets and compute metrics and time series. For more information, refer to [Datadog log aggregation](/docs/plugins/grafana-datadog-datasource/latest#logs-analytics--aggregation). - -{{< video-embed src="/media/docs/datadog/datadog-log-aggregation.mp4" >}} - -## API throttling for Datadog data source - - - - -September 1, 2023 - -_Generally available in Grafana Cloud_ - -The Datadog data source supports blocking API requests based on upstream rate limits (for metric queries). With this update, you can set a rate limit percentage at which the plugin stops sending queries. - -To learn more, refer to [Datadog data source settings](/docs/plugins/grafana-datadog-datasource/latest#configure-the-data-source), as well as the following video demo. - -{{< video-embed src="/media/docs/datadog/datadog-rate-limit.mp4" >}} - -## Query-type template variables for Tempo data source - - - - -August 24, 2023 - -_Generally available in Grafana Cloud_ - -The Tempo data source now supports query-type template variables. With this update, you can create variables for which the values are a list of attribute names or attribute values seen on spans received by Tempo. - -To learn more, refer to the following video demo, as well as the [Grafana Variables documentation](/docs/grafana/next/dashboards/variables/). - -{{< video-embed src="/media/docs/tempo/screen-recording-grafana-10.2-tempo-query-type-template-variables.mp4" >}} - -## Improved TraceQL query editor - - - - -October 3, 2023 - -_Generally available in Grafana Cloud_ - -The [TraceQL query editor](https://grafana.com/docs/tempo/latest/traceql/#traceql-query-editor) has been improved to facilitate the creation of TraceQL queries. In particular, it now features improved autocompletion, syntax highlighting, and error reporting. - -{{< video-embed src="/media/docs/tempo/screen-recording-grafana-10.2-traceql-query-editor-improvements.mp4" >}} - -## Grafana OnCall integration for Alerting - - - - -September 13, 2023 - -_Generally available in Grafana Cloud_ - -Use the Grafana Alerting - Grafana OnCall integration to effortlessly connect alerts generated by Grafana Alerting with Grafana OnCall. From there, you can route them according to defined escalation chains and schedules. - -To learn more, refer to the [Grafana OnCall integration for Alerting documentation](/docs/grafana/next/alerting/alerting-rules/manage-contact-points/configure-oncall/). - -## New browse dashboards - - - - -September 19, 2023 - -_Generally available in Grafana Cloud_ - -The new browse dashboards interface features a more compact design, making it easier to navigate, search for, and manage for your folders and dashboards. The new interface also has many performance improvements, especially for instances with a large number of folders and dashboards. - -To make using folders easier and more consistent, there is no longer a special **General** folder. Dashboards without a folder, or dashboards previously in **General**, are now shown at the root level. - -To learn more, refer to the following video demo. - -{{< video-embed src="/media/docs/grafana/2023-09-11-New-Browse-Dashboards-Enablement-Video.mp4" >}} - -## Multiple spansets per trace - - - - -October 24, 2023 - -_Generally available in Grafana Cloud_ - -The [TraceQL query editor](https://grafana.com/docs/tempo//traceql/#traceql-query-editor) has been improved to facilitate the grouping of multiple spans per trace in TraceQL queries. For example, when the following `by(resource.service.name)` is added to your TraceQL query, it will group the spans in each trace by `resource.service.name`. - -{{< figure src="/media/docs/tempo/multiple-spansets-per-trace-10-2.png" max-width="750px" caption="Multiple spansets per trace" >}} - -## Temporary credentials in CloudWatch data source - - - - -October 24, 2023 - -_Available in private preview in Grafana Cloud_ - -The Grafana Assume Role authentication provider lets Grafana Cloud users of the CloudWatch data source authenticate with AWS without having to create and maintain long term AWS Users. Using the new assume role authentication method, you no longer have to rotate access and secret keys in your CloudWatch data source. Instead, Grafana Cloud users can create an identity access and management (IAM) role that has a trust relationship with Grafana's AWS account; Grafana's AWS account will then use AWS Secure Token Service (STS) to create temporary credentials to access the user's AWS data. - -To learn more, refer to the [CloudWatch authentication documentation](/docs/grafana/next/datasources/aws-cloudwatch/aws-authentication). - -## Recorded queries: Record multiple metrics from a single query - - - - -October 3, 2023 - -_Generally available in Grafana Cloud_ - -With recorded queries, a single recorded query can now record multiple metrics. - -## Permission validation on custom role creation and update - - - - - - -August 25, 2023 - -_Generally available in Grafana Cloud_ - -With the current release, we enabled RBAC permission validation (`rbac.permission_validation_enabled` setting) by default. This means that the permissions provided in the request during custom role creation or update are validated against the list of [available permissions and their scopes](https://grafana.com/docs/grafana//administration/roles-and-permissions/access-control/custom-role-actions-scopes/#action-definitions). If the request contains a permission that is not available or the scope of the permission is not valid, the request is rejected with an error message.