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
Copy file name to clipboardExpand all lines: docs/real-time-hub/get-started-real-time-hub.md
+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
@@ -130,7 +130,7 @@ There are two ways you can get to the **Data sources** page:
130
130
131
131
- By selecting **Add data** button on the **Streaming Data** page.
132
132
133
-
:::image type="content" source="media/get-started-real-time-hub/streaming-data-add-data.png" alt-text="Screenshot that shows the Add data button." lightbox="./media/get-started-real-time-hub/streaming-data-add-data.png":::
133
+
:::image type="content" source="media/get-started-real-time-hub/connect-to-data-source-button.png" alt-text="Screenshot that shows the Add data button." lightbox="./media/get-started-real-time-hub/connect-to-data-source-button.png":::
134
134
- By selecting **Add data** on the left navigation menu.
135
135
136
136
:::image type="content" source="media/get-started-real-time-hub/add-data.png" alt-text="Screenshot that shows the Data sources page." lightbox="./media/get-started-real-time-hub/add-data.png":::
Copy file name to clipboardExpand all lines: docs/real-time-intelligence/manage-monitor-database.md
+21-18Lines changed: 21 additions & 18 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,14 +6,14 @@ ms.author: spelluru
6
6
author: spelluru
7
7
ms.topic: how-to
8
8
ms.custom:
9
-
ms.date: 05/06/2025
9
+
ms.date: 01/29/2026
10
10
ms.subservice: rti-eventhouse
11
11
ms.search.form: Database
12
12
#customer intent: As a user, I want to learn how to manage and monitor a KQL database so that I can effectively utilize Real-Time Intelligence.
13
13
---
14
14
# Manage and monitor a database
15
15
16
-
The main page of your KQL database shows an overview of the contents and activity of your database. You track database activity, preview tables, gain insights into the database table schemas.
16
+
The main page of your KQL database shows an overview of the contents and activity of your database. You can track data activity, preview tables, and gain insights into the database table schemas.
17
17
18
18
## Prerequisites
19
19
@@ -35,15 +35,15 @@ This page is divided into the following sections:
35
35
36
36
A. **Database ribbon**: The ribbon provides quick access to essential actions within the database.
37
37
38
-
B. **Explorer pane**: The explorer pane provides an intuitive interface for navigating between with databases.
38
+
B. **Explorer pane**: The explorer pane provides an intuitive interface for navigating between databases.
39
39
40
40
C. **Main view area**: The main view area displays the main database activities, such as querying data, ingesting data, and the database tables.
41
41
42
42
D. **Details area**: The details area provides additional information about the database.
43
43
44
44
## Manage KQL Databases
45
45
46
-
You can manage the databases in the eventhouse using the options in the [Database ribbon](#database-ribbon) or in the [Explorer pane](#explorer-pane) under **KQL Databases**.
46
+
You can manage the databases in the eventhouse by using the options in the [Database ribbon](#database-ribbon) or in the [Explorer pane](#explorer-pane) under **KQL Databases**.
47
47
48
48
### Database ribbon
49
49
@@ -53,11 +53,11 @@ The database ribbon is your quick-access action bar, offering a convenient way t
53
53
54
54
From here, you can:
55
55
56
-
***Refresh**: use this button to manually refresh the database, when live view is disabled.
56
+
***Refresh**: use this button to manually refresh the database when live view is disabled.
57
57
58
58
* Enable **Live view**: to continually refresh the database automatically, enable Live View. Disable to manually refresh the database.
59
59
60
-
* Create a **New** item in the database. This includes a table, a materialized view, a table update policy, and a OneLake shortcut.
60
+
* Create a **New** item in the database. This option includes a table, a materialized view, a table update policy, and a OneLake shortcut.
61
61
62
62
***Get data**: select the desired ingest method. To learn more, see [data formats](ingestion-supported-formats.md) and the corresponding ingestion methods.
63
63
@@ -71,7 +71,7 @@ From here, you can:
71
71
72
72
### Explorer pane
73
73
74
-
In the Explorer pane you can:
74
+
In the Explorer pane, you can:
75
75
76
76
:::image type="content" source="media/eventhouse/manage-databases.png" alt-text="Screenshot showing the eventhouse KQL Databases section.":::
77
77
@@ -93,34 +93,35 @@ In the Explorer pane you can:
93
93
94
94
## Main view area
95
95
96
-
The main database information pane tracks data activity, allows you to preview table details and data, and to view query insights.
96
+
The main database information pane tracks data activity, and it allows you to preview table details and data, and to view query insights.
97
97
98
-
At the top of the main view area, you can select these options:
98
+
At the top of the main view area, select from these options:
99
99
100
100
***Query with code**: select to open the queryset for the database.
101
101
102
-
***Overview** or **Entity diagram (preview)**: View an overview of the [Database activity tracker](#database-activity-tracker) and the [Tabs - Tables / Data preview / Query Insights](#data-insights) in the main view area, or view the database as an [entity diagram](database-entity-diagram.md).
102
+
***Overview** or **Entity diagram (preview)**: View an overview of the [Data activity tracker](#data-activity-tracker) and the [Tabs - Tables / Data preview / Query Insights](#data-insights) in the main view area, or view the database as an [entity diagram](database-entity-diagram.md).
103
103
104
104
***Share**: to share access to a database, select the database from the list and [share the database link](access-database-copy-uri.md#share-a-kql-database-link).
105
105
106
106
> [!NOTE]
107
107
> Sharing multiple databases at once isn't supported.
108
108
109
-
### Database activity tracker
109
+
### Data activity tracker
110
110
111
-
The database activity tracker displays the number of rows loaded into the database and the number or queries, in the selected time range.
111
+
The data activity tracker displays the number of rows loaded into the database and the number of queries, in the selected time range.
112
112
113
-
:::image type="content" source="media/create-database/database-activity-tracker-tooltip.png" alt-text="Screenshot of KQL database activity tracker." lightbox="media/create-database/database-activity-tracker-tooltip.png":::
113
+
:::image type="content" source="media/create-database/database-activity-tracker-tooltip.png" alt-text="Screenshot of KQL data activity tracker." lightbox="media/create-database/database-activity-tracker-tooltip.png":::
114
114
115
115
| Item| Description|
116
116
|---|---|
117
117
|**Ingestion**| The number of rows loaded into the database in the selected time range. Select **Ingestion** to view only ingestion data. Select again to view both query and ingestion data. |
118
-
|**Queries**| The number of queries that ran in the database in the selected time range. Select **Queries** to view only query data. Select again to view both query and ingestion data. <br></br> If there are failed, throttled, or canceled queries, you can open the dropdown menu to view them as a percentage compared to the total queries. <br></br> :::image type="content" source="media/create-database/queries-cancelled-menu.png" alt-text="Screenshot of percentage of queries completed.":::|
118
+
|**Queries**| The number of queries that ran in the database in the selected time range. Select **Queries** to view only query data. Select again to view both query and ingestion data. <br></br> If there are failed, throttled, or canceled queries, you can open the dropdown menu to view them as a percentage compared to the total queries. <br></br> :::image type="content" source="media/create-database/queries-cancelled-menu.png" alt-text="Screenshot of percentage of queries completed.":::|
119
119
|**Last run**| The time when the histogram was last generated.|
120
-
| Time range | The time range of the histogram display. Set ranges for one hour, six hours, three days, seven days, or 30 days. |
121
-
| Interval | Set the data aggregation interval for the histogram display. Set intervals by one minute, five minutes, one hour, 12 hours, one day, three days, and 30 days. |
120
+
| Time range | The time range of the histogram display. Set ranges for one hour, six hours, three days, 7 days, or 30 days. |
121
+
| Interval | Set the data aggregation interval for the histogram display. Set intervals by one minute, five minutes, 1 hour, 12 hours, one day, 3 days, and 30 days. |
122
122
| Refresh | Refresh your histogram manually.|
123
123
| Histogram | The query and ingestion data display side by side, each with their own vertical scale. The ingestion scale is on the left, and the query scale is on the right of the histogram.<br><br/>The ingestion histogram displays data by the interval chosen, and displays in UTC time. Hover over the histogram to display total rows ingested and total queries per status. |
124
+
|**Open query**| Open the KQL editor with the underlying query preloaded. This step allows you to modify and execute the query directly to analyze the data further. |
124
125
125
126
### Data insights
126
127
@@ -134,7 +135,9 @@ The tabs and graphs show the following information:
134
135
|---|---|
135
136
|**Tables**| View table information as **Cards** or as a **List**. Cards and lists view table name, *Compressed size*, *Last ingestion*, and *OneLake availability* or latency. </br></br>* Cards uniquely display a histogram of the database ingestion over the past seven days, the number of rows ingested in the last ingestion, and the table creator profile. </br></br>* The list view display also shows total *Row count*, *Original size*, *Compressed size*, *Last ingestion*, *Caching*, *Retention*, *OneLake* status, and *Created on*. To explore a specific table, select the name of this table from the list. For more information, see [Manage and monitor a table](manage-monitor-table.md). |
136
137
|**Data preview**| Shows a preview of the top records ingested for each table. Displays *IngestionTime*, *TableName*, and *Record*. Select **Columns** to select columns and values for a Pivot view. You can also search for keywords and use the filter tables option.|
137
-
| **Query insights** | Shows query duration, cache hit misses over time, and top queries.<br></br>* **Queries duration (sec) percentiles over time**: The query duration percentiles represent the duration values in seconds or milliseconds, below which 50%, 75%, and 90% of the query durations fall, respectively. To see the query duration details at a specific point in time, hover over the graph and the details pop up.<br></br>* **Cache hit misses over time (%)**: High cache miss percentage indicates requested data wasn't in cache, leading to longer query durations.<br></br>* **Top queries**: A list of queries that can be sorted according to most recent, longest duration, highest CPU usage, highest cold storage usage, or highest memory peak usage. You can also filter the queries by complete, failed, throttled, or canceled. To sort, use the **Top by:** menu.</br> :::image type="content" source="media/create-database/queries-top-by-menu.png" alt-text="Screenshot of queries menu to see percentage of queries completed."::: |
138
+
| **Query insights** | Shows query duration, cache hit misses over time, and top queries.<br></br>* **Queries duration (sec) percentiles over time**: The query duration percentiles represent the duration values in seconds or milliseconds, below which 50%, 75%, and 90% of the query durations fall, respectively. To see the query duration details at a specific point in time, hover over the graph and the details pop up.<br></br>* **Cache hit misses over time (%)**: High cache miss percentage indicates requested data wasn't in cache, leading to longer query durations.<br></br>* **Top queries**: A list of queries that you can sort according to most recent, longest duration, highest CPU usage, highest cold storage usage, or highest memory peak usage. You can also filter the queries by complete, failed, throttled, or canceled. To sort, use the **Top by:** menu.</br> :::image type="content" source="media/create-database/queries-top-by-menu.png" alt-text="Screenshot of queries menu to see percentage of queries completed."::: |
139
+
140
+
In most graphs, you can select the **Open query** in the ellipsis menu to open the KQL editor with the underlying query preloaded. This step allows you to modify and execute the query directly to analyze the data further.
138
141
139
142
## Database details
140
143
@@ -151,7 +154,7 @@ The right pane displays details of the selected database showing the following i
151
154
152
155
| Item| Description|
153
156
|---|---|
154
-
| Availability| Set OneLake availability to **Enabled** or **Disabled**. When OneLake availability is enabled, tables can't be renamed.|
157
+
| Availability| Set OneLake availability to **Enabled** or **Disabled**. When you enable OneLake availability, you can't rename tables.|
155
158
| Latency| The maximum time until data is available across tables in OneLake.|
156
159
| Table number |The number of tables available in OneLake. |
157
160
| OneLake path | Copy the OneLake folder path for creating shortcuts.|
0 commit comments