feat: Add Troubleshooting Guide for Log Analytics Workspace Deletion Issues #620
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 Log Analytics workspace replication before deleting resources.
Thanusree-Microsoft
requested review from
Avijit-Microsoft,
Prajwal-Microsoft,
Roopan-Microsoft,
Vinay-Microsoft,
aniaroramsft,
malrose07 and
toherman-msft
as code owners
There was a problem hiding this comment.
Pull Request Overview
This PR adds documentation to help users handle Log Analytics workspace deletion when replication is enabled. It addresses a specific failure scenario where azd down fails if the workspace has replication enabled.
Key changes:
- Added a troubleshooting guide for disabling Log Analytics workspace replication before deletion
- Updated the deployment guide to warn users about this requirement and link to the new guide
Reviewed Changes
Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.
| File | Description |
|---|---|
| docs/LogAnalyticsReplicationDisable.md | New troubleshooting guide with step-by-step instructions and Azure CLI commands to disable Log Analytics workspace replication |
| docs/DeploymentGuide.md | Added warning note in resource deletion section referencing the new replication disable guide |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Roopan-Microsoft
approved these changes
Nov 24, 2025
Contributor
|
🎉 This PR is included in version 1.7.0 🎉 The release is available on GitHub release Your semantic-release bot 📦🚀 |
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.