Skip to content

Commit fdccf9e

Browse files
committed
Removing article with duplicate info
1 parent 84832bb commit fdccf9e

File tree

2 files changed

+37
-41
lines changed

2 files changed

+37
-41
lines changed

.openpublishing.redirection.azure-monitor.json

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -6514,11 +6514,6 @@
65146514
"redirect_url": "/previous-versions/azure/azure-monitor/app/sampling",
65156515
"redirect_document_id": false
65166516
},
6517-
{
6518-
"source_path_from_root": "/articles/azure-monitor/app/resource-manager-app-resource.md",
6519-
"redirect_url": "/previous-versions/azure/azure-monitor/app/create-workspace-resource",
6520-
"redirect_document_id": false
6521-
},
65226517
{
65236518
"source_path_from_root": "/articles/azure-monitor/app/tutorial-asp-net-core.md",
65246519
"redirect_url": "/previous-versions/azure/azure-monitor/app/tutorial-asp-net-core",
@@ -6609,6 +6604,11 @@
66096604
"redirect_url": "/azure/azure-monitor/app/java-get-started-supplemental",
66106605
"redirect_document_id": false
66116606
},
6607+
{
6608+
"source_path_from_root": "/articles/azure-monitor/app/resource-manager-app-resource.md",
6609+
"redirect_url": "/azure/azure-monitor/app/create-workspace-resource",
6610+
"redirect_document_id": false
6611+
},
66126612
{
66136613
"source_path_from_root": "/articles/azure-monitor/partners.md",
66146614
"redirect_url": "/azure/azure-monitor/overview#integrate",

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

Lines changed: 32 additions & 36 deletions
Original file line numberDiff line numberDiff line change
@@ -18,16 +18,13 @@ With workspace-based resources, [Application Insights](app-insights-overview.md#
1818
1919
## New capabilities
2020

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:
2222

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.
3128

3229
## Create a workspace-based resource
3330

@@ -55,7 +52,7 @@ The [connection string](./sdk-connection-string.md?tabs=net) identifies the reso
5552

5653
## Configure monitoring
5754

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.
5956

6057
### Code-based application monitoring
6158

@@ -289,7 +286,7 @@ resource component 'Microsoft.Insights/components@2020-02-02' = {
289286

290287
## Modify the associated workspace
291288

292-
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.
293290

294291
In the Application Insights resource pane, select **Properties** > **Change Workspace** > **Log Analytics Workspaces**.
295292

@@ -311,33 +308,31 @@ If your system is an instance of Azure Cloud Services, there's [another method o
311308

312309
### About resources and connection strings
313310

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.
315312

316313
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.
317314

318315
#### When to use a single Application Insights resource
319316

320-
Use a single Application Insights resource:
317+
Use a single Application Insights resource for:
321318

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.
330325

331326
> [!NOTE]
332327
> 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.
333328
334329
#### Other considerations
335330

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.
337332

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.
341336

342337
### Create more Application Insights resources
343338

@@ -349,10 +344,10 @@ To create an Applications Insights resource, see [Create an Application Insights
349344
#### Get the connection string
350345
The connection string identifies the resource that you created.
351346

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.
353348

354349
### 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.
356351

357352
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.
358353

@@ -387,7 +382,7 @@ There are several different methods of setting the **Application Version** prope
387382

388383
This step generates a file called *yourProjectName*`.BuildInfo.config`. The Publish process renames it to `BuildInfo.config`.
389384

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.
391386

392387
To allow the Microsoft Build Engine to generate version numbers, set the version like `1.0.*` in `AssemblyReference.cs`.
393388

@@ -403,7 +398,7 @@ To track the application version, make sure your Microsoft Build Engine process
403398

404399
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).
405400

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.
407402

408403
#### Release annotations
409404

@@ -415,13 +410,14 @@ This section provides answers to common questions.
415410

416411
### How do I move an Application Insights resource to a new region?
417412

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+
425421
426422
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:
427423

0 commit comments

Comments
 (0)