[release-11.5.3] Rename Explore Apps to App Drilldown (#101259)
Co-authored-by: Carl Bergquist <carl.bergquist@gmail.com> Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>
This commit is contained in:
Jack Baldry
co-authored by
Carl Bergquist
Kim Nylander
Carl Bergquist
Kim Nylander
parent
e79330dc08
commit
478ab85845
@@ -56,7 +56,7 @@ To use profiling data, you should:
|
||||
|
||||
- [Configure your application to send profiles](/docs/pyroscope/<PYROSCOPE_VERSION>/configure-client/)
|
||||
- [Configure the Grafana Pyroscope data source](./configure-pyroscope-data-source/).
|
||||
- [View and query profiling data using Explore Profiles or the query editor ](./query-profile-data/)
|
||||
- [View and query profiling data using Profiles Drilldown or the query editor ](./query-profile-data/)
|
||||
|
||||
## Continuous profiling
|
||||
|
||||
|
||||
@@ -104,7 +104,7 @@ If you are running a self-managed Grafana instance or need to configure an addit
|
||||
The connection URL for a self-managed Pyroscope backend depends on how Pyroscope is deployed.
|
||||
Refer to the steps under [Query profiles in Grafana](https://grafana.com/docs/pyroscope/<PYROSCOPE_VERSION>/deploy-kubernetes/helm/#query-profiles-in-grafana) for more information on how to configure the data source.
|
||||
|
||||
If you plan to use the [Explore Profiles](ref:explore-profiles) application and you are running a self-managed Pyroscope backend in microservices mode, the data source connection URL should point to a gateway or proxy that routes requests to the corresponding Pyroscope service.
|
||||
If you plan to use the [Profiles Drilldown](ref:explore-profiles) application and you are running a self-managed Pyroscope backend in microservices mode, the data source connection URL should point to a gateway or proxy that routes requests to the corresponding Pyroscope service.
|
||||
Refer to the [Helm ingress configuration](https://github.com/grafana/pyroscope/blob/main/operations/pyroscope/helm/pyroscope/templates/ingress.yaml) for specific routing requirements.
|
||||
|
||||
## Authentication
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
---
|
||||
description: Explore your profiling data using Explore Profiles or the Pyroscope query editor.
|
||||
description: Explore your profiling data using Profiles Drilldown or the Pyroscope query editor.
|
||||
keywords:
|
||||
- query
|
||||
- profiling
|
||||
@@ -54,22 +54,22 @@ https://grafana.com/docs/grafana-cloud/visualizations/panels-visualizations/visu
|
||||
|
||||
# Query profile data
|
||||
|
||||
You can query your profile data using the open source Grafana Explore Profiles app or the built-in Grafana Pyroscope data source query editor.
|
||||
You can query your profile data using the open source Grafana Profiles Drilldown app or the built-in Grafana Pyroscope data source query editor.
|
||||
|
||||
- Explore Profiles provides a queryless experience for inspecting your profiling data with opinionated workflows to assist your investigation.
|
||||
- Profiles Drilldown provides a queryless experience for inspecting your profiling data with opinionated workflows to assist your investigation.
|
||||
- Data source query editor provides complete control over your data exploration and is recommended for experienced users.
|
||||
|
||||
In addition, you can embed flame graph panels in Grafana dashboards.
|
||||
Refer to the [Flame graph panel](ref:flame-graph-panel) documentation for details.
|
||||
|
||||
## Explore Profiles
|
||||
## Profiles Drilldown
|
||||
|
||||
[Explore Profiles](ref:explore-profiles) is a native Grafana application designed to integrate seamlessly with Pyroscope, the open source continuous profiling platform, providing a smooth, queryless experience for browsing and analyzing profiling data.
|
||||
[Grafana Profiles Drilldown](ref:explore-profiles) is a native Grafana application designed to integrate seamlessly with Pyroscope, the open source continuous profiling platform, providing a smooth, queryless experience for browsing and analyzing profiling data.
|
||||
|
||||
You can use Explore Profiles in Grafana Cloud or in your own Grafana instance.
|
||||
For more information, refer to [Access or install Explore Profiles](ref:explore-profiles-install).
|
||||
You can use Profiles Drilldown in Grafana Cloud or in your own Grafana instance.
|
||||
For more information, refer to [Access or install Profiles Drilldown](ref:explore-profiles-install).
|
||||
|
||||
|
||||
|
||||
|
||||
### Use cases
|
||||
|
||||
@@ -80,10 +80,10 @@ The main use cases are the following:
|
||||
- Proactive: Cutting costs, addressing latency issues, or optimizing memory usage for applications
|
||||
- Reactive: Resolving incidents with line-level accuracy or debugging active latency/memory issues
|
||||
|
||||
Explore Profiles provides an intuitive interface to specifically support proactivee and reactive use cases.
|
||||
Profiles Drilldown provides an intuitive interface to specifically support proactivee and reactive use cases.
|
||||
You get a holistic view of all of your services and how they're functioning, but also the ability to drill down for more targeted root cause analysis.
|
||||
|
||||
Explore Profiles offers a convenient platform to analyze profiles and get insights that are impossible to get from using other traditional signals like logs, metrics, or tracing.
|
||||
Profiles Drilldown offers a convenient platform to analyze profiles and get insights that are impossible to get from using other traditional signals like logs, metrics, or tracing.
|
||||
|
||||
{{< youtube id="x9aPw_CbIQc" >}}
|
||||
|
||||
@@ -93,7 +93,7 @@ Explore Profiles offers a convenient platform to analyze profiles and get insigh
|
||||
|
||||
The Pyroscope data source query editor gives you access to a profile type selector, a label selector, and collapsible options.
|
||||
|
||||
Like Explore Profiles, the query editor also provides a flame graph to visualize data.
|
||||
Like Profiles Drilldown, the query editor also provides a flame graph to visualize data.
|
||||
|
||||
|
||||
|
||||
|
||||
@@ -61,7 +61,7 @@ The queries use [TraceQL](/docs/tempo/latest/traceql), the query language design
|
||||
For general documentation on querying data sources in Grafana, refer to [Query and transform data](ref:query-transform-data).
|
||||
|
||||
{{< admonition type="tip" >}}
|
||||
Don't know TraceQL? Try [Explore Traces](ref:explore-traces-app), an intuitive, queryless app that lets you explore your tracing data using RED metrics.
|
||||
Don't know TraceQL? Try [Grafana Traces Drilldown](ref:explore-traces-app), an intuitive, queryless app that lets you explore your tracing data using RED metrics.
|
||||
{{< /admonition >}}
|
||||
|
||||
## Before you begin
|
||||
|
||||
@@ -8,7 +8,7 @@ title: Simplified exploration
|
||||
menuTitle: Simplified exploration
|
||||
weight: 100
|
||||
hero:
|
||||
title: Simplified exploration with the Explore apps
|
||||
title: Simplified exploration with the Drilldown apps
|
||||
level: 1
|
||||
width: 100
|
||||
height: 100
|
||||
@@ -16,19 +16,19 @@ hero:
|
||||
cards:
|
||||
title_class: pt-0 lh-1
|
||||
items:
|
||||
- title: Explore Metrics
|
||||
- title: Grafana Metrics Drilldown
|
||||
href: ./metrics/
|
||||
description: Quickly find related metrics with a few clicks, without needing to write PromQL queries to retrieve metrics.
|
||||
height: 24
|
||||
- title: Explore Logs
|
||||
- title: Grafana Logs Drilldown
|
||||
href: ./logs/
|
||||
description: Visualize log volumes to easily detect anomalies or significant changes over time, without needing to compose LogQL queries.
|
||||
height: 24
|
||||
- title: Explore Traces
|
||||
- title: Grafana Traces Drilldown
|
||||
href: ./traces/
|
||||
description: Use Rate, Errors, and Duration (RED) metrics derived from traces to investigate and understand errors and latency issues within complex distributed systems.
|
||||
height: 24
|
||||
- title: Explore Profiles
|
||||
- title: Grafana Profiles Drilldown
|
||||
href: ./profiles/
|
||||
description: View and analyze high-level service performance, identify problem processes for optimization, and diagnose issues to determine root causes.
|
||||
height: 24
|
||||
@@ -36,7 +36,7 @@ cards:
|
||||
|
||||
# Simplified exploration
|
||||
|
||||
The Grafana Explore apps are designed for effortless data exploration through intuitive, queryless interactions.
|
||||
The Grafana Drilldown apps are designed for effortless data exploration through intuitive, queryless interactions.
|
||||
|
||||
Easily explore telemetry signals with these specialized tools, tailored specifically for the Grafana databases to provide quick and accurate insights.
|
||||
|
||||
@@ -45,7 +45,7 @@ Easily explore telemetry signals with these specialized tools, tailored specific
|
||||
To learn more, read:
|
||||
|
||||
- [From multi-line queries to no-code investigations: meeting Grafana users where they are](https://grafana.com/blog/2024/10/22/from-multi-line-queries-to-no-code-investigations-meeting-grafana-users-where-they-are/)
|
||||
- [A queryless experience for exploring metrics, logs, traces, and profiles: Introducing the Explore apps suite for Grafana](https://grafana.com/blog/2024/09/24/queryless-metrics-logs-traces-profiles/).
|
||||
- [A queryless experience for exploring metrics, logs, traces, and profiles: Introducing the Drilldown apps suite for Grafana](https://grafana.com/blog/2025/02/20/grafana-drilldown-apps-the-improved-queryless-experience-formerly-known-as-the-explore-apps/).
|
||||
|
||||
{{< youtube id="MSHeWWsHaIA" >}}
|
||||
|
||||
|
||||
@@ -4,17 +4,17 @@ labels:
|
||||
- cloud
|
||||
- enterprise
|
||||
- oss
|
||||
title: Explore Metrics
|
||||
title: Metrics Drilldown
|
||||
aliases:
|
||||
- ../explore-metrics/ # /docs/grafana/latest/explore/explore-metrics/
|
||||
canonical: https://grafana.com/docs/grafana/latest/explore/simplified-exploration/metrics/
|
||||
description: Explore Metrics lets you browse Prometheus-compatible metrics using an intuitive, queryless experience.
|
||||
description: Grafana Metrics Drilldown lets you browse Prometheus-compatible metrics using an intuitive, queryless experience.
|
||||
weight: 200
|
||||
---
|
||||
|
||||
# Grafana Explore Metrics
|
||||
# Grafana Metrics Drilldown
|
||||
|
||||
Grafana Explore Metrics is a query-less experience for browsing **Prometheus-compatible** metrics. Quickly find related metrics with just a few simple clicks, without needing to write PromQL queries to retrieve metrics.
|
||||
Grafana Metrics Drilldown is a query-less experience for browsing **Prometheus-compatible** metrics. Quickly find related metrics with just a few simple clicks, without needing to write PromQL queries to retrieve metrics.
|
||||
|
||||
{{< docs/shared source="grafana" lookup="plugins/rename-note.md" version="<GRAFANA_VERSION>" >}}
|
||||
|
||||
@@ -35,18 +35,17 @@ You can access Metrics Drilldown either as a standalone experience or as part of
|
||||
|
||||
To access Metrics Drilldown as a standalone experience:
|
||||
|
||||
1. Click the arrow next to **Explore** in the Grafana left-side menu and click **Metrics**. You are taken to an overview page that shows recent metrics, bookmarks, and the option to select a new metric exploration.
|
||||
1. To get started with a new exploration, click **+ New metric exploration**.
|
||||
1. Click the arrow next to **Drilldown** in the Grafana left-side menu and click **Metrics**. You are taken to an overview page that shows recent metrics, bookmarks, and the option to select a new metric exploration.
|
||||
1. To get started with a new exploration, click **Let's start!**.
|
||||
1. Select **Prometheus** or any Prometheus-compatible data source available in the drop-down menu under **Data source**.
|
||||
1. Click **+ Add label** to select a label-value pair from the drop-down menu. You can add multiple label-value pairs. A label type will appear above the selected label with a drop-down list of options from which to choose. For example, if you select the label `container` a drop-down list of available containers appears.
|
||||
1. Click **+ Add label** to select a label-value pair from the drop-down menu. You can add multiple label-value pairs. A label type appears above the selected label with a drop-down list of options from which to choose. For example, if you select the label `container` a drop-down list of available containers appears.
|
||||
1. You can also search for metrics using keywords under **Search metrics** in the search bar.
|
||||
1. Use the time picker to select a date and time range from the drop-down menu or use an absolute time range.
|
||||
1. Click the down arrow next to the **Refresh** icon to set a refresh rate from the drop-down menu. The default is `Off`.
|
||||
1. Click the **Settings** icon and toggle **Always keep selected metric graph in-view** to keep your main graph always in view on the Breakdown drill-down tab.
|
||||
|
||||
The **History** button in the upper left corner tracks every step navigating through metric exploration.
|
||||
|
||||
|
||||
|
||||
|
||||
### Metrics exploration
|
||||
|
||||
@@ -56,12 +55,12 @@ To further explore a metric, click **Select** in the upper right corner of the m
|
||||
|
||||
- The **Overview** tab provides a description for each metric, as well as the metric `type` and `unit` associated with the metric. It also provides a list of labels associated with the metric. Click on any label to view drill-down visualizations.
|
||||
- The **Breakdown** tab depicts time series visualizations for each of the label-value pairs for the selected metric. You can further drill down on each label and click **Add to filter** to add the label/value pair into your filters. You can also change the **View** from grid to rows.
|
||||
- The **Related metrics** tab depicts related metrics with relevant key words. You can repeat the drill down process for any related metric. Toggle **SHow previews** to preview visualizations.
|
||||
- The **Related metrics** tab depicts related metrics with relevant key words. You can repeat the drill down process for any related metric. Toggle **Show previews** to preview visualizations.
|
||||
|
||||
Once you have gathered your metrics exploration data you can:
|
||||
After you have gathered your metrics exploration data you can:
|
||||
|
||||
- Click the **Explore** icon on the right side to open the graph in Explore, where you can modify the query or add the graph to a dashboard or incident.
|
||||
- Click the **Share** icon on the right side to copy the metric drill down URL to the clipboard so it can be shared.
|
||||
- Click the **Open in Explore** icon on the right side to open the graph in Explore, where you can modify the query or add the graph to a dashboard or incident.
|
||||
- Click the **Copy URL** icon on the right side to copy the metric drill down URL to the clipboard so it can be shared.
|
||||
- Click the **Star** icon on the right side to bookmark and save the metrics exploration.
|
||||
|
||||
## Dashboard experience
|
||||
@@ -70,5 +69,5 @@ To access Metrics Drilldown via a dashboard:
|
||||
|
||||
1. Navigate to your dashboard.
|
||||
1. Select a time series panel.
|
||||
1. Click the panel menu in the upper right and select **Explore Metrics**. If there are multiple metrics, click on the one you want to explore.
|
||||
1. You will see a slide out drawer with the Metrics Experience, starting with the drill down. You can access the standalone experience by clicking **Open** in the upper right.
|
||||
1. Click the panel menu in the upper right and select **Metrics Drilldown**. If there are multiple metrics, click on the one you want to explore.
|
||||
1. You see a slide out drawer with the Metrics Experience, starting with the drill down. You can access the standalone experience by clicking **Open** in the upper right.
|
||||
|
||||
@@ -58,7 +58,7 @@ Most [generally available](https://grafana.com/docs/release-life-cycle/#general-
|
||||
| `dashboardScene` | Enables dashboard rendering using scenes for all roles | Yes |
|
||||
| `ssoSettingsApi` | Enables the SSO settings API and the OAuth configuration UIs in Grafana | Yes |
|
||||
| `logsInfiniteScrolling` | Enables infinite scrolling for the Logs panel in Explore and Dashboards | Yes |
|
||||
| `exploreMetrics` | Enables the new Explore Metrics core app | Yes |
|
||||
| `exploreMetrics` | Enables the new Grafana Metrics Drilldown core app | Yes |
|
||||
| `alertingSimplifiedRouting` | Enables users to easily configure alert notifications by specifying a contact point directly when editing or creating an alert rule | Yes |
|
||||
| `logRowsPopoverMenu` | Enable filtering menu displayed when text of a log line is selected | Yes |
|
||||
| `lokiQueryHints` | Enables query hints for Loki | Yes |
|
||||
@@ -208,9 +208,9 @@ Experimental features might be changed or removed without prior notice.
|
||||
| `dataplaneAggregator` | Enable grafana dataplane aggregator |
|
||||
| `lokiSendDashboardPanelNames` | Send dashboard and panel names to Loki when querying |
|
||||
| `alertingPrometheusRulesPrimary` | Uses Prometheus rules as the primary source of truth for ruler-enabled data sources |
|
||||
| `exploreLogsShardSplitting` | Used in Explore Logs to split queries into multiple queries based on the number of shards |
|
||||
| `exploreLogsAggregatedMetrics` | Used in Explore Logs to query by aggregated metrics |
|
||||
| `exploreLogsLimitedTimeRange` | Used in Explore Logs to limit the time range |
|
||||
| `exploreLogsShardSplitting` | Used in Logs Drilldown to split queries into multiple queries based on the number of shards |
|
||||
| `exploreLogsAggregatedMetrics` | Used in Logs Drilldown to query by aggregated metrics |
|
||||
| `exploreLogsLimitedTimeRange` | Used in Logs Drilldown to limit the time range |
|
||||
| `homeSetupGuide` | Used in Home for users who want to return to the onboarding flow or quickly find popular config pages |
|
||||
| `appSidecar` | Enable the app sidecar feature that allows rendering 2 apps at the same time |
|
||||
| `alertingQueryAndExpressionsStepMode` | Enables step mode for alerting queries and expressions |
|
||||
|
||||
@@ -934,7 +934,7 @@ var (
|
||||
},
|
||||
{
|
||||
Name: "exploreMetrics",
|
||||
Description: "Enables the new Explore Metrics core app",
|
||||
Description: "Enables the new Grafana Metrics Drilldown core app",
|
||||
Stage: FeatureStageGeneralAvailability,
|
||||
Expression: "true", // enabled by default
|
||||
FrontendOnly: true,
|
||||
@@ -1423,21 +1423,21 @@ var (
|
||||
},
|
||||
{
|
||||
Name: "exploreLogsShardSplitting",
|
||||
Description: "Used in Explore Logs to split queries into multiple queries based on the number of shards",
|
||||
Description: "Used in Logs Drilldown to split queries into multiple queries based on the number of shards",
|
||||
Stage: FeatureStageExperimental,
|
||||
FrontendOnly: true,
|
||||
Owner: grafanaObservabilityLogsSquad,
|
||||
},
|
||||
{
|
||||
Name: "exploreLogsAggregatedMetrics",
|
||||
Description: "Used in Explore Logs to query by aggregated metrics",
|
||||
Description: "Used in Logs Drilldown to query by aggregated metrics",
|
||||
Stage: FeatureStageExperimental,
|
||||
FrontendOnly: true,
|
||||
Owner: grafanaObservabilityLogsSquad,
|
||||
},
|
||||
{
|
||||
Name: "exploreLogsLimitedTimeRange",
|
||||
Description: "Used in Explore Logs to limit the time range",
|
||||
Description: "Used in Logs Drilldown to limit the time range",
|
||||
Stage: FeatureStageExperimental,
|
||||
FrontendOnly: true,
|
||||
Owner: grafanaObservabilityLogsSquad,
|
||||
|
||||
@@ -508,7 +508,7 @@ const (
|
||||
FlagLogsInfiniteScrolling = "logsInfiniteScrolling"
|
||||
|
||||
// FlagExploreMetrics
|
||||
// Enables the new Explore Metrics core app
|
||||
// Enables the new Grafana Metrics Drilldown core app
|
||||
FlagExploreMetrics = "exploreMetrics"
|
||||
|
||||
// FlagAlertingSimplifiedRouting
|
||||
@@ -760,15 +760,15 @@ const (
|
||||
FlagAlertingPrometheusRulesPrimary = "alertingPrometheusRulesPrimary"
|
||||
|
||||
// FlagExploreLogsShardSplitting
|
||||
// Used in Explore Logs to split queries into multiple queries based on the number of shards
|
||||
// Used in Logs Drilldown to split queries into multiple queries based on the number of shards
|
||||
FlagExploreLogsShardSplitting = "exploreLogsShardSplitting"
|
||||
|
||||
// FlagExploreLogsAggregatedMetrics
|
||||
// Used in Explore Logs to query by aggregated metrics
|
||||
// Used in Logs Drilldown to query by aggregated metrics
|
||||
FlagExploreLogsAggregatedMetrics = "exploreLogsAggregatedMetrics"
|
||||
|
||||
// FlagExploreLogsLimitedTimeRange
|
||||
// Used in Explore Logs to limit the time range
|
||||
// Used in Logs Drilldown to limit the time range
|
||||
FlagExploreLogsLimitedTimeRange = "exploreLogsLimitedTimeRange"
|
||||
|
||||
// FlagHomeSetupGuide
|
||||
|
||||
@@ -1408,11 +1408,14 @@
|
||||
{
|
||||
"metadata": {
|
||||
"name": "exploreLogsAggregatedMetrics",
|
||||
"resourceVersion": "1724938092041",
|
||||
"creationTimestamp": "2024-08-29T13:55:59Z"
|
||||
"resourceVersion": "1740084492165",
|
||||
"creationTimestamp": "2024-08-29T13:55:59Z",
|
||||
"annotations": {
|
||||
"grafana.app/updatedTimestamp": "2025-02-20 20:48:12.165306 +0000 UTC"
|
||||
}
|
||||
},
|
||||
"spec": {
|
||||
"description": "Used in Explore Logs to query by aggregated metrics",
|
||||
"description": "Used in Logs Drilldown to query by aggregated metrics",
|
||||
"stage": "experimental",
|
||||
"codeowner": "@grafana/observability-logs",
|
||||
"frontend": true
|
||||
@@ -1421,11 +1424,14 @@
|
||||
{
|
||||
"metadata": {
|
||||
"name": "exploreLogsLimitedTimeRange",
|
||||
"resourceVersion": "1724938092041",
|
||||
"creationTimestamp": "2024-08-29T13:55:59Z"
|
||||
"resourceVersion": "1740084492165",
|
||||
"creationTimestamp": "2024-08-29T13:55:59Z",
|
||||
"annotations": {
|
||||
"grafana.app/updatedTimestamp": "2025-02-20 20:48:12.165306 +0000 UTC"
|
||||
}
|
||||
},
|
||||
"spec": {
|
||||
"description": "Used in Explore Logs to limit the time range",
|
||||
"description": "Used in Logs Drilldown to limit the time range",
|
||||
"stage": "experimental",
|
||||
"codeowner": "@grafana/observability-logs",
|
||||
"frontend": true
|
||||
@@ -1434,11 +1440,14 @@
|
||||
{
|
||||
"metadata": {
|
||||
"name": "exploreLogsShardSplitting",
|
||||
"resourceVersion": "1724938092041",
|
||||
"creationTimestamp": "2024-08-29T13:55:59Z"
|
||||
"resourceVersion": "1740084492165",
|
||||
"creationTimestamp": "2024-08-29T13:55:59Z",
|
||||
"annotations": {
|
||||
"grafana.app/updatedTimestamp": "2025-02-20 20:48:12.165306 +0000 UTC"
|
||||
}
|
||||
},
|
||||
"spec": {
|
||||
"description": "Used in Explore Logs to split queries into multiple queries based on the number of shards",
|
||||
"description": "Used in Logs Drilldown to split queries into multiple queries based on the number of shards",
|
||||
"stage": "experimental",
|
||||
"codeowner": "@grafana/observability-logs",
|
||||
"frontend": true
|
||||
@@ -1447,14 +1456,14 @@
|
||||
{
|
||||
"metadata": {
|
||||
"name": "exploreMetrics",
|
||||
"resourceVersion": "1720021873452",
|
||||
"resourceVersion": "1740084233934",
|
||||
"creationTimestamp": "2024-04-09T18:15:18Z",
|
||||
"annotations": {
|
||||
"grafana.app/updatedTimestamp": "2024-07-03 15:51:13.452477 +0000 UTC"
|
||||
"grafana.app/updatedTimestamp": "2025-02-20 20:43:53.934892 +0000 UTC"
|
||||
}
|
||||
},
|
||||
"spec": {
|
||||
"description": "Enables the new Explore Metrics core app",
|
||||
"description": "Enables the new Grafana Metrics Drilldown core app",
|
||||
"stage": "GA",
|
||||
"codeowner": "@grafana/dashboards-squad",
|
||||
"frontend": true,
|
||||
|
||||
Reference in New Issue
Block a user