Sitecore XP stability issues when using Azure Web Apps

  • Description

    Sitecore solutions that have been deployed to Azure Web Apps may experience some stability issues due to changes made to the Azure Web Apps File Change Notification mechanism. The article describes the errors that may appear and possible solutions to the problem.

    For any additional questions, please open a ticket on the Sitecore Support Portal.

  • The following errors may appear in the log files:

    ERROR Error in FileWatcher. Internal buffer overflow. Exception: System.IO.InternalBufferOverflowException
    Message: Too many changes at once in directory:D:\home\site\wwwroot\
    WARN Shutdown message: Directory rename change notification for 'D:\home\site\wwwroot'.
    Overwhelming Change Notification in wwwroot HostingEnvironment initiated shutdown

    The server may respond with the 503 Service Unavailable error to incoming requests. Additionally, you may experience repeated Sitecore application restarts. 

  • Solution 1 – Use Azure Management Portal

    Disable the Dynamic Cache by creating an App Setting for the impacted App Service:

  • Solution 2 – Disable Sitecore's Diagnostics 

    Rename the \wwwroot\App_Config\Include\Sitecore.Diagnostics.config file to Sitecore.Diagnostics.config.disabled.

    This configuration file enables collection of diagnostics information that can be useful to troubleshoot Sitecore behavior. It can be safely disabled if there are no ongoing troubleshooting processes that requires enabled diagnostics.

  • Solution 3 – Reconfigure Sitecore's XSL watcher

    Modify the \wwwroot\App_Config\Sitecore.config file as shown below:


Applies to:

CMS 8+

June 29, 2017
August 15, 2017

Reference number:

165124, 170790, 170969


  • Azure,
  • Managed Cloud,
  • Performance