Skip to content

Commit e9ab733

Browse files
committed
updates
1 parent 140d277 commit e9ab733

File tree

5 files changed

+62
-49
lines changed

5 files changed

+62
-49
lines changed

articles/azure-monitor/app/apm-tables.md

Lines changed: 46 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,41 @@
11
---
2-
title: Release annotations for Application Insights | Microsoft Docs
3-
description: Add deployment or build markers to your metrics explorer charts in Application Insights.
2+
title: Azure Monitor Application Insights workspace-based resource schema
3+
description: Learn about the new table structure and schema for Azure Monitor Application Insights workspace-based resources.
44
ms.topic: conceptual
5-
ms.date: 07/01/2019
5+
author: mrbullwinkle
6+
ms.author: mbullwin
7+
ms.date: 05/09/2020
68

79
---
810

9-
# T
11+
# Workspace-based resource changes (preview)
1012

13+
Prior to the introduction of [workspace-based Application Insights resources](create-workspace-resource.md), Application Insights data was stored separate from other log data in Azure Monitor. Both are based on Azure Data Explorer and use the same Kusto Query Language (KQL). This is described in [Logs in Azure Monitor](https://docs.microsoft.com/azure/azure-monitor/platform/data-platform-logs).
1114

12-
## AppAvailabilityResults
15+
With workspace-based Application Insights resources data is stored in a Log Analytics workspace with other monitoring data and application data. This simplifies your configuration by allowing you to more easily analyze data across multiple solutions and to leverage the capabilities of workspaces.
16+
17+
## Table structure
18+
19+
| Legacy table name | New table name | Description |
20+
|:---|:---|:---|
21+
| availabilityResults | AppAvailabilityResults | Summary data from availability tests.|
22+
| browserTimings | AppBrowserTimings | Data about client performance, such as the time taken to process the incoming data.|
23+
| dependencies | AppDependencies | Calls from the application to other components (including external components) recorded via TrackDependency() – for example, calls to REST API, database or a file system. |
24+
| customEvents | AppEvents | Custom events created by your application. |
25+
| customMetrics | AppMetrics | Custom metrics created by your application. |
26+
| pageViews | AppPageViews| Data about each website view with browser information. |
27+
| performanceCounters | AppPerformanceCounters | Performance measurements from the compute resources supporting the application, for example, Windows performance counters. |
28+
| requests | AppRequests | Requests received by your application. For example, a separate request record is logged for each HTTP request that your web app receives. |
29+
| exceptions | AppSystemEvents | Exceptions thrown by the application runtime, captures both server side and client-side (browsers) exceptions. |
30+
| traces | AppTraces | Detailed logs (traces) emitted through application code/logging frameworks recorded via TrackTrace(). |
31+
32+
## Table schemas
33+
34+
The following sections show the mapping between the classic property names and the new workspace-based Application Insights property names. Use this information to convert any queries using legacy tables.
35+
36+
Most of the columns have the same name with different capitalization. Since KQL is case-sensitive, you will need to change each column name along with the table names in existing queries. Columns with changes in addition to capitalization are highlighted. You can still use your classic Application Insights queries within the **Logs** pane of your Application Insights resource, even if it is a workspace-based resource. The new property names are required for when querying from within the context of the Log Analytics workspace experience.
37+
38+
### AppAvailabilityResults
1339

1440
Legacy table: availability
1541

@@ -31,7 +57,7 @@ Legacy table: availability
3157
|customDimensions|dynamic|Properties|Dynamic|
3258
|customMeasurements|dynamic|Measurements|Dynamic|
3359
|duration|real|DurationMs|real|
34-
|id|string|Id|string|
60+
|`id`|string|`Id`|string|
3561
|iKey|string|IKey|string|
3662
|itemCount|int|ItemCount|int|
3763
|itemId|string|\_ItemId|string|
@@ -53,9 +79,7 @@ Legacy table: availability
5379
|user_AuthenticatedId|string|UserAuthenticatedId|string|
5480
|user_Id|string|UserId|string|
5581

56-
57-
58-
## AppBrowserTimings
82+
### AppBrowserTimings
5983

6084
Legacy table: browserTimings
6185

@@ -99,9 +123,7 @@ Legacy table: browserTimings
99123
|user_AuthenticatedId|string|UserAuthenticatedId|string|
100124
|user_Id|string|UserId|string|
101125

102-
103-
104-
## AppDependencies
126+
### AppDependencies
105127

106128
Legacy table: dependencies
107129

@@ -124,7 +146,7 @@ Legacy table: dependencies
124146
|customMeasurements|dynamic|Measurements|Dynamic|
125147
|data|string|Data|string|
126148
|duration|real|DurationMs|real|
127-
|id|string|Id|string|
149+
|`id`|string|`Id`|string|
128150
|iKey|string|IKey|string|
129151
|itemCount|int|ItemCount|int|
130152
|itemId|string|\_ItemId|string|
@@ -146,8 +168,7 @@ Legacy table: dependencies
146168
|user_AuthenticatedId|string|UserAuthenticatedId|string|
147169
|user_Id|string|UserId|string|
148170

149-
150-
## AppEvents
171+
### AppEvents
151172

152173
Legacy table: customEvents
153174

@@ -184,8 +205,7 @@ Legacy table: customEvents
184205
|user_AuthenticatedId|string|UserAuthenticatedId|string|
185206
|user_Id|string|UserId|string|
186207

187-
188-
## AppMetrics
208+
### AppMetrics
189209

190210
Legacy table: customMetrics
191211

@@ -226,8 +246,7 @@ Legacy table: customMetrics
226246
|valueStdDev|real|ValueStdDev|real|
227247
|valueSum|real|ValueSum|real|
228248

229-
230-
## AppPageViews
249+
### AppPageViews
231250

232251
Legacy table: pageViews
233252

@@ -249,7 +268,7 @@ Legacy table: pageViews
249268
|customDimensions|dynamic|Properties|Dynamic|
250269
|customMeasurements|dynamic|Measurements|Dynamic|
251270
|duration|real|DurationMs|real|
252-
|id|string|Id|string|
271+
|`id`|string|`Id`|string|
253272
|iKey|string|IKey|string|
254273
|itemCount|int|ItemCount|int|
255274
|itemId|string|\_ItemId|string|
@@ -268,8 +287,7 @@ Legacy table: pageViews
268287
|user_AuthenticatedId|string|UserAuthenticatedId|string|
269288
|user_Id|string|UserId|string|
270289

271-
272-
## AppPerformanceCounters
290+
### AppPerformanceCounters
273291

274292
Legacy table: performanceCounters
275293

@@ -308,8 +326,7 @@ Legacy table: performanceCounters
308326
|user_Id|string|UserId|string|
309327
|value|real|Value|real|
310328

311-
312-
## AppRequests
329+
### AppRequests
313330

314331
Legacy table: requests
315332

@@ -331,7 +348,7 @@ Legacy table: requests
331348
|customDimensions|dynamic|Properties|Dynamic|
332349
|customMeasurements|dynamic|Measurements|Dynamic|
333350
|duration|real|DurationMs|Real|
334-
|id|string|Id|String|
351+
|`id`|string|`Id`|String|
335352
|iKey|string|IKey|string|
336353
|itemCount|int|ItemCount|int|
337354
|itemId|string|\_ItemId|string|
@@ -353,8 +370,7 @@ Legacy table: requests
353370
|user_AuthenticatedId|string|UserAuthenticatedId|string|
354371
|user_Id|string|UserId|string|
355372

356-
357-
## AppSystemEvents
373+
### AppSystemEvents
358374

359375
Legacy table: exceptions
360376

@@ -406,8 +422,7 @@ Legacy table: exceptions
406422
|user_AuthenticatedId|string|UserAuthenticatedId|string|
407423
|user_Id|string|UserId|string|
408424

409-
410-
## AppTraces
425+
### AppTraces
411426

412427
Legacy table: traces
413428

@@ -445,9 +460,7 @@ Legacy table: traces
445460
|user_AuthenticatedId|string|UserAuthenticatedId|string|
446461
|user_Id|string|UserId|string|
447462

448-
449-
450463
## Next steps
451464

452-
* [Create work items](../../azure-monitor/app/diagnostic-search.md#create-work-item)
453-
* [Automation with PowerShell](../../azure-monitor/app/powershell.md)
465+
* [Explore metrics](../../azure-monitor/platform/metrics-charts.md)
466+
* [Write Analytics queries](../../azure-monitor/app/analytics.md)

articles/azure-monitor/app/create-workspace-resource.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
2-
title: Create a new Azure Application Insights resource | Microsoft Docs
3-
description: Manually set up Application Insights monitoring for a new live application.
2+
title: Create a new Azure Monitor Application Insights workspace-based resource | Microsoft Docs
3+
description: Learn about the steps required to enable the new Azure Monitor Application Insights workspace-based resources.
44
author: mrbullwinkle
55
ms.author: mbullwin
66
ms.topic: conceptual
@@ -32,7 +32,7 @@ Once your resource is created, you will see the corresponding workspace info in
3232
Clicking the blue link text will take you to the associated Log Analytics workspace where you can take advantage of the new unified workspace query environment.
3333

3434
> [!NOTE]
35-
> We still provide full backwards compatibility for your Application Insights classic resource queries, workbooks, and log-based alerts within the Application Insights experience. To query/view against the new workspace-based table structure/schema you must first navigate to your Log Analytics workspace. During the preview, selecting **Logs** from within the Application Insights panes will give you access to the classic Application Insights query experience.
35+
> We still provide full backwards compatibility for your Application Insights classic resource queries, workbooks, and log-based alerts within the Application Insights experience. To query/view against the [new workspace-based table structure/schema](apm-tables.md) you must first navigate to your Log Analytics workspace. During the preview, selecting **Logs** from within the Application Insights panes will give you access to the classic Application Insights query experience.
3636
3737
## Copy the connection string
3838

@@ -42,7 +42,7 @@ The [connection string]() identifies the resource that you want to associate you
4242

4343
## Monitoring configuration
4444

45-
Once a workspace-based Application Insights resource has been created, configuring monitoring is relatively straightforward.
45+
Once a workspace-based Application Insights resource has been created, configuring monitoring is relatively straightforward.
4646

4747
### Code-based application monitoring
4848

@@ -65,7 +65,7 @@ For codeless monitoring of services like Azure Functions and Azure App Services,
6565

6666
While these services offer the option to create a new Application Insights resource within their own resource creation process, resources created via these UI options are currently restricted to the classic Application Insights experience.
6767

68-
The same applies to the resource creation experience in Visual Studio. You must select an existing workspace-based resource from with the Visual Studio monitoring enablement UI. Selecting create new resource from within Visual Studio will create a classic Application Insights resource.
68+
The same applies to the Application Insights resource creation experience in Visual Studio for ASP.NET and ASP.NET Core. You must select an existing workspace-based resource from with the Visual Studio monitoring enablement UI. Selecting create new resource from within Visual Studio will limit you to creating a classic Application Insights resource.
6969

7070
## Creating a resource automatically
7171

articles/azure-monitor/log-query/app-expression.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ ms.subservice: logs
55
ms.topic: conceptual
66
author: bwren
77
ms.author: bwren
8-
ms.date: 05/01/2019
8+
ms.date: 05/09/2019
99

1010
---
1111

@@ -14,7 +14,7 @@ ms.date: 05/01/2019
1414
The `app` expression is used in an Azure Monitor query to retrieve data from a specific Application Insights app in the same resource group, another resource group, or another subscription. This is useful to include application data in an Azure Monitor log query and to query data across multiple applications in an Application Insights query.
1515

1616
> [!IMPORTANT]
17-
> The app() expression is not used if you're using APM 2.1 since Application Insights log data is stored in a Log Analytics workspace. Use the log() expression to write a query that includes application in multiple workspaces. For multiple applications in the same workspace, you don't need a cross workspace query.
17+
> The app() expression is not used if you're using a [workspace-based Application Insights resource](../app/create-workspace-resource.md) since log data is stored in a Log Analytics workspace. Use the log() expression to write a query that includes application in multiple workspaces. For multiple applications in the same workspace, you don't need a cross workspace query.
1818
1919
## Syntax
2020

articles/azure-monitor/log-query/cross-workspace-query.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ ms.date: 05/01/2020
1212
# Perform cross-resource log queries in Azure Monitor
1313

1414
> [!IMPORTANT]
15-
> If you are using APM 2.1, then Application Insights applications are stored in a Log Analytics workspace with all other log data. Use the log() expression to write a query that includes application in multiple workspaces. For multiple applications in the same workspace, you don't need a cross workspace query.
15+
> If you are using a [workspace-based Application Insights resource](../app/create-workspace-resource.md) telemetry is stored in a Log Analytics workspace with all other log data. Use the log() expression to write a query that includes application in multiple workspaces. For multiple applications in the same workspace, you don't need a cross workspace query.
1616
1717
Previously with Azure Monitor, you could only analyze data from within the current workspace, and it limited your ability to query across multiple workspaces defined in your subscription. Additionally, you could only search telemetry items collected from your web-based application with Application Insights directly in Application Insights or from Visual Studio. This also made it a challenge to natively analyze operational and application data together.
1818

articles/azure-monitor/log-query/logs-structure.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ ms.subservice: logs
55
ms.topic: conceptual
66
author: bwren
77
ms.author: bwren
8-
ms.date: 05/01/2020
8+
ms.date: 05/09/2020
99

1010
---
1111

@@ -16,7 +16,7 @@ The ability to quickly gain insights into your data using a [log query](log-quer
1616
Data in Azure Monitor Logs is stored in either a Log Analytics workspace or an Application Insights application. Both are powered by [Azure Data Explorer](/azure/data-explorer/) meaning that they leverage its powerful data engine and query language.
1717

1818
> [!IMPORTANT]
19-
> If you are using APM 2.1, then Application Insights applications are stored in a Log Analytics workspace with all other log data. The tables have been renamed and restructured but have the same information as the tables in the Application Insights application.
19+
> If you are using a [workspace-based Application Insights resource](../app/create-workspace-resource.md), telemetry is stored in a Log Analytics workspace with all other log data. The tables have been renamed and restructured but have the same information as the tables in the Application Insights application.
2020
2121
Data in both workspaces and applications is organized into tables, each of which stores different kinds of data and has its own unique set of properties. Most [data sources](../platform/data-sources.md) will write to their own tables in a Log Analytics workspace, while Application Insights will write to a predefined set of tables in an Application Insights application. Log queries are very flexible allowing you to easily combine data from multiple tables and even use a cross-resource query to combine data from tables in multiple workspaces or to write queries that combine workspace and application data.
2222

@@ -49,7 +49,7 @@ See [Designing an Azure Monitor Logs deployment](../platform/design-logs-deploym
4949
## Application Insights application
5050

5151
> [!IMPORTANT]
52-
> If you are using APM 2.1, then Application Insights applications are stored in a Log Analytics workspace with all other log data. The tables have been renamed and restructured but have the same information as the tables in the Application Insights application.
52+
> If you are using a [workspace-based Application Insights resource](../app/create-workspace-resource.md) telemetry is stored in a Log Analytics workspace with all other log data. The tables have been renamed and restructured but have the same information as the tables in a classic Application Insights resource.
5353
5454
When you create an application in Application Insights, a corresponding application is automatically created in Azure Monitor Logs. No configuration is required to collect data, and the application will automatically write monitoring data such as page views, requests, and exceptions.
5555

@@ -61,12 +61,12 @@ Unlike a Log Analytics workspace, an Application Insights application has a fixe
6161
| browserTimings | Data about client performance, such as the time taken to process the incoming data. |
6262
| customEvents | Custom events created by your application. |
6363
| customMetrics | Custom metrics created by your application. |
64-
| dependencies | Calls from the application to external components. |
65-
| exceptions | Exceptions thrown by the application runtime. |
64+
| dependencies | Calls from the application to other components (including external components) recorded via TrackDependency() – for example, calls to REST API, database or a file system. |
65+
| exceptions | Exceptions thrown by the application runtime, captures both server side and client-side (browsers) exceptions.|
6666
| pageViews | Data about each website view with browser information. |
67-
| performanceCounters | Performance measurements from the compute resources supporting the application. |
68-
| requests | Details of each application request. |
69-
| traces | Results from distributed tracing. |
67+
| performanceCounters | Performance measurements from the compute resources supporting the application, for example, Windows performance counters. |
68+
| requests | Requests received by your application. For example, a separate request record is logged for each HTTP request that your web app receives. |
69+
| traces | Detailed logs (traces) emitted through application code/logging frameworks recorded via TrackTrace(). |
7070

7171
You can view the schema for each table in the **Schema** tab in Log Analytics for the application.
7272

0 commit comments

Comments
 (0)