Skip to content

Commit 52076de

Browse files
authored
Merge pull request #21953 from newrelic/Data-exploration-updates
Data exploration changes
2 parents 35de3de + cefc3df commit 52076de

16 files changed

+38
-113
lines changed

src/content/docs/nrql/get-started/introduction-nrql-how-nrql-works.mdx

Lines changed: 0 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -53,12 +53,6 @@ This results in a very basic NRQL query using the required clause and statement
5353
src="/images/queries-nrql_screenshot-crop_basic-nrql-query-example.webp"
5454
/>
5555

56-
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.
57-
<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"/>
58-
59-
<figcaption>
60-
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.
61-
</figcaption>
6256

6357
## NRQL query examples [#examples]
6458

src/content/docs/nrql/get-started/introduction-nrql-new-relics-query-language.mdx

Lines changed: 7 additions & 42 deletions
Original file line numberDiff line numberDiff line change
@@ -114,17 +114,8 @@ NRQL is an acronym of New Relic query language. It's a query language similar to
114114

115115
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.
116116

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

119-
<img
120-
title="new-relic-view-chart-nrql-query.png"
121-
alt="A screenshot of a NRQL query chart"
122-
src="/images/queries-nrql_screenshot-crop_view-query-for-chart.webp"
123-
/>
124-
125-
<figcaption>
126-
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.
127-
</figcaption>
128119

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

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

144135
<figcaption>
145-
<DNT>
146-
**[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Query your data**
147-
</DNT>
136+
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.
148137
</figcaption>
149138

150139
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.
151140
</Collapser>
152141

153-
<Collapser
154-
id="nrql-console-nrql-intro"
155-
title="The NRQL console"
156-
>
157-
<img
158-
title="NRQL console example"
159-
alt="A screenshot showing the NRQL console"
160-
src="/images/queriesNrql_screenshot-full_nrql-console.webp"
161-
/>
162-
163-
<figcaption>
164-
<DNT>
165-
**[one.newrelic.com](https://one.newrelic.com/) > User profile > NRQL console > Show**
166-
</DNT>
167-
</figcaption>
168-
169-
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.
170-
</Collapser>
171142

172143
<Collapser
173144
id="nrql-alerts-nrql-intro"
174145
title="NRQL-based alerts"
175146
>
176-
<img
177-
title="NRQL condition alert and generated results"
178-
alt="A screenshot of a NRQL condition alert"
179-
src="/images/nr1_nrql_alert_conditions.webp"
180-
/>
181147

182-
<figcaption>
183-
<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>.
184-
</figcaption>
148+
* 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>.
149+
185150

186151
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.
187152
</Collapser>

src/content/docs/query-your-data/explore-query-data/browse-data/introduction-data-explorer.mdx

Lines changed: 26 additions & 62 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
---
2-
title: "Introduction to the metrics and events data explorer"
2+
title: "Introduction to the data explorer"
33
tags:
44
- Query your data
55
- Explore and query data
66
- Explore data
77
translate:
88
- jp
9-
metaDescription: "An introduction to the metric and event data explorer of New Relic."
9+
metaDescription: "An introduction to the New Relic data explorer for browsing and visualizing your data."
1010
redirects:
1111
- /docs/query-your-data/explore-query-data/introduction-data-explorer
1212
- /docs/infrastructure/new-relic-infrastructure/share-charts/share-infrastructure-data-view-insights
@@ -36,56 +36,56 @@ redirects:
3636
freshnessValidatedDate: never
3737
---
3838

39-
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).
39+
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.
4040

4141
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.
4242

4343
## Why it matters [#why-matters]
4444

45-
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.
45+
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.
4646

47-
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.
47+
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.
4848

49-
Other things metrics and events helps you do:
49+
Other things the Data Explorer helps you do:
5050

5151
* See data from different points of view: from raw data to different visualizations that provide insights on evolution, distribution, and more.
5252
* Drill down into data using filters.
5353
* 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)).
5454
* Add your searches to a [dashboard](/docs/dashboards/new-relic-one-dashboards/get-started/introduction-new-relic-one-dashboards).
55-
* Understand how [NRQL](/docs/query-data/nrql-new-relic-query-language/getting-started/introduction-nrql) works: metrics and events shows how queries are built.
55+
* Understand how [NRQL](/docs/query-data/nrql-new-relic-query-language/getting-started/introduction-nrql) works: the Data Explorer shows how queries are built.
5656

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

59-
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:
59+
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:
6060

6161
* Metrics:
6262
* [Dimensional metrics](/docs/data-apis/understand-data/new-relic-data-types/#dimensional-metrics) (the `Metric` data type).
6363
* [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.
6464
* Events: the [event data type](/docs/data-apis/understand-data/new-relic-data-types/#events-new-relic).
6565
* Logs: the `Log` data type (which you can also explore via our [logs UI](/docs/logs/ui-data/use-logs-ui)).
66-
* Traces: the `Span` data type (which you can also explore via our [trace UI](/docs/distributed-tracing/ui-data/query-distributed-trace-data)).
66+
* 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)).
6767

6868
## Explore your data [#explore-data]
6969

70-
To access the data explorer, go to <DNT>**[one.newrelic.com](https://one.newrelic.com) > All capabilities > Metrics and events**</DNT>.
70+
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.
7171

72-
Metrics and events consist of these:
72+
The Data Explorer consists of these:
7373

74-
* Scoping section on the top. You can select between `metrics` or `events` and `account`. If you select metrics, you can filter by entity.
74+
* 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.
7575
* 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`.
7676
* Workspace. This area shows you the result of your choices.
7777

7878
<img
79-
title="Metrics and events view"
80-
alt="Metrics and events view"
81-
src="/images/queries-nrql_screenshot-full_metrics-events-data-explorer.webp"
79+
title="Data Explorer view"
80+
alt="Data Explorer view"
81+
src="/images/data-explorer.gif"
8282
/>
8383

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

88-
To use metrics and events:
88+
To use the Data Explorer:
8989

9090
1. Define the scope. Select the data type (metric or event), the account, and the entities.
9191
2. Select the time range using the [time picker](/docs/query-your-data/explore-query-data/dashboards/manage-your-dashboard/#dash-time-picker).
@@ -193,16 +193,10 @@ At the working space you can see:
193193
id="workspace-query-area"
194194
title="Querying area"
195195
>
196-
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.
196+
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.
197+
Here, you can easily read the result of your exploration as an NRQL query, and check the exact data being plotted.
197198

198-
If you are not familiar with NRQL, check this area to learn about the build of the queries.
199-
200-
The different parts of the query are these:
201-
202-
* [`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.
203-
* [`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.
204-
* [`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.
205-
* [`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.
199+
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).
206200

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

214-
<Collapser
215-
className="freq-link"
216-
id="workspace-query-display"
217-
title="NRQL query display"
218-
>
219-
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.
220-
221-
<img
222-
title="Querying area in the Metrics and events view"
223-
alt="Querying area in the Metrics and events view"
224-
src="/images/queries-nrql_screenshot-crop_metrics-events-nrql-display.webp"
225-
/>
226-
</Collapser>
227-
228208
<Collapser
229209
className="freq-link"
230210
id="workspace-chart"
@@ -284,31 +264,15 @@ At the working space you can see:
284264
/>
285265

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

292-
## Visualize your custom metric after creating it [#visualize-metric]
293-
294-
Follow these steps to visualize your custom metric through the metrics explorer:
295-
296-
1. Access the data explorer, go to <DNT>**[one.newrelic.com](https://one.newrelic.com) > All capabilities > Metrics and events**</DNT>.
297-
298-
2. Choose your entity.
299-
300-
3. Click <DNT>**See timeslice metrics for `your entity`**</DNT> link.
301-
302-
<img
303-
style={{ width: "50%" }}
304-
title="See timeslice metrics for `your entity`"
305-
alt="See timeslice metrics for `your entity`"
306-
src="/images/queries-nrql_screenshot-crop_timeslice-metrics-link.webp"
307-
/>
308272

309273
## Use cases [#uses-cases]
310274

311-
See the following examples to learn how and when to use metrics and events.
275+
See the following examples to learn how and when to use the Data Explorer.
312276

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

323287
1. Select the account and event or metric that's generating the new data.
324-
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.
288+
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.
325289
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.
326290
4. Found anything relevant? Save it to a dashboard or share it with a colleague.
327291
</Collapser>
@@ -335,7 +299,7 @@ See the following examples to learn how and when to use metrics and events.
335299
**I changed a custom event/metric and need to check if this change has been successful.**
336300
</DNT>
337301

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

359-
1. Go to <DNT>**[one.newrelic.com](https://one.newrelic.com) > All capabilities > Metrics and events**</DNT>.
323+
1. Access the Data Explorer by clicking the <DNT>**Query your data**</DNT> button in the bottom drawer of any New Relic page.
360324
2. Select a line or area chart where you want to add prediction.
361325
3. From the <DNT>**Options**</DNT> menu, select <DNT>**Predict trend**</DNT>. The chart with the prediction opens in the <DNT>**Data Explorer**</DNT>.
362326
4. Save it to a dashboard.
@@ -371,7 +335,7 @@ See the following examples to learn how and when to use metrics and events.
371335
**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.**
372336
</DNT>
373337

374-
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.
338+
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.
375339
2. From there, you can drill down in the dimensions of that data and filter by those attributes that are relevant.
376340
3. You can also see that data from different perspectives: its distribution, ranking of values, or evolution over time.
377341
4. Found anything relevant? Save it to a dashboard or share it with a colleague.

src/content/docs/query-your-data/explore-query-data/get-started/introduction-querying-new-relic-data.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -96,7 +96,7 @@ Regardless of your experience with New Relic, we'll help you discover, understan
9696

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

99-
* 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.
99+
* 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.
100100
* 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).
101101
* To explore logs, you can use the [logs UI](/docs/logs/ui-data/use-logs-ui/).
102102

0 commit comments

Comments
 (0)