Document Details

Application Gateway Troubleshooting 502
Home / Scan #41 / Application Gateway Troubleshooting 502
Sad Tux - Windows bias detected
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.
GitHub View on GitHub 📚 View on Microsoft Learn

Bias Analysis

Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
windows_tools
Summary
The documentation page demonstrates a strong Windows bias by providing only Azure PowerShell (Windows-centric) command examples for troubleshooting, referencing Windows tools and patterns (such as IIS and PowerShell cmdlets), and omitting equivalent Azure CLI (cross-platform) or Bash/Linux command examples. There are no Linux-specific troubleshooting steps or examples, and Windows terminology and tools are mentioned exclusively or before any cross-platform alternatives.
Recommendations
  • Add Azure CLI (az) command examples alongside PowerShell for all troubleshooting steps, ensuring parity for Linux and macOS users.
  • Include Bash shell command examples where appropriate, especially for network and DNS troubleshooting.
  • Reference both Windows (IIS) and Linux (Apache/Nginx) web server scenarios in health probe and SSL certificate troubleshooting sections.
  • Explicitly mention that all steps can be performed from Linux/macOS using Azure CLI or portal, and provide links to relevant documentation.
  • Avoid using Windows-specific terminology or tools exclusively; always provide cross-platform alternatives.
  • Where JSON output is shown from PowerShell, show equivalent output from Azure CLI (az network vnet show, etc.).
GitHub Create Pull Request

Scan History

Date Scan Status Result
2025-07-12 23:44 #41 cancelled Biased Biased
2025-07-12 00:58 #8 cancelled Clean Clean
2025-07-10 05:06 #7 processing Clean Clean
2025-07-09 23:22 #6 cancelled Clean Clean

Flagged Code Snippets

    $vnet = Get-AzVirtualNetwork -Name vnetName -ResourceGroupName rgName
    Get-AzVirtualNetworkSubnetConfig -Name appGwSubnet -VirtualNetwork $vnet
    
    Get-AzEffectiveNetworkSecurityGroup -NetworkInterfaceName nic1 -ResourceGroupName testrg
    Get-AzEffectiveRouteTable -NetworkInterfaceName nic1 -ResourceGroupName testrg
    
    Get-AzVirtualNetwork -Name vnetName -ResourceGroupName rgName 
    DhcpOptions            : {
                               "DnsServers": [
                                 "x.x.x.x"
                               ]
                             }
    
Get-AzApplicationGateway -Name "SampleGateway" -ResourceGroupName "ExampleResourceGroup"

    New-AzApplicationGatewayBackendHttpSettings -Name 'Setting01' -Port 80 -Protocol Http -CookieBasedAffinity Enabled -RequestTimeout 60