Document Details

App Service Web Nodejs Best Practices And Troubleshoot Guide
Home / Scan #41 / App Service Web Nodejs Best Practices And Troubleshoot Guide
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
windows_first
windows_tools
missing_linux_example
powershell_heavy
Summary
The documentation is heavily focused on Windows environments, specifically Azure App Service on Windows with iisnode. All configuration examples, troubleshooting steps, and tool references are Windows-centric, with no mention of Linux equivalents or cross-platform considerations. Tools and paths (e.g., node.exe, web.config, named pipes, Win32 error codes, d:\ paths, IIS, PowerShell, CMD) are specific to Windows. There are no Linux or cross-platform examples, and Linux troubleshooting or deployment patterns are not discussed.
Recommendations
  • Add equivalent sections or notes for Node.js applications running on Azure App Service for Linux, including differences in configuration and troubleshooting.
  • Provide Linux-specific examples (e.g., using environment variables, file paths, and process management tools relevant to Linux).
  • Include Linux command-line examples (bash, sh) alongside or before Windows CMD/PowerShell examples.
  • Mention Linux logging and diagnostic file locations and tools (e.g., /var/log, journalctl, pm2 logs).
  • Clarify which recommendations and settings are Windows-only and provide alternatives or links for Linux users.
  • Reference Linux-native process managers (e.g., PM2, systemd) and configuration files (e.g., .env, ecosystem.config.js) where appropriate.
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

<configuration>
    <system.webServer>
        <!-- ... -->
        <iisnode flushResponse="true" />
    </system.webServer>
</configuration>

<handlers>
    <add name="iisnode" path="app.js" verb="\*" modules="iisnode" responseBufferLimit="0"/>
</handlers>