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: articles/azure-monitor/app/create-workspace-resource.md
+32-36Lines changed: 32 additions & 36 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -18,16 +18,13 @@ With workspace-based resources, [Application Insights](app-insights-overview.md#
18
18
19
19
## New capabilities
20
20
21
-
With workspace-based Application Insights, you can take advantage of the latest capabilities of Azure Monitor and Log Analytics. For example:
21
+
Workspace-based Application Insights integrates with Azure Monitor and Log Analytics to enhance capabilities:
22
22
23
-
*[Customer-managed key](../logs/customer-managed-keys.md) provides encryption at rest for your data with encryption keys to which only you have access.
24
-
*[Azure Private Link](../logs/private-link-security.md) allows you to securely link Azure platform as a service (PaaS) services to your virtual network by using private endpoints.
25
-
*[Bring your own storage (BYOS) for Profiler and Snapshot Debugger](./profiler-bring-your-own-storage.md) allows you to control this data associated with Application Insights [Profiler](../profiler/profiler-overview.md) and [Snapshot Debugger](../snapshot-debugger/snapshot-debugger.md).
26
-
* Encryption-at-rest policy
27
-
* Lifetime management policy
28
-
* Network access
29
-
*[Commitment tiers](../logs/cost-logs.md#commitment-tiers) enable you to save as much as 30% compared to the pay-as-you-go price.
30
-
* Log Analytics streaming ingests data faster.
23
+
-[Customer-managed key](../logs/customer-managed-keys.md) encrypts your data at rest with keys only you access.
24
+
-[Azure Private Link](../logs/private-link-security.md) securely connects Azure PaaS services to your virtual network using private endpoints.
25
+
-[Bring your own storage (BYOS) for Profiler and Snapshot Debugger](./profiler-bring-your-own-storage.md) lets you manage data from Application Insights [Profiler](../profiler/profiler-overview.md) and [Snapshot Debugger](../snapshot-debugger/snapshot-debugger.md) with policies on encryption, lifetime, and network access.
26
+
-[Commitment tiers](../logs/cost-logs.md#commitment-tiers) offer up to a 30% saving over pay-as-you-go pricing.
27
+
- Log Analytics streaming processes data more quickly.
31
28
32
29
## Create a workspace-based resource
33
30
@@ -55,7 +52,7 @@ The [connection string](./sdk-connection-string.md?tabs=net) identifies the reso
55
52
56
53
## Configure monitoring
57
54
58
-
After you've created a workspace-based Application Insights resource, you configure monitoring.
55
+
After creating a workspace-based Application Insights resource, you configure monitoring.
After you've created a workspace-based Application Insights resource, you can modify the associated Log Analytics workspace.
289
+
After creating a workspace-based Application Insights resource, you can modify the associated Log Analytics workspace.
293
290
294
291
In the Application Insights resource pane, select **Properties** > **Change Workspace** > **Log Analytics Workspaces**.
295
292
@@ -311,33 +308,31 @@ If your system is an instance of Azure Cloud Services, there's [another method o
311
308
312
309
### About resources and connection strings
313
310
314
-
When you set up Application Insights monitoring for your web app, you create an Application Insights resource in Azure. You open this resource in the Azure portal to see and analyze the telemetry collected from your app. The resource is identified by a connection string. When you install the Application Insights package to monitor your app, you configure it with the connection string so that it knows where to send the telemetry.
311
+
When you set up Application Insights monitoring for your web app, you create an Application Insights resource in Azure. You open the resource in the Azure portal to see and analyze the telemetry collected from your app. A connection string identifies the resource. When you install the Application Insights package to monitor your app, you configure it with the connection string so that it knows where to send the telemetry.
315
312
316
313
Each Application Insights resource comes with metrics that are available out of the box. If separate components report to the same Application Insights resource, it might not make sense to alert on these metrics.
317
314
318
315
#### When to use a single Application Insights resource
319
316
320
-
Use a single Application Insights resource:
317
+
Use a single Application Insights resource for:
321
318
322
-
- For application components that are deployed together. These applications are usually developed by a single team and managed by the same set of DevOps/ITOps users.
323
-
- If it makes sense to aggregate key performance indicators, such as response durations or failure rates in a dashboard, across all of them by default. You can choose to segment by role name in the metrics explorer.
324
-
- If there's no need to manage Azure role-based access control differently between the application components.
325
-
- If you don't need metrics alert criteria that are different between the components.
326
-
- If you don't need to manage continuous exports differently between the components.
327
-
- If you don't need to manage billing/quotas differently between the components.
328
-
- If it's okay to have an API key have the same access to data from all components. And 10 API keys are sufficient for the needs across all of them.
329
-
- If it's okay to have the same smart detection and work item integration settings across all roles.
319
+
- Streamlining DevOps/ITOps management for applications deployed together, typically developed and managed by the same team.
320
+
- Centralizing key performance indicators, such as response times and failure rates, in a dashboard by default. Segment by role name in the metrics explorer if necessary.
321
+
- When there's no need for different Azure role-based access control management between application components.
322
+
- When identical metrics alert criteria, continuous exports, and billing/quotas management across components suffice.
323
+
- When it's acceptable for an API key to access data from all components equally, and 10 API keys meet the needs across all components.
324
+
- When the same smart detection and work item integration settings are suitable across all roles.
330
325
331
326
> [!NOTE]
332
327
> If you want to consolidate multiple Application Insights resources, you can point your existing application components to a new, consolidated Application Insights resource. The telemetry stored in your old resource won't be transferred to the new resource. Only delete the old resource when you have enough telemetry in the new resource for business continuity.
333
328
334
329
#### Other considerations
335
330
336
-
Be aware that:
331
+
To activate portal experiences, add custom code to assign meaningful values to the [Cloud_RoleName](./app-map.md?tabs=net#set-or-override-cloud-role-name) attribute. Without these values, portal features don't function.
337
332
338
-
- You might need to add custom code to ensure that meaningful values are set into the [Cloud_RoleName](./app-map.md?tabs=net#set-or-override-cloud-role-name) attribute. Without meaningful values set for this attribute, none of the portal experiences will work.
339
-
- For Azure Service Fabric applications and classic cloud services, the SDK automatically reads from the Azure Role Environment and sets these services. For all other types of apps, you'll likely need to set this explicitly.
340
-
-Live Metrics doesn't support splitting by role name.
333
+
For Azure Service Fabric applications and classic cloud services, the SDK automatically configures services by reading from the Azure Role Environment. For other app types, you typically need to set it explicitly.
334
+
335
+
Live Metrics can't split data by role name.
341
336
342
337
### Create more Application Insights resources
343
338
@@ -349,10 +344,10 @@ To create an Applications Insights resource, see [Create an Application Insights
349
344
#### Get the connection string
350
345
The connection string identifies the resource that you created.
351
346
352
-
You need the connection strings of all the resources to which your app will send data.
347
+
You need the connection strings of all the resources to which your app sends data.
353
348
354
349
### Filter on the build number
355
-
When you publish a new version of your app, you'll want to be able to separate the telemetry from different builds.
350
+
When you publish a new version of your app, you want to be able to separate the telemetry from different builds.
356
351
357
352
You can set the **Application Version** property so that you can filter [search](../../azure-monitor/app/transaction-search-and-diagnostics.md?tabs=transaction-search) and [metric explorer](../../azure-monitor/essentials/metrics-charts.md) results.
358
353
@@ -387,7 +382,7 @@ There are several different methods of setting the **Application Version** prope
387
382
388
383
This step generates a file called *yourProjectName*`.BuildInfo.config`. The Publish process renames it to `BuildInfo.config`.
389
384
390
-
The build label contains a placeholder (*AutoGen_...*) when you build with Visual Studio. But when built with the Microsoft Build Engine, it's populated with the correct version number.
385
+
The build label contains a placeholder `(*AutoGen_...*)` when you build with Visual Studio. But when built with the Microsoft Build Engine, it's populated with the correct version number.
391
386
392
387
To allow the Microsoft Build Engine to generate version numbers, set the version like `1.0.*` in `AssemblyReference.cs`.
393
388
@@ -403,7 +398,7 @@ To track the application version, make sure your Microsoft Build Engine process
403
398
404
399
When the Application Insights web module has the build information, it automatically adds **Application Version** as a property to every item of telemetry. For this reason, you can filter by version when you perform [diagnostic searches](../../azure-monitor/app/transaction-search-and-diagnostics.md?tabs=transaction-search) or when you [explore metrics](../../azure-monitor/essentials/metrics-charts.md).
405
400
406
-
The build version number is generated only by the Microsoft Build Engine, not by the developer build from Visual Studio.
401
+
The Microsoft Build Engine exclusively generates the build version number, not the developer build from Visual Studio.
407
402
408
403
#### Release annotations
409
404
@@ -415,13 +410,14 @@ This section provides answers to common questions.
415
410
416
411
### How do I move an Application Insights resource to a new region?
417
412
418
-
Moving existing Application Insights resources from one region to another is *currently not supported*. Historical data that you've collected *can't be migrated* to a new region. The only partial workaround is to:
419
-
420
-
1. Create a new workspace-based Application Insights resource in the new region.
421
-
1. Re-create all unique customizations specific to the original resource in the new resource.
422
-
1. Modify your application to use the new region resource's [connection string](./sdk-connection-string.md).
423
-
1. Test to confirm that everything is continuing to work as expected with your new Application Insights resource.
424
-
1. At this point, you can either keep or delete the original Application Insights resource. If you delete a classic Application Insights resource, *all historical data is lost*. If the original resource was workspace based, its data remains in Log Analytics. Keeping the original Application Insights resource allows you to access its historical data until its data retention settings run out.
413
+
Transferring existing Application Insights resources between regions isn't supported, and you can't migrate historical data to a new region. The workaround involves:
414
+
415
+
- Creating a new workspace-based Application Insights resource in the desired region.
416
+
- Re-creating any unique customizations from the original resource in the new one.
417
+
- Updating your application with the new region resource's [connection string](./sdk-connection-string.md).
418
+
- Testing to ensure everything works as expected with the new Application Insights resource.
419
+
- Decide to either keep or delete the original Application Insights resource. Deleting a classic resource means losing all historical data. If the resource is workspace-based, the data remains in Log Analytics, enabling access to historical data until the retention period expires.
420
+
425
421
426
422
Unique customizations that commonly need to be manually re-created or updated for the resource in the new region include but aren't limited to:
0 commit comments