Skip to content

Commit 1bfe9e8

Browse files
authored
Merge pull request #78254 from paulth1/time-series-insights-explorer
edit pass: time-series-insights-explorer
2 parents 53f43f6 + 597ef29 commit 1bfe9e8

File tree

1 file changed

+35
-37
lines changed

1 file changed

+35
-37
lines changed
Lines changed: 35 additions & 37 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: 'Explore data using the Azure Time Series Insights explorer | Microsoft Docs'
2+
title: 'Explore data by using the Azure Time Series Insights explorer | Microsoft Docs'
33
description: This article describes how to use the Azure Time Series Insights explorer in your web browser to quickly see a global view of your big data and validate your IoT environment.
44
ms.service: time-series-insights
55
services: time-series-insights
@@ -16,111 +16,109 @@ ms.custom: seodec18
1616

1717
# Azure Time Series Insights explorer
1818

19-
This article describes the features and options in General Availability for the Azure Time Series Insights [explorer web app](https://insights.timeseries.azure.com/). The Time Series Insights explorer demonstrates the powerful data visualization capabilities provided by the service and can be accessed within your own environment.
19+
This article describes the features and options in general availability for the Azure Time Series Insights [explorer web app](https://insights.timeseries.azure.com/). The Time Series Insights explorer demonstrates the powerful data visualization capabilities provided by the service and can be accessed within your own environment.
2020

2121
Azure Time Series Insights is a fully managed analytics, storage, and visualization service that makes it simple to explore and analyze billions of IoT events simultaneously. It gives you a global view of your data, which lets you quickly validate your IoT solution and avoid costly downtime to mission-critical devices. You can discover hidden trends, spot anomalies, and conduct root-cause analyses in near real time. The Time Series Insights explorer is currently in public preview.
2222

2323
> [!TIP]
24-
> For a guided tour through the demonstration environment, read the [Azure Time Series Insights Quickstart](time-series-quickstart.md).
24+
> For a guided tour through the demonstration environment, read the [Azure Time Series Insights quickstart](time-series-quickstart.md).
2525
2626
## Video
2727

28-
### Learn about querying data using the Time Series Insights explorer. </br>
28+
### Learn about querying data by using the Time Series Insights explorer. </br>
2929

3030
> [!VIDEO https://www.youtube.com/embed/SHFPZvrR71s]
3131
3232
>[!NOTE]
33-
>See the preceding video <a href="https://www.youtube.com/watch?v=6ehNf6AJkFo">"Getting started with TSI using an Azure IoT Solution Accelerator"</a>.
33+
>See the preceding video <a href="https://www.youtube.com/watch?v=6ehNf6AJkFo">"Getting started with Time Series Insights by using an Azure IoT Solution Accelerator."</a>
3434
3535
## Prerequisites
3636

3737
Before you can use Time Series Insights explorer, you must:
3838

3939
- Create a Time Series Insights environment. For more information, see [How to get started with Time Series Insights](./time-series-insights-get-started.md).
4040
- [Provide access](time-series-insights-data-access.md) to your account in the environment.
41-
- Add an [IoT Hub](time-series-insights-how-to-add-an-event-source-iothub.md) or [Event Hub](time-series-insights-how-to-add-an-event-source-eventhub.md) event source to it.
41+
- Add an [IoT hub](time-series-insights-how-to-add-an-event-source-iothub.md) or [event hub](time-series-insights-how-to-add-an-event-source-eventhub.md) event source to it.
4242

4343
## Explore and query data
4444

4545
Within minutes of connecting your event source to your Time Series Insights environment, you can explore and query your time series data.
4646

47-
1. To start, open the [Time Series Insights explorer](https://insights.timeseries.azure.com/) in your web browser, and select an environment on the left side of the window. All environments that you have access to are listed in alphabetical order.
47+
1. To start, open the [Time Series Insights explorer](https://insights.timeseries.azure.com/) in your web browser. On the left side of the window, select an environment. All environments that you have access to are listed in alphabetical order.
4848

49-
1. Once you select an environment, either use the **FROM** and **TO** configurations at the top, or click and drag over your desired time span. Click the magnifying glass at the top right, or right-click over the selected timespan and select **Search**.
49+
1. After you select an environment, either use the **From** and **To** configurations at the top, or click and drag over the timespan you want. Select the magnifying glass in the upper-right corner, or right-click on the selected timespan and select **Search**.
5050

51-
1. You can also refresh availability automatically every minute, by selecting the **Auto On** button. The **Auto-On** button only applies to the availability chart, not the content of the main visualization.
51+
1. You also can refresh availability automatically every minute by selecting the **Auto On** button. The **Auto On** button only applies to the availability chart, not the content of the main visualization.
5252

53-
1. Notice, the Azure cloud icon takes you to your environment in the Azure portal.
53+
1. The Azure cloud icon takes you to your environment in the Azure portal.
5454

5555
[![Time Series Insights environment](media/time-series-insights-explorer/explorer1.png)](media/time-series-insights-explorer/explorer1.png#lightbox)
5656

57-
1. Next, you see a chart that shows a count of all events during the selected timespan. Here you have a number of controls:
57+
1. Next, you see a chart that shows a count of all events during the selected timespan. Here you have a number of controls:
5858

59-
**Terms Editor Panel**: The term space is where you query your environment. It’s found on the left-hand side of the screen:
60-
- **Measure**: This drop down shows all numeric columns (**Doubles**)
61-
- **Split By**: This drop down shows categorical columns (**Strings**)
62-
- You can enable step interpolation, show minimum and maximum, and adjust the Y-axis from the control panel next to measure. Additionally, you can adjust whether data shown is a count, average, or sum of the data.
63-
- You can add up to five terms to view on the same X-axis. Use the **copy-down** button to add an additional term or click the **Add** button to add a fresh term.
59+
- **Terms Editor panel**: The term space is where you query your environment. It’s found on the left side of the screen:
60+
- **Measure**: This drop-down list shows all numeric columns (**Doubles**).
61+
- **Split by**: This drop-down list shows categorical columns (**Strings**).
62+
- You can enable step interpolation, show minimum and maximum, and adjust the y-axis from the control panel next to **Measure**. You also can adjust whether data shown is a count, average, or sum of the data.
63+
- You can add up to five terms to view on the same x-axis. Use the **Copy-down** button to add an additional term, or select **Add** to add a fresh term.
6464

6565
[![Terms Editor panel](media/time-series-insights-explorer/explorer2.png)](media/time-series-insights-explorer/explorer2.png#lightbox)
6666

67-
- **Predicate**: The predicate enables you to quickly filter your events using the set of operands listed below. If you conduct a search by selecting/clicking, the predicate will automatically update based on that search. Supported operand types include:
67+
- **Predicate**: Use the predicate to quickly filter your events by using the set of operands listed in the following table. If you conduct a search by selecting or clicking, the predicate automatically updates based on that search. Supported operand types include:
6868

6969
|Operation |Supported types |Notes |
7070
|---------|---------|---------|
7171
|`<`, `>`, `<=`, `>=` | Double, DateTime, TimeSpan | |
7272
|`=`, `!=`, `<>` | String, Bool, Double, DateTime, TimeSpan, NULL | |
7373
|IN | String, Bool, Double, DateTime, TimeSpan, NULL | All operands should be of the same type or be NULL constant. |
74-
|HAS | String | Only constant string literals are allowed at right-hand side. Empty string and NULL are not allowed. |
74+
|HAS | String | Only constant string literals are allowed at the right side. Empty string and NULL aren't allowed. |
7575

7676
- **Examples of queries**
7777

7878
[![Example queries](media/time-series-insights-explorer/explorer9.png)](media/time-series-insights-explorer/explorer9.png#lightbox)
7979

80-
1. The **Interval Size** slider tool enables you to zoom in and out of intervals over the same timespan. This provides more precise control of movement between large slices of time that show smooth trends down to slices as small as the millisecond, allowing you to see granular, high-resolution cuts of your data. The slider’s default starting point is set as the most optimal view of the data from your selection; balancing resolution, query speed, and granularity.
80+
1. You can use the **Interval Size** slider tool to zoom in and out of intervals over the same timespan. The slider provides more precise control of movement between large slices of time that show smooth trends down to slices as small as the millisecond, which allow you to see granular, high-resolution cuts of your data. The slider’s default starting point is set as the most optimal view of the data from your selection to balance resolution, query speed, and granularity.
8181

82-
1. The **Time brush** tool makes it easy to navigate from one time span to another, putting intuitive UX front and center for seamless movement between time ranges.
82+
1. The **Time brush** tool makes it easy to navigate from one timespan to another.
8383

84-
1. The **Save** command lets you save your current query and enable it for sharing with other users of the environment. Using **Open**, you can see all of your saved queries and any shared queries of other users in environments you have access to.
84+
1. Use the **Save** command to save your current query and share it with other users of the environment. When you use **Open**, you can see all of your saved queries and any shared queries of other users in environments you have access to.
8585

8686
[![Queries](media/time-series-insights-explorer/explorer3.png)](media/time-series-insights-explorer/explorer3.png#lightbox)
8787

8888
## Visualize data
8989

90-
1. The **Perspective View** tool provides a simultaneous view of up to four unique queries. You can find the perspective view button in the upper right corner of the chart.
90+
1. Use the **Perspective View** tool for a simultaneous view of up to four unique queries. The **Perspective View** button is in the upper-right corner of the chart.
9191

9292
[![Perspective view](media/time-series-insights-explorer/explorer4.png)](media/time-series-insights-explorer/explorer4.png#lightbox)
9393

94-
1. The **Chart** lets you visually explore your data. Chart tools include:
94+
1. View a chart to visually explore your data, and use the **Chart** tools:
9595

96-
- **Select/click**, which enables a selection of a specific timespan or of a single data series.
97-
- Within a time span selection, you can zoom or explore events.
96+
- **Select** or **click** a specific timespan or a single data series.
97+
- Within a timespan selection, you can zoom or explore events.
9898
- Within a data series, you can split the series by another column, add the series as a new term, show only the selected series, exclude the selected series, ping that series, or explore events from the selected series.
99-
- In the filter area to the left of the chart, you can see all displayed data series and reorder by value or name, view all data series, or any pinned or unpinned series. You can also select a single data series and split the series by another column, add the series as a new term, show only the selected series, exclude the selected series, pin that series, or explore events from the selected series.
100-
- When viewing multiple terms simultaneously, you can stack, unstack, see additional data about a data series, and use the same Y-axis across all terms with the buttons in the top right-hand corner of the chart.
99+
- In the filter area to the left of the chart, you can see all displayed data series and reorder by value or name. You also can view all data series or any pinned or unpinned series. You can select a single data series and split the series by another column, add the series as a new term, show only the selected series, exclude the selected series, pin that series, or explore events from the selected series.
100+
- When you view multiple terms simultaneously, you can stack, unstack, see additional data about a data series, and use the same y-axis across all terms. Use the buttons in the upper-right corner of the chart.
101101

102102
[![Chart tool](media/time-series-insights-explorer/explorer5.png)](media/time-series-insights-explorer/explorer5.png#lightbox)
103103

104-
1. The **heatmap** can be used to quickly spot unique or anomalous data series in a given query. Only one search term can be visualized as a heatmap.
104+
1. Use the **heatmap** to quickly spot unique or anomalous data series in a given query. Only one search term can be visualized as a heatmap.
105105

106106
[![Heatmap](media/time-series-insights-explorer/explorer6.png)](media/time-series-insights-explorer/explorer6.png#lightbox)
107107

108-
1. **Events**: When you choose explore events when selecting or right-clicking above, the events panel is made available. Here, you can see all of your raw events and export your events as JSON or CSV files. Time Series Insights stores all raw data.
108+
1. When you explore events by selecting or right-clicking, the **Events** panel is made available. Here, you can see all of your raw events and export your events as JSON or CSV files. Time Series Insights stores all raw data.
109109

110110
[![Events](media/time-series-insights-explorer/explorer7.png)](media/time-series-insights-explorer/explorer7.png#lightbox)
111111

112-
1. Click the **STATS** tab after exploring events to expose patterns and column stats.
112+
1. Select the **STATS** tab after you explore events to expose patterns and column stats.
113113

114-
- **Patterns**: this feature proactively surfaces the most statistically significant patterns in a selected data region. This relieves you from having to look at thousands of events to understand what patterns most warrant time and energy. Further, Time Series Insights enables you to jump directly into these statistically significant patterns to continue conducting an analysis. This feature is also helpful for post-mortem investigations into historical data.
115-
116-
- **Column Stats**: Column stats provide charting and tables that break down data from each column of the selected data series over the selected time span.
114+
- **Patterns**: This feature proactively surfaces the most statistically significant patterns in a selected data region. You don't have to look at thousands of events to understand what patterns require the most time and energy. With Time Series Insights, you can jump directly into these statistically significant patterns to continue conducting an analysis. This feature is also helpful for post-mortem investigations into historical data.
115+
- **Column Stats**: Column stats provide charts and tables that break down data from each column of the selected data series over the selected timespan.
117116

118117
[![STATS](media/time-series-insights-explorer/explorer8.png)](media/time-series-insights-explorer/explorer8.png#lightbox)
119118

120-
Now you have seen the various features and options available within the Time Series Insights explorer web app.
119+
Now you've seen the various features and options that are available within the Time Series Insights explorer web app.
121120

122121
## Next steps
123122

124-
- Learn about [diagnosing and solving problems](time-series-insights-diagnose-and-solve-problems.md) in your Time Series Insights environment.
125-
126-
- Take the guided [Azure Time Series Insights Quickstart](time-series-quickstart.md) tour.
123+
- Learn how to [diagnose and solve problems](time-series-insights-diagnose-and-solve-problems.md) in your Time Series Insights environment.
124+
- Take the guided [Azure Time Series Insights quickstart](time-series-quickstart.md) tour.

0 commit comments

Comments
 (0)