You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
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.
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.
Copy file name to clipboardExpand all lines: src/content/docs/nrql/get-started/introduction-nrql-new-relics-query-language.mdx
+7-42Lines changed: 7 additions & 42 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -114,17 +114,8 @@ NRQL is an acronym of New Relic query language. It's a query language similar to
114
114
115
115
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.
116
116
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.
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>
128
119
129
120
## Where can you use NRQL? [#where]
130
121
@@ -136,52 +127,26 @@ You can use NRQL across the platform to access your data. Those places include:
**[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.
148
137
</figcaption>
149
138
150
139
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.
**[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>
171
142
172
143
<Collapser
173
144
id="nrql-alerts-nrql-intro"
174
145
title="NRQL-based alerts"
175
146
>
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
-
/>
181
147
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
+
185
150
186
151
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.
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.
40
40
41
41
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.
42
42
43
43
## Why it matters [#why-matters]
44
44
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.
46
46
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.
48
48
49
-
Other things metrics and events helps you do:
49
+
Other things the Data Explorer helps you do:
50
50
51
51
* See data from different points of view: from raw data to different visualizations that provide insights on evolution, distribution, and more.
52
52
* Drill down into data using filters.
53
53
* 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)).
54
54
* 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.
56
56
57
57
## Types of data you can explore [#data-types]
58
58
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:
60
60
61
61
* Metrics:
62
62
*[Dimensional metrics](/docs/data-apis/understand-data/new-relic-data-types/#dimensional-metrics) (the `Metric` data type).
63
63
*[Metric timeslice data](/docs/data-apis/understand-data/new-relic-data-types/#timeslice-data): <InlinePopovertype="apm"/> agents, mobile agents, and the <InlinePopovertype="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.
64
64
* Events: the [event data type](/docs/data-apis/understand-data/new-relic-data-types/#events-new-relic).
65
65
* 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)).
67
67
68
68
## Explore your data [#explore-data]
69
69
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.
71
71
72
-
Metrics and events consist of these:
72
+
The Data Explorer consists of these:
73
73
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.
75
75
* 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`.
76
76
* Workspace. This area shows you the result of your choices.
<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.
86
86
</figcaption>
87
87
88
-
To use metrics and events:
88
+
To use the Data Explorer:
89
89
90
90
1. Define the scope. Select the data type (metric or event), the account, and the entities.
91
91
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:
193
193
id="workspace-query-area"
194
194
title="Querying area"
195
195
>
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.
197
198
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).
206
200
207
201
<img
208
202
title="Querying area in the Metrics and events view "
@@ -211,20 +205,6 @@ At the working space you can see:
211
205
/>
212
206
</Collapser>
213
207
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"
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.
312
276
313
277
<CollapserGroup>
314
278
<Collapser
@@ -321,7 +285,7 @@ See the following examples to learn how and when to use metrics and events.
321
285
</DNT>
322
286
323
287
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.
325
289
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.
326
290
4. Found anything relevant? Save it to a dashboard or share it with a colleague.
327
291
</Collapser>
@@ -335,7 +299,7 @@ See the following examples to learn how and when to use metrics and events.
335
299
**I changed a custom event/metric and need to check if this change has been successful.**
336
300
</DNT>
337
301
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.
339
303
2. Verify the entity is reporting data, and that all the attributes are being plotted.
340
304
3. Find the attribute you made changes to and check the update was successful.
341
305
</Collapser>
@@ -356,7 +320,7 @@ See the following examples to learn how and when to use metrics and events.
356
320
**I want to see the future trend of a line or area chart to take proactive measures based on the predicted data.**
357
321
</DNT>
358
322
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.
360
324
2. Select a line or area chart where you want to add prediction.
361
325
3. From the <DNT>**Options**</DNT> menu, select <DNT>**Predict trend**</DNT>. The chart with the prediction opens in the <DNT>**Data Explorer**</DNT>.
362
326
4. Save it to a dashboard.
@@ -371,7 +335,7 @@ See the following examples to learn how and when to use metrics and events.
371
335
**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.**
372
336
</DNT>
373
337
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.
375
339
2. From there, you can drill down in the dimensions of that data and filter by those attributes that are relevant.
376
340
3. You can also see that data from different perspectives: its distribution, ranking of values, or evolution over time.
377
341
4. Found anything relevant? Save it to a dashboard or share it with a colleague.
Copy file name to clipboardExpand all lines: src/content/docs/query-your-data/explore-query-data/get-started/introduction-querying-new-relic-data.mdx
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -96,7 +96,7 @@ Regardless of your experience with New Relic, we'll help you discover, understan
96
96
97
97
Our platform offers several experiences that don't require knowledge of NRQL or any query language:
98
98
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.
100
100
* 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).
101
101
* To explore logs, you can use the [logs UI](/docs/logs/ui-data/use-logs-ui/).
0 commit comments