feat: Add Troubleshooting Guide for Log Analytics Workspace Deletion Issues #758
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Added note about disabling replication before deleting resources.
Thanusree-Microsoft
requested review from
Avijit-Microsoft,
Prajwal-Microsoft,
Roopan-Microsoft,
Vinay-Microsoft and
aniaroramsft
as code owners
Copilot finished reviewing on behalf of
Thanusree-Microsoft
November 21, 2025 09:51
Contributor
There was a problem hiding this comment.
Pull Request Overview
This PR adds comprehensive documentation for handling Log Analytics workspace deletion when replication is enabled, addressing a common issue where resource deletions fail if replication hasn't been disabled first. The changes include a new troubleshooting guide with Azure CLI commands and an update to the deployment guide to warn users about this requirement.
Key Changes:
- Added
LogAnalyticsReplicationDisable.mdwith step-by-step instructions for disabling replication before deletion - Updated
DeploymentGuide.mdto reference the new guide when cleaning up resources deployed with redundancy enabled
Reviewed Changes
Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.
| File | Description |
|---|---|
| docs/LogAnalyticsReplicationDisable.md | New troubleshooting guide providing Azure CLI commands to disable Log Analytics workspace replication before deletion, with verification steps |
| docs/DeploymentGuide.md | Added warning note about disabling replication before running azd down when redundancy is enabled, with link to new troubleshooting guide |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Purpose
This pull request adds important documentation to clarify the deletion process for Azure resources when Log Analytics workspace replication is enabled. The main change is the addition of a new guide that instructs users on how to disable replication before deleting resources, and an update to the deployment guide to reference this new requirement.
Documentation improvements for resource deletion:
Added a new file, docs/LogAnalyticsReplicationDisable.md, providing step-by-step instructions for disabling Log Analytics workspace replication before deletion, including relevant Azure CLI commands and verification steps.
Updated the resource deletion section in docs/DeploymentGuide.md to warn users about potential deletion failures if replication is enabled and linked to the new guide for handling Log Analytics workspace replication.
Does this introduce a breaking change?
Other Information
Added LogAnalyticsReplicationDisable.md document.