Document Details
Application Gateway Troubleshooting 502
This page contains Windows bias
About This Page
This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.
Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
missing_linux_example
windows_first
Summary
The documentation page for troubleshooting Azure Application Gateway 502 errors demonstrates a notable Windows bias. All command-line examples use Azure PowerShell cmdlets, which are most commonly used on Windows and require installation on Linux/macOS. There are no Azure CLI, Bash, or Linux-native tool examples. Troubleshooting steps and references (such as IIS and classic VM endpoints) are Windows-centric, and Windows tools/patterns are mentioned exclusively or before any Linux alternatives. This creates friction for Linux/macOS users who may not use PowerShell or Windows-based web servers.
Recommendations
- Add equivalent Azure CLI (az) commands alongside PowerShell examples for all troubleshooting steps.
- Include Linux-native troubleshooting commands (e.g., curl, dig, netstat) for checking DNS, connectivity, and health probes.
- Reference Linux web servers (e.g., Apache, Nginx) in health probe and SSL certificate sections, not just IIS.
- Explicitly state that PowerShell cmdlets can be run cross-platform, or provide links to installation guides for Linux/macOS.
- Reorder examples so that CLI or platform-neutral solutions are shown first or in parallel with Windows-specific ones.
Create Pull Request
Scan History
| Date | Scan | Status | Result |
|---|---|---|---|
| 2026-01-12 00:00 | #99 | completed |
Biased
|
| 2026-01-11 06:20 | #98 | completed |
 Clean
|
| 2026-01-11 00:00 | #95 | cancelled |
Clean
|
| 2026-01-10 00:00 | #92 | completed |
Clean
|
| 2026-01-09 00:00 | #87 | cancelled |
Clean
|
| 2026-01-06 22:28 | #78 | completed |
Clean
|
| 2025-12-29 18:00 | #48 | cancelled |
Clean
|
| 2025-12-15 00:00 | #7 | completed |
Clean
|
| 2025-12-14 05:05 | #6 | completed |
Clean
|