Skip to content

Commit c459e0b

Browse files
authored
Merge branch 'MicrosoftDocs:main' into docs-editor/health-checks-1749202991
2 parents 4733461 + f94173b commit c459e0b

File tree

44 files changed

+574
-369
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

44 files changed

+574
-369
lines changed

.openpublishing.redirection.developer.json

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6374,6 +6374,14 @@
63746374
{
63756375
"source_path": "support/sql/connect/check-mdac-version.md",
63766376
"redirect_url": "/previous-versions/troubleshoot/sql/connect/check-mdac-version"
6377+
},
6378+
{
6379+
"source_path": "support/sql/database-engine/replication/apply-hotfix-sql-replication-topology.md",
6380+
"redirect_url": "/previous-versions/troubleshoot/sql/replication/apply-hotfix-sql-replication-topology"
6381+
},
6382+
{
6383+
"source_path": "support/sql/database-engine/linked-servers/set-up-troubleshoot-linked-server.md",
6384+
"redirect_url": "/previous-versions/troubleshoot/sql/linked-servers/set-up-troubleshoot-linked-server"
63776385
}
63786386
]
63796387
}

support/azure/azure-storage/files/file-sync/file-sync-troubleshoot-managed-identities.md

Lines changed: 21 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Troubleshoot Azure File Sync managed identity issues
33
description: Troubleshoot common issues when your Azure File Sync deployment is configured to use managed identities.
44
ms.service: azure-file-storage
55
ms.topic: troubleshooting
6-
ms.date: 06/05/2025
6+
ms.date: 06/09/2025
77
author: khdownie
88
ms.author: kendownie
99
---
@@ -65,27 +65,32 @@ When you try to delete a Storage Sync Service, you might get the following error
6565
6666
This issue occurs when your file share has unused Azure File Sync snapshots. To reduce your cost, the unused snapshots are deleted before removing the Storage Sync Service. The snapshot count varies with the dataset size. If you can't delete the Storage Sync Service after a few hours, try again the next day.
6767

68-
## Error "Failed to perform resource identity operation" when creating Storage Sync Service
68+
## Error "Failed to perform resource identity operation" when creating a Storage Sync Service
6969

70-
When creating a Storage Sync Service, you might get the following error: "Failed to perform resource identity operation." This error occurs when you delete a Storage Sync Service and then attempt to recreate it using the same name within the same tenant.
70+
When creating a Storage Sync Service, you might get the following error:
7171

72-
To resolve this issue, you can create a new name for the Storage Sync Service, investigate the conflicting app in Microsoft Entra ID (and delete it manually if needed), or wait for the system to auto-clean up the app.
72+
> Failed to perform resource identity operation.
7373
74-
- **Use a different Storage Sync Service name**
75-
Create the Storage Sync Service with a different name than the one previously used.
74+
This issue occurs in one of the following scenarios:
7675

77-
- **How to investigate the conflicting service principal in Microsoft Entra ID**
78-
A conflicting service principal app might still exist in Microsoft Entra ID (formerly Azure AD). This app was likely created during the initial provisioning of the Storage Sync Service.
76+
- You delete a Storage Sync Service and then try to recreate it using the same name within the same tenant.
7977

80-
- **Choose manual deletion (optional)**
81-
If you need immediate resolution, you can manually delete the conflicting app:
82-
1. Go to the Microsoft Entra admin center.
83-
1. Navigate to **Enterprise applications**.
84-
1. Search for the app name that matches the Storage Sync Service.
85-
1. Select the app and then select **Delete**.
78+
- A conflicting service principal app might still exist in Microsoft Entra ID.
8679

87-
- **Wait for automatic cleanup**
88-
If the app was created by the Storage Sync Service provisioning process, the system will automatically delete it within 24 hours. If the service isn't urgently needed, you may choose to wait for this automatic cleanup to complete.
80+
This app was likely created during the initial provisioning of the Storage Sync Service and will be deleted automatically within 24 hours.
81+
82+
To resolve this issue, use one of the following methods:
83+
84+
- Create the Storage Sync Service with a different name than the one previously used.
85+
86+
- Wait for the automatic cleanup of the conflicting service principal app to finish, or delete it manually.
87+
88+
If the service isn't urgently required, wait for this automatic cleanup to finish. If an immediate resolution is needed, you can manually delete the conflicting app:
89+
90+
1. Go to the Microsoft Entra admin center.
91+
2. Navigate to **Enterprise applications**.
92+
3. Search for the app name that matches the Storage Sync Service.
93+
4. Select the app and then select **Delete**.
8994

9095
## Permissions required to access a storage account and Azure file share
9196

support/azure/azure-storage/files/file-sync/file-sync-troubleshoot-sync-group-management.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -41,6 +41,7 @@ To create a cloud endpoint, your user account must have the following Microsoft
4141

4242
The following built-in roles have the required Microsoft Authorization permissions:
4343

44+
- Azure File Sync Administrator
4445
- Owner
4546
- User Access Administrator
4647

@@ -49,7 +50,7 @@ To determine whether your user account role has the required permissions:
4950
1. In the Azure portal, select **Resource groups**.
5051
2. Select the resource group where the storage account is located, and then select **Access control (IAM)**.
5152
3. On the **Check access** tab, select **View my access**.
52-
4. On the **Current role assignments** tab, select the role (for example, Owner or Contributor) for your user account.
53+
4. On the **Current role assignments** tab, select the role (for example, File Sync Administrator, Owner or Contributor) for your user account.
5354
5. On the **Permissions** tab, verify the role for your user account has the following permissions:
5455
- **Read**: **Get role definition**
5556
- **Write**: **Create or update custom role definition**
Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
---
2+
title: Resolve Azure Marketplace purchase error
3+
description: Provides solutions for common errors you might experience when subscribing to Azure Native Integrations in Azure Marketplace.
4+
author: ProfessorKendrick
5+
ms.author: kkendrick
6+
ms.service: partner-services
7+
ms.topic: error-reference #Don't change
8+
ms.date: 05/29/2025
9+
#customer intent: As a customer, I want troubleshoot errors so that I can subscribe to an Azure Native Integrations partner service.
10+
---
11+
12+
# Azure Native Integration purchase errors
13+
14+
This article describes error messages you may encounter when subscribing to an Azure Native Integrations partner service in Azure Marketplace and provides solutions to help you resolve those errors.
15+
16+
|Error message |Details |
17+
|---------|---------|
18+
|"The Microsoft.SaaS RP is not registered on the Azure subscription." |Before you can use a resource provider, you must make sure that your Azure subscription is registered for it. For more information, see [Register resource provider](/azure/azure-resource-manager/management/resource-providers-and-types#register-resource-provider) and [Resolve errors for resource provider registration](/azure/azure-resource-manager/troubleshooting/error-register-resource-provider). |
19+
|"Plan cannot be purchased on a free subscription, please upgrade your account." |You can't make Azure Marketplace purchases on a free Azure subscription. For more information, see the [Azure free account FAQ]( https://azure.microsoft.com/free/free-account-faq) and [Purchase a SaaS offer in the Azure portal](/marketplace/purchase-saas-offer-in-azure-portal#common-error-messages-and-solutions). |
20+
|"Purchase has failed because we couldn't find a valid payment method associated with your Azure subscription." |Use a different Azure subscription, or add or update credit card or payment method information for this subscription. For more information, see [Purchase a SaaS offer in the Azure portal](/marketplace/purchase-saas-offer-in-azure-portal#common-error-messages-and-solutions). |
21+
|"The Publisher does not make available Offer, Plan in your Subscription/Azure account's region." |The offer or the specific plan isn't available to the billing account market that's connected to the Azure subscription. |
22+
|"Enrollment for Azure Marketplace is set to Free/BYOL SKUs only, purchase for Azure product is not allowed. Please contact your enrollment administrator to change EA settings." |Enterprise administrators can disable or enable Azure Marketplace purchases for all Azure subscriptions that are under their enrollment. For more information, see [Enabling Azure Marketplace purchases](/azure/cost-management-billing/manage/ea-azure-marketplace#enabling-azure-marketplace-purchases) and [Introduction to listing options](/partner-center/marketplace/determine-your-listing-type#overview). |
23+
|"Marketplace is not enabled for the Azure subscription." |Enterprise administrators can disable or enable Azure Marketplace purchases for all Azure subscriptions that are under their enrollment. For more information, see [Enabling Azure Marketplace purchases](/azure/cost-management-billing/manage/ea-azure-marketplace#enabling-azure-marketplace-purchases). |
24+
|"Plan by publisher is not available to you for purchase due to private marketplace settings made by your tenant's IT administrator." |The customer uses a private marketplace to limit the access of its organization to specific offers and plans. The specific offer or plan wasn't set up to be available in the tenant's private marketplace. Contact your tenant's IT administrator. |
25+
|"The EA subscription doesn't allow Marketplace purchases." |Use a different subscription or check whether your Enterprise Agreement subscription is enabled for Azure Marketplace purchases. For more information, see [Enabling Azure Marketplace purchases](/azure/cost-management-billing/manage/ea-azure-marketplace#enabling-azure-marketplace-purchases). |
Lines changed: 7 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,9 @@
1-
- name: Azure Native Integrations
1+
- name: Troubleshooting for Azure Native Integrations
2+
href: welcome-native-integrations.yml
3+
- name: Marketplace purchase errors
4+
href: marketplace-purchases-errors.md
5+
- name: Azure Native New Relic Service
26
items:
3-
- name: Azure Native New Relic Service
4-
items:
57
- name: Ingestion key rotation resolution
6-
href: ingestion-key-rotation-log-flow.md
8+
href: ingestion-key-rotation-log-flow.md
9+

support/azure/partner-solutions/welcome-native-integrations.yml

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,12 +10,20 @@ metadata:
1010
ms.topic: landing-page # Required
1111
author: genlin #Required; your GitHub user alias, with correct capitalization.
1212
ms.author: genli #Required; microsoft alias of author; optional team alias.
13-
ms.date: 04/30/2025
13+
ms.date: 06/04/2025
1414

1515
# linkListType: architecture | concept | deploy | download | get-started | how-to-guide | learn | overview | quickstart | reference | tutorial | video | whats-new
1616

1717
landingContent:
1818

19+
# Card
20+
- title: All Partner Services
21+
linkLists:
22+
- linkListType: how-to-guide
23+
links:
24+
- text: Resolve Azure Native Integrations Purchase Errors
25+
url: marketplace-purchases-errors.md
26+
1927
# Card
2028
- title: Azure Native New Relic Service
2129
linkLists:

support/azure/virtual-machines/linux/how-to-use-perfInsights-linux.md

Lines changed: 26 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -12,22 +12,37 @@ ms.collection: linux
1212
ms.workload: infrastructure-services
1313
ms.tgt_pltfrm: vm-linux
1414
ms.topic: troubleshooting
15-
ms.date: 05/02/2025
15+
ms.date: 06/10/2025
1616
ms.author: genli
1717
---
1818
# Troubleshoot Linux virtual machine performance issues with Performance Diagnostics (PerfInsights)
1919

2020
**Applies to:** :heavy_check_mark: Linux VMs
2121

22-
[PerfInsights Linux](https://aka.ms/perfinsightslinuxdownload) is a self-help diagnostics tool that collects and analyzes the diagnostic data, and provides a report to help troubleshoot Linux virtual machine performance problems in Azure. PerfInsights can be run on supported virtual machines as a standalone tool, or directly from the portal by using [Performance Diagnostics for Azure virtual machines](../windows/performance-diagnostics.md).
22+
[PerfInsights Linux](https://aka.ms/perfinsightslinuxdownload) is a self-help diagnostics tool that collects and analyzes the diagnostic data, and provides a report to help troubleshoot Linux virtual machine performance problems in Azure. Use Performance Diagnostics to identify and troubleshoot performance issues in one of two modes:
2323

24-
If you are experiencing performance problems with virtual machines, before contacting support, run this tool.
24+
- **Continuous diagnostics** collects data at five-second intervals and reports actionable insights about high resource usage every five minutes.
2525

26-
> [!NOTE]
27-
> [Continuous diagnostics](../windows/performance-diagnostics.md) is currently supported only on Windows.
26+
- **On-demand diagnostics** helps you troubleshoot an ongoing performance issue with more in-depth data, insights, and recommendations based on data collected at a single point in time.
27+
28+
This article explains how to download the Performance Diagnostics extension to your Linux VM and run the tool using the CLI tool. You can also [run Performance Diagnostics from the portal](../windows/performance-diagnostics.md).
29+
30+
If you are experiencing performance problems with virtual machines, before contacting support, run this tool.
2831

2932
## Supported troubleshooting scenarios
3033

34+
You can use Performance Diagnostics to troubleshoot various scenarios. The following sections describe common scenarios for using Continuous and On-Demand Performance Diagnostics to identify and troubleshoot performance issues. For a comparison of Continuous and On-Demand Performance Diagnostics, see [Performance Diagnostics insights and reports](../windows/performance-diagnostics.md).
35+
36+
## Continuous diagnostics
37+
38+
Continuous Performance diagnostics lets you identify high resource usage by monitoring your VM regularly for:
39+
40+
- High CPU usage: Detects high CPU usage periods and shows the top CPU usage consumers during those periods.
41+
42+
- High memory usage: Detects high memory usage periods and shows the top memory usage consumers during those periods.
43+
44+
- High disk usage: Detects high disk usage periods on physical disks and shows the top disk usage consumers during those periods.
45+
3146
PerfInsights can collect and analyze several kinds of information. The following sections cover common scenarios.
3247

3348
### Quick performance analysis
@@ -44,7 +59,7 @@ This scenario collects basic information such as storage and hardware configurat
4459

4560
- Storage information
4661

47-
- Azure Virtual Machine Configuration (collected using [Azure Instance Metadata Service](/azure/virtual-machines/windows/instance-metadata-service)
62+
- Azure Virtual Machine Configuration (collected using [Azure Instance Metadata Service](/azure/virtual-machines/windows/instance-metadata-service))
4863

4964
- List of running processes, Disk, Memory, and CPU usage
5065

@@ -202,7 +217,7 @@ The following categories of rules are currently supported:
202217
| Debian | 9, 10, 11 [`*`] |
203218
| SLES | 12 SP5 [`*`], 15 SP1 [`*`], 15 SP2 [`*`], 15 SP3 [`*`], 15 SP4 [`*`], 15 SP5 [`*`], 15 SP6 [`*`] |
204219
| AlmaLinux | 8.4, 8.5 |
205-
| Azure Linux | 2.0 |
220+
| Azure Linux | 2.0, 3.0 |
206221

207222
>[!Note]
208223
>[`*`] Please refer to [Known issues](#known-issues) section
@@ -250,27 +265,27 @@ To run the PerfInsights tool, follow these steps:
250265
sudo python perfinsights.py
251266
```
252267

253-
:::image type="content" source="media/how-to-use-perfinsights-linux/perfinsights-linux-commandline.png" alt-text="Screenshot of PerfInsights Linux command-line output.":::
268+
:::image type="content" source="media/how-to-use-perfinsights-linux/perfinsights-linux-command-line.png" alt-text="Screenshot of PerfInsights Linux command-line output." lightbox="media/how-to-use-perfinsights-linux/perfinsights-linux-command-line.png":::
254269

255270
The basic syntax for running PerfInsights scenarios is:
256271

257272
```bash
258273
sudo python perfinsights.py -r <ScenarioName> -d [duration]<H | M | S> [AdditionalOptions]
259274
```
260275

261-
You can use the below example to run Quick performance analysis scenario for 1 minute and create the results under /tmp/output folder:
276+
You can use the following example to run Quick performance analysis scenario for 1 minute and create the results under /tmp/output folder:
262277

263278
```bash
264279
sudo python perfinsights.py -r quick -d 1M -a -o /tmp/output
265280
```
266281

267-
You can use the below example to run performance analysis scenario for 5 mins and upload the result (stores in a TAR file) to the storage account:
282+
You can use the following example to run performance analysis scenario for 5 mins and upload the result (stores in a TAR file) to the storage account:
268283

269284
```bash
270285
sudo python perfinsights.py -r vmslow -d 300S -a -t <StorageAccountName> -k <StorageAccountKey> -i <full resource Uri of the current VM>
271286
```
272287

273-
You can use the below example to run the HPC performance analysis scenario for 1 mins and upload the result TAR file to the storage account:
288+
You can use the following example to run the HPC performance analysis scenario for 1 mins and upload the result TAR file to the storage account:
274289

275290
```bash
276291
sudo python perfinsights.py -r hpc -d 60S -a -t <StorageAccountName> -k <StorageAccountKey> -i <full resource Uri of the current VM>
315 KB
Loading
19.7 KB
Loading

0 commit comments

Comments
 (0)