Skip to content

Commit 1423aee

Browse files
Merge pull request #9574 from MicrosoftDocs/Simrran_CI_7097
AB#7097: Increase Acrolinx scores to 80 or above in some Azure articles.
2 parents 397b6c1 + 563f03c commit 1423aee

File tree

8 files changed

+262
-245
lines changed

8 files changed

+262
-245
lines changed
Lines changed: 18 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1,52 +1,52 @@
11
---
2-
title: Troubleshoot Application Insights auto-instrumentation
3-
description: Helps troubleshoot problems with auto-instrumentation in Application Insights.
2+
title: Troubleshoot Application Insights Autoinstrumentation
3+
description: Provides troubleshooting help for problems in autoinstrumentation in Application Insights.
44
ms.service: azure-monitor
55
ms.custom: sap:Missing or Incorrect data after enabling Application Insights in Azure Portal
6-
ms.date: 06/24/2024
6+
ms.date: 8/26/2025
77
---
8-
# Troubleshoot Application Insights auto-instrumentation
8+
# Troubleshoot Application Insights autoinstrumentation
99

10-
This article helps you troubleshoot problems with auto-instrumentation in Application Insights.
10+
This article helps you troubleshoot problems that affect autoinstrumentation in Application Insights.
1111

1212
> [!NOTE]
13-
> Auto-instrumentation used to be known as "codeless attach" before October 2021.
13+
> Autoinstrumentation was known as "codeless attach" before October 2021.
1414
15-
## Telemetry data isn't reported after you enable auto-instrumentation
15+
## Telemetry data isn't reported after you enable autoinstrumentation
1616

17-
Review these common scenarios if you've enabled Application Insights auto-instrumentation for your app service but don't see telemetry data reported.
17+
If you enabled Application Insights autoinstrumentation for your app service but don't see telemetry data reported, review the common scenarios in the following sections.
1818

1919
### The Application Insights SDK was previously installed
2020

21-
Auto-instrumentation fails when .NET and .NET Core apps were already instrumented with the SDK.
21+
Autoinstrumentation fails if .NET and .NET Core apps already have the Application Insights SDK installed.
2222

23-
Remove the Application Insights SDK if you want to auto-instrument your app.
23+
To be able to autoinstrument your app, remove the Application Insights SDK.
2424

2525
### An app was published by using an unsupported version of .NET or .NET Core
2626

2727
Verify that a supported version of .NET or .NET Core was used to build and publish applications.
2828

29-
See the .NET or .NET Core documentation to determine if your version is supported:
29+
To determine whether your version is supported, see the following .NET or .NET Core documentation:
3030

3131
- [Application monitoring for Azure App Service and ASP.NET](/azure/azure-monitor/app/azure-web-apps-net#application-monitoring-for-azure-app-service-and-aspnet)
3232
- [Application monitoring for Azure App Service and ASP.NET Core](/azure/azure-monitor/app/azure-web-apps-net-core#application-monitoring-for-azure-app-service-and-aspnet-core)
3333

34-
### A diagnostics library was detected
34+
### A diagnostics library is detected
3535

36-
Auto-instrumentation fails if it detects the following libraries:
36+
Autoinstrumentation fails if it detects the following libraries:
3737

3838
- `System.Diagnostics.DiagnosticSource`
3939
- `Microsoft.AspNet.TelemetryCorrelation`
4040
- `Microsoft.ApplicationInsights`
4141

42-
These libraries must be removed for auto-instrumentation to succeed.
42+
For autoinstrumentation to work successfully, these libraries must be removed.
4343

44-
## You encounter issues with the Application Insights SDK itself after you enable auto-instrumentation
44+
## You encounter SDK problems after you enable autoinstrumentation
4545

46-
You can collect self-diagnostic logs for the Application Insights SDK to diagnose issues. For more information, see [How to collect self-diagnostic logs for Application Insights SDKs](enable-self-diagnostics.md).
46+
If you encounter problems that are caused by the Application Insights SDK itself after you enable autoinstrumentation, collect self-diagnostic logs to diagnose the problems. For more information, see [How to collect self-diagnostic logs for Application Insights SDKs](enable-self-diagnostics.md).
4747

48-
## More help
48+
## More information
4949

50-
If you have questions about Application Insights auto-instrumentation, you can post a question on our [Microsoft Q&A question page](/answers/topics/azure-monitor.html).
50+
If you have additional questions about Application Insights autoinstrumentation, you can post them on our [Microsoft Q&A question page](/answers/topics/azure-monitor.html).
5151

5252
[!INCLUDE [Azure Help Support](../../../../includes/azure-help-support.md)]

support/azure/cloud-services/extended/availability/allocation-failure.md

Lines changed: 26 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -1,56 +1,60 @@
11
---
2-
title: Allocation failure in Azure Cloud Services
3-
description: This article helps troubleshoot allocation failure in Azure Cloud Services (extended support).
2+
title: Allocation Failure in Azure Cloud Services
3+
description: Provides troubleshooting help for allocation failure in Azure Cloud Services (extended support).
44
ms.service: azure-cloud-services-extended-support
55
author: surbhijain16
66
ms.author: surbhijain
77
ms.reviewer: surbhijain16
8-
ms.date: 04/01/2024
8+
ms.date: 08/26/2025
99
ms.custom: sap:Service Availability and Performance
1010
---
1111

1212
# Troubleshoot allocation failure in Azure Cloud Services (extended support)
1313

14-
When you deploy instances to a Cloud Service (extended support) or add new web or worker role instances, Microsoft Azure allocates compute resources. You may occasionally receive errors when performing these operations even before you reach the Azure subscription limits. This article explains the causes of some of the common allocation failures and suggests possible remediation. The information may also be useful when you plan the deployment of your services.
14+
When you deploy instances to a Cloud Service (extended support) or add new web or worker role instances, Microsoft Azure allocates compute resources. You might occasionally receive error messages when you perform these operations. Allocation errors can occur even before you reach the Azure subscription limits. This article explains the causes of some of the common allocation failures and suggests possible solutions. This information might also be useful when you plan the deployment of your services.
1515

16-
## Background – How allocation works
16+
## How allocation works
1717

18-
The servers in Azure datacenters are partitioned into clusters. A new cloud service allocation request is attempted in multiple clusters. When the first instance is deployed to a cloud service, that cloud service gets pinned to a cluster. Any further deployments for the cloud service will happen in the same cluster. In this article, this mechanism is called "pinned to a cluster". Diagram 1 below illustrates the case of a normal allocation which is attempted in multiple clusters; Diagram 2 illustrates the case of an allocation that's pinned to Cluster 2 because that's where the existing Cloud Service CS_1 is hosted.
18+
The servers in Azure datacenters are partitioned into clusters. A new cloud service allocation request is tried in multiple clusters. When the first instance is deployed to a cloud service, that cloud service gets pinned to a cluster. Any further deployments for the cloud service occur in the same cluster. In this article, this mechanism is called "pinned to a cluster."
19+
20+
Diagram 1 illustrates the case of a normal allocation that's tried in multiple clusters. Diagram 2 illustrates the case of an allocation that's pinned to Cluster 2 because that's where the existing Cloud Service CS_1 is hosted.
1921

2022
:::image type="content" source="media/allocation-failure/allocation-failure-1.png" alt-text="Screenshot that shows cluster allocation":::
2123

22-
## Why allocation failure happens
24+
## Why allocation failure occurs
25+
26+
If an allocation request is pinned to a cluster, the possibility that the request can't find free resources increases because the available resource pool is limited to a cluster. Also, if your allocation request is pinned to a cluster, but the type of resource that you requested isn't supported by that cluster, your request fails even if the cluster has free resources.
2327

24-
When an allocation request is pinned to a cluster, there's a higher chance of failing to find free resources since the available resource pool is limited to a cluster. Furthermore, if your allocation request is pinned to a cluster but the type of resource you requested isn't supported by that cluster, your request will fail even if the cluster has free resource. Diagram 3 below illustrates the case where a pinned allocation fails because the only candidate cluster does't have free resources. Diagram 4 illustrates the case where a pinned allocation fails because the only candidate cluster doesn't support the requested virtual machine (VM) size, even though the cluster has free resources.
28+
Diagram 3 illustrates the case in which a pinned allocation fails because the only candidate cluster doesn't have free resources. Diagram 4 illustrates the case in which a pinned allocation fails because the only candidate cluster doesn't support the requested virtual machine (VM) size, even though the cluster has free resources.
2529

2630
:::image type="content" source="media/allocation-failure/allocation-failure-2.png" alt-text="Screenshot that shows cluster allocation failure":::
2731

2832
## Troubleshooting allocation failure for cloud services
2933

30-
The following table highlights the error messages for allocation failure and their solutions.
34+
The following table lists the error messages for allocation failure and their solutions.
3135

3236
| Error code | Error message |
3337
|-------|----------------------|
34-
| AllocationFailed | Allocation failed. We do not have sufficient capacity for the requested VM size in this region. Read more about improving likelihood of allocation success at <https://aka.ms/allocation-guidance> |
35-
| OverconstrainedAllocationRequest | Allocation failed. VM(s) with the following constraints cannot be allocated, because the condition is too restrictive. Please remove some constraints and try again|
36-
| ServiceAllocationFailure | Operation failed with error code 'InternalError' and error message 'An internal execution error occurred. Please retry later'|
38+
| AllocationFailed | Allocation failed. We don't have sufficient capacity for the requested VM size in this region. Read more about improving likelihood of allocation success at <https://aka.ms/allocation-guidance> |
39+
| OverconstrainedAllocationRequest | Allocation failed. VMs with the following constraints can't be allocated, because the condition is too restrictive. Remove some constraints and try again|
40+
| ServiceAllocationFailure | Operation failed with error code 'InternalError' and error message 'An internal execution error occurred. Retry later'|
3741

3842
## Common issues
3943

40-
Here are the common allocation scenarios that cause an allocation request to be pinned to a single cluster.
44+
The following common allocation scenarios cause an allocation request to be pinned to a single cluster:
4145

42-
- VIP SwapIf two cloud services are tagged swappable with one another, then both of them are allocated to the same cluster. If the cluster is nearing capacity, then request for deployment of the second cloud service may fail.
43-
- Scaling - Adding new instances to an existing cloud service must allocate in the same cluster. Small scaling requests can usually be allocated, but not always. If the cluster is nearing capacity, the request may fail.
46+
- VIP Swap: If two cloud services are tagged as swappable with each other, both are allocated to the same cluster. If the cluster is nearing capacity, a request for deployment of the second cloud service might fail.
47+
- Scaling: Adding new instances to an existing cloud service must allocate in the same cluster. Small scaling requests can usually be allocated, but not always. If the cluster is nearing capacity, the request might fail.
4448

4549
## Solutions
4650

47-
1. Redeploy to a new cloud service - This solution is likely to be most successful as it allows the platform to choose from all clusters in that region.
48-
1. Deploy the workload to a new cloud service
49-
2. Update the CNAME or A record to point traffic to the new cloud service
50-
3. Once zero traffic is going to the old site, you can delete the old cloud service. This solution should incur zero downtime.
51-
2. Delete swappable cloud services - This solution will preserve your existing DNS name, but will cause downtime to your application.
52-
1. Delete both cloud services that are swappable with each other
53-
2. Create a new deployment for both cloud services. This will re-attempt to allocation on all clusters in the region.
51+
- Redeploy to a new cloud service: This solution is likely to be the most successful because it enables the platform to choose from all clusters in that region. Follow these steps:
52+
1. Deploy the workload to a new cloud service.
53+
2. Update the CNAME or A record to point traffic to the new cloud service.
54+
3. After traffic stops going to the old site, you can delete the old cloud service. This solution should incur zero downtime.
55+
- Delete swappable cloud services: This solution preserves your existing DNS name, but creates downtime for your application. Follow these steps:
56+
1. Delete both cloud services that are swappable with each other.
57+
2. Create a new deployment for both cloud services. This action triggers a new attempt to allocate on all clusters in the region.
5458

5559
## Next steps
5660

0 commit comments

Comments
 (0)