Skip to content

Data exploration changes #21953

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 4 commits into from
Oct 24, 2025
Merged

Data exploration changes #21953

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
69b92b2
wip
cbehera-newrelic Oct 16, 2025
d93f85e
wip
cbehera-newrelic Oct 21, 2025
bec4747
Images updated
cbehera-newrelic Oct 21, 2025
cefc3df
Review comments incorporated
cbehera-newrelic Oct 23, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 0 additions & 6 deletions src/content/docs/nrql/get-started/introduction-nrql-how-nrql-works.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -53,12 +53,6 @@ This results in a very basic NRQL query using the required clause and statement
src="/images/queries-nrql_screenshot-crop_basic-nrql-query-example.webp"
/>

Another great way to explore your data is to go into any existing dashboards you have, click <DNT>**View query**</DNT>, and run your chart in the query builder.
<img title="new-relic-view-chart-nrql-query.png" alt="New Relic view chart NRQL query" src="/images/queries-nrql_screenshot-crop_view-query-for-chart.webp"/>

<figcaption>
Charts built with NRQL will have <DNT>**View query**</DNT> as an option. You can then edit and customize that query to see how your changes affect the resulting visualization.
</figcaption>

## NRQL query examples [#examples]

Expand Down
49 changes: 7 additions & 42 deletions src/content/docs/nrql/get-started/introduction-nrql-new-relics-query-language.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -114,17 +114,8 @@ NRQL is an acronym of New Relic query language. It's a query language similar to

You can use NRQL to create simple queries, such as fetching rows of data in a raw tabular form that gives insight on individual events. You can also use NRQL to run powerful calculations on the data before it's presented to you, such as crafting funnels based on how end users interact with your site or application.

We use NRQL behind the scenes to generate many of the charts and dashboards in our curated UI experiences:
We use NRQL behind the scenes to generate many of the charts and dashboards in our curated UI experiences.

<img
title="new-relic-view-chart-nrql-query.png"
alt="A screenshot of a NRQL query chart"
src="/images/queries-nrql_screenshot-crop_view-query-for-chart.webp"
/>

<figcaption>
We build many of the charts and visualizations within New Relic using NRQL. You can view a chart's query and then edit it to make your own custom chart as a quick way to get started using NRQL.
</figcaption>

## Where can you use NRQL? [#where]

Expand All @@ -136,52 +127,26 @@ You can use NRQL across the platform to access your data. Those places include:
title="The query builder"
>
<img
title="Query builder example"
alt="A screenshot showing the query builder"
src="/images/queries-nrql_screenshot-crop_nrql-example-timeseries.webp"
title="new-relic-view-chart-nrql-query.png"
alt="A screenshot of a NRQL query chart"
src="/images/queries-nrql_screenshot-crop_view-query-for-chart.webp"
/>

<figcaption>
<DNT>
**[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Query your data**
</DNT>
Access the query builder through the **Query your data** drawer at the bottom of any New Relic page to run queries and create custom charts.
</figcaption>

You can run a NRQL query in the [query builder](/docs/chart-builder/use-chart-builder/get-started/introduction-chart-builder) within [the platform](/docs/new-relic-one/use-new-relic-one/get-started/introduction-new-relic-one). This NRQL query shows a count of [distributed tracing](/docs/understand-dependencies/distributed-tracing/get-started/introduction-distributed-tracing) spans faceted by their entity names.
</Collapser>

<Collapser
id="nrql-console-nrql-intro"
title="The NRQL console"
>
<img
title="NRQL console example"
alt="A screenshot showing the NRQL console"
src="/images/queriesNrql_screenshot-full_nrql-console.webp"
/>

<figcaption>
<DNT>
**[one.newrelic.com](https://one.newrelic.com/) > User profile > NRQL console > Show**
</DNT>
</figcaption>

You can run a NRQL query from anywhere within New Relic using the [NRQL console](/docs/query-your-data/explore-query-data/query-builder/introduction-query-builder/#query-from-anywhere). This allows you to quickly query your data without leaving your current screen.
</Collapser>

<Collapser
id="nrql-alerts-nrql-intro"
title="NRQL-based alerts"
>
<img
title="NRQL condition alert and generated results"
alt="A screenshot of a NRQL condition alert"
src="/images/nr1_nrql_alert_conditions.webp"
/>

<figcaption>
<DNT>**[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Alerts > Alert conditions (Policies) > (select a policy) > Add a condition**</DNT>. Click <DNT>**NRQL**</DNT>, and then <DNT>**Next, define thresholds**</DNT>.
</figcaption>
* Go to <DNT>**[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Alerts > Alert conditions (Policies) > (select a policy) > Add a condition**</DNT>. Click <DNT>**NRQL**</DNT>, and then <DNT>**Next, define thresholds**</DNT>.


You can use NRQL to build [NRQL-based alerts](/docs/alerts-applied-intelligence/new-relic-alerts/alert-conditions/create-nrql-alert-conditions/), our primary and most powerful alert type. This will help to notify you of issues and help you address them in a timely fashion.
</Collapser>
Expand Down
88 changes: 26 additions & 62 deletions ...s/query-your-data/explore-query-data/browse-data/introduction-data-explorer.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,12 +1,12 @@
---
title: "Introduction to the metrics and events data explorer"
title: "Introduction to the data explorer"
tags:
- Query your data
- Explore and query data
- Explore data
translate:
- jp
metaDescription: "An introduction to the metric and event data explorer of New Relic."
metaDescription: "An introduction to the New Relic data explorer for browsing and visualizing your data."
redirects:
- /docs/query-your-data/explore-query-data/introduction-data-explorer
- /docs/infrastructure/new-relic-infrastructure/share-charts/share-infrastructure-data-view-insights
Expand Down Expand Up @@ -36,56 +36,56 @@ redirects:
freshnessValidatedDate: never
---

Navigate all your data visually using <DNT>**Metrics and events**</DNT> and without needing to know how to write [NRQL-format queries](/docs/query-your-data/nrql-new-relic-query-language/get-started/introduction-nrql-new-relics-query-language).
Navigate all your data visually using the <DNT>**Data Explorer**</DNT> without needing to know how to write [NRQL-format queries](/docs/query-your-data/nrql-new-relic-query-language/get-started/introduction-nrql-new-relics-query-language). The Data Explorer is part of the Query Console, accessible through the query drawer at the bottom of the New Relic platform.

Need to perform a more detailed search? Read how to [query your data](/docs/query-your-data/explore-query-data/get-started/introduction-querying-new-relic-data/). If you haven't already, create your free New Relic account below to start monitoring your data today.

## Why it matters [#why-matters]

Do you research the state of your systems? Do you need to plan resources, identify and respond to incidents, or troubleshoot faulty behaviors? Metrics and events make it easy to identify, fetch and visualize the data you are looking for through visual menus, without ever using NRQL or building queries.
Do you research the state of your systems? Do you need to plan resources, identify and respond to incidents, or troubleshoot faulty behaviors? The Data Explorer makes it easy to identify, fetch and visualize the data you are looking for through visual menus, without ever using NRQL or building queries.

With <DNT>**Metrics and events**</DNT> you can access all data stored in the New Relic database (NRDB) in a quick, intuitive way. You can then select <DNT>**Dimensions**</DNT> to facet by specific dimensions of that data.
With the <DNT>**Data Explorer**</DNT> you can access all data stored in the New Relic database (NRDB) in a quick, intuitive way. You can then select <DNT>**Dimensions**</DNT> to facet by specific dimensions of that data.

Other things metrics and events helps you do:
Other things the Data Explorer helps you do:

* See data from different points of view: from raw data to different visualizations that provide insights on evolution, distribution, and more.
* Drill down into data using filters.
* Add predictions to line and area charts (Available with the public preview of [NRQL Predictions](/docs/query-your-data/explore-query-data/use-charts/nrql-predictions)).
* Add your searches to a [dashboard](/docs/dashboards/new-relic-one-dashboards/get-started/introduction-new-relic-one-dashboards).
* Understand how [NRQL](/docs/query-data/nrql-new-relic-query-language/getting-started/introduction-nrql) works: metrics and events shows how queries are built.
* Understand how [NRQL](/docs/query-data/nrql-new-relic-query-language/getting-started/introduction-nrql) works: the Data Explorer shows how queries are built.

## Types of data you can explore [#data-types]

In the context of <DNT>**Metrics and events**</DNT>, `event` refers to all objects stored in the New Relic database (NRDB). Metrics and events let you explore:
In the context of the <DNT>**Data Explorer**</DNT>, `event` refers to all objects stored in the New Relic database (NRDB). The Data Explorer lets you explore:

* Metrics:
* [Dimensional metrics](/docs/data-apis/understand-data/new-relic-data-types/#dimensional-metrics) (the `Metric` data type).
* [Metric timeslice data](/docs/data-apis/understand-data/new-relic-data-types/#timeslice-data): <InlinePopover type="apm"/> agents, mobile agents, and the <InlinePopover type="browser"/> agent report this data type. To explore this type of data, you must choose an entity monitored by one of those agents, and then you'll see those options.
* Events: the [event data type](/docs/data-apis/understand-data/new-relic-data-types/#events-new-relic).
* Logs: the `Log` data type (which you can also explore via our [logs UI](/docs/logs/ui-data/use-logs-ui)).
* Traces: the `Span` data type (which you can also explore via our [trace UI](/docs/distributed-tracing/ui-data/query-distributed-trace-data)).
* Lookup tables: Data that isn't present in your New Relic account, by uploading CSV files (which you can also explore via our [lookup tables UI](/docs/logs/ui-data/lookup-tables-ui)).

## Explore your data [#explore-data]

To access the data explorer, go to <DNT>**[one.newrelic.com](https://one.newrelic.com) > All capabilities > Metrics and events**</DNT>.
To access the Data Explorer, click the <DNT>**Query your data**</DNT> button in the bottom drawer of any New Relic page, then select the <DNT>**Data Explorer**</DNT> option.

Metrics and events consist of these:
The Data Explorer consists of these:

* Scoping section on the top. You can select between `metrics` or `events` and `account`. If you select metrics, you can filter by entity.
* Scoping section on the top. You can select the account and choose from multiple data types: `events`, `metrics`, `timeslices`, `logs`, and `lookups`. If you select metrics, you can filter by entity.
* Data browsing area on the left. If you choose `metrics`, the options are `metric` and `dimensions`. If you choose `events`, the options are `event type`, `plot`, and `dimensions`.
* Workspace. This area shows you the result of your choices.

<img
title="Metrics and events view"
alt="Metrics and events view"
src="/images/queries-nrql_screenshot-full_metrics-events-data-explorer.webp"
title="Data Explorer view"
alt="Data Explorer view"
src="/images/data-explorer.gif"
/>

<figcaption>
<DNT>**[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Metrics & events**</DNT>: Metrics and events view.
Access the Data Explorer through the <DNT>**Query your data**</DNT> drawer: Data Explorer view.
</figcaption>

To use metrics and events:
To use the Data Explorer:

1. Define the scope. Select the data type (metric or event), the account, and the entities.
2. Select the time range using the [time picker](/docs/query-your-data/explore-query-data/dashboards/manage-your-dashboard/#dash-time-picker).
Expand Down Expand Up @@ -193,16 +193,10 @@ At the working space you can see:
id="workspace-query-area"
title="Querying area"
>
The querying area breaks down the query into its different constituents. Here, you can easily read the result of your exploration as an NRQL query, and check the exact data being plotted.
The querying area breaks down the query into its different constituents. The auto-complete feature helps you build your query by suggesting fields and functions as you type.
Here, you can easily read the result of your exploration as an NRQL query, and check the exact data being plotted.

If you are not familiar with NRQL, check this area to learn about the build of the queries.

The different parts of the query are these:

* [`SELECT`](/docs/query-data/nrql-new-relic-query-language/getting-started/nrql-syntax-clauses-functions#state-select): the plot or metric selected. This input plots only one value and one function.
* [`GROUP BY`](/docs/query-data/nrql-new-relic-query-language/getting-started/nrql-syntax-clauses-functions#sel-facet): represents the `FACET` clause, and groups the data by the selected dimension.
* [`LIMIT`](/docs/query-data/nrql-new-relic-query-language/getting-started/nrql-syntax-clauses-functions#sel-limit): type in the amount of values you want to see.
* [`WHERE`](/docs/query-data/nrql-new-relic-query-language/getting-started/nrql-syntax-clauses-functions#sel-where): use this field to further filter results. This input plots `n` values.
If you are not familiar with NRQL, refer to the [NRQL documentation](https://docs.newrelic.com/docs/query-your-data/nrql-new-relic-query-language).

<img
title="Querying area in the Metrics and events view "
Expand All @@ -211,20 +205,6 @@ At the working space you can see:
/>
</Collapser>

<Collapser
className="freq-link"
id="workspace-query-display"
title="NRQL query display"
>
You can see the full query, which is composed of the fields above and the [time range selected](#explore-data) with the time picker. If you move the mouse pointer over the query and click it, you'll edit the NRQL query in the query builder.

<img
title="Querying area in the Metrics and events view"
alt="Querying area in the Metrics and events view"
src="/images/queries-nrql_screenshot-crop_metrics-events-nrql-display.webp"
/>
</Collapser>

<Collapser
className="freq-link"
id="workspace-chart"
Expand Down Expand Up @@ -284,31 +264,15 @@ At the working space you can see:
/>

<figcaption>
<DNT>**[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Metrics and events**</DNT>: Predicted view.
Access the Data Explorer through the <DNT>**Query your data**</DNT> drawer: Predicted view.
</figcaption>
</Collapser>
</CollapserGroup>

## Visualize your custom metric after creating it [#visualize-metric]

Follow these steps to visualize your custom metric through the metrics explorer:

1. Access the data explorer, go to <DNT>**[one.newrelic.com](https://one.newrelic.com) > All capabilities > Metrics and events**</DNT>.

2. Choose your entity.

3. Click <DNT>**See timeslice metrics for `your entity`**</DNT> link.

<img
style={{ width: "50%" }}
title="See timeslice metrics for `your entity`"
alt="See timeslice metrics for `your entity`"
src="/images/queries-nrql_screenshot-crop_timeslice-metrics-link.webp"
/>

## Use cases [#uses-cases]

See the following examples to learn how and when to use metrics and events.
See the following examples to learn how and when to use the Data Explorer.

<CollapserGroup>
<Collapser
Expand All @@ -321,7 +285,7 @@ See the following examples to learn how and when to use metrics and events.
</DNT>

1. Select the account and event or metric that's generating the new data.
2. Use the different tools in metrics and events to toy around the new data that has become available: have a look at the raw data of that event or metric as a table, shape it as a list, or click to see it plotted as a chart.
2. Use the different tools in the Data Explorer to explore the new data that has become available: have a look at the raw data of that event or metric as a table, shape it as a list, or click to see it plotted as a chart.
3. After selecting an event or metric, discover the shape of the data in its dimensions. Guided by cardinality, you can see the different points of view of any data.
4. Found anything relevant? Save it to a dashboard or share it with a colleague.
</Collapser>
Expand All @@ -335,7 +299,7 @@ See the following examples to learn how and when to use metrics and events.
**I changed a custom event/metric and need to check if this change has been successful.**
</DNT>

1. In metrics and events, select the account, data type and event/metric you made changes to.
1. In the Data Explorer, select the account, data type and event/metric you made changes to.
2. Verify the entity is reporting data, and that all the attributes are being plotted.
3. Find the attribute you made changes to and check the update was successful.
</Collapser>
Expand All @@ -356,7 +320,7 @@ See the following examples to learn how and when to use metrics and events.
**I want to see the future trend of a line or area chart to take proactive measures based on the predicted data.**
</DNT>

1. Go to <DNT>**[one.newrelic.com](https://one.newrelic.com) > All capabilities > Metrics and events**</DNT>.
1. Access the Data Explorer by clicking the <DNT>**Query your data**</DNT> button in the bottom drawer of any New Relic page.
2. Select a line or area chart where you want to add prediction.
3. From the <DNT>**Options**</DNT> menu, select <DNT>**Predict trend**</DNT>. The chart with the prediction opens in the <DNT>**Data Explorer**</DNT>.
4. Save it to a dashboard.
Expand All @@ -371,7 +335,7 @@ See the following examples to learn how and when to use metrics and events.
**I know there's something off with an event/metric from an alert or dashboard. I need to know the root cause about the event/metric/attribute behavior.**
</DNT>

1. In metrics and events, use the menus to select the event or metric that's not behaving as expected and let metrics and events plot that chart.
1. In the Data Explorer, use the menus to select the event or metric that's not behaving as expected and let the Data Explorer plot that chart.
2. From there, you can drill down in the dimensions of that data and filter by those attributes that are relevant.
3. You can also see that data from different perspectives: its distribution, ranking of values, or evolution over time.
4. Found anything relevant? Save it to a dashboard or share it with a colleague.
Expand Down
2 changes: 1 addition & 1 deletion ...ur-data/explore-query-data/get-started/introduction-querying-new-relic-data.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -96,7 +96,7 @@ Regardless of your experience with New Relic, we'll help you discover, understan

Our platform offers several experiences that don't require knowledge of NRQL or any query language:

* To explore your New Relic data, you can use [metrics and events](/docs/query-your-data/explore-query-data/data-explorer/introduction-data-explorer), an intuitive data navigator for exploring data and creating visualizations. You can also use the [query builder](/docs/chart-builder/use-chart-builder/choose-data/use-advanced-nrql-mode-specify-data) to refine your query.
* To explore your New Relic data, you can use the [Data Explorer](/docs/query-your-data/explore-query-data/browse-data/introduction-data-explorer), an intuitive data navigator for exploring data and creating visualizations. You can also use the [query builder](/docs/query-your-data/explore-query-data/query-builder/introduction-query-builder) to refine your query.
* To explore your trace data, you can use the [distributed tracing query](/docs/understand-dependencies/distributed-tracing/ui-data/additional-distributed-tracing-features-new-relic-one).
* To explore logs, you can use the [logs UI](/docs/logs/ui-data/use-logs-ui/).

Expand Down
Loading
Loading