This page gives instructions on investigating Kudu issues that occur in Azure Web Sites. This applies to git, Mercurial and Dropbox deployment related issues.

Making sure things work outside of Kudu and Azure Web Sites

Sometimes, the issue exists outside of Azure Web Sites. Here are a couple things worth looking at to make sure things are healthy before looking at an issue as Azure specific:

• Make sure all your files are committed: this applies to git scenarios
• Make sure site correctly deploys locally: this applies to ASP.NET Web Applications

Kudu and Azure Web Site specific investigation

Make sure the site itself works

When you run into an issue with a Kudu feature, the first thing to try is to hit the site itself (e.g. http://yoursite.azurewebsites.net/). It it seems completely unreachable, then there is a chance that you're dealing with some kind of WAWS outage, which would also disable the Kudu features. When that happens, please check the Azure Service Dashboard to see if some outage is mentioned.

Try hitting the root of the Kudu service

If the site is up but a Kudu feature is broken in some way, try hitting the root of the Kudu service directly from the browser. This is useful whether you fail to Enable Git, get a failure on the Deployment tab, or get a failure when you git push.

If you get an error, it could mean that there is something wrong with Kudu. Please record what the error is and report it to the forum

Live traces

See Diagnostic Log Stream.

Getting the diagnostic dump

If you are able to hit the root of the Kudu service (per previous section), but you get an error during a git command (e.g. push/pull/clone), the next step is to download the Kudu service log.

To do this:

• Go to the root of the Kudu service
• On that page, you'll see a 'Diagnostics Dump' menu item
• Just click it to download a zip file which you can provide to help investigation

Error types

• 403 - You don't have access to this site
• 404 - See Known issues
• 406 - Your Azure web site may be in stopped state.
• 409 - There's a deployment in progress.
• 501 - Git tried to use the dumb protocol and we don't support this (Anatomy of a git request), this is because the initial request failed.
• 502, 503 - Something went wrong before the request reached the Kudu service.

To get more details for any of the above status codes, capture the git client trace for more details (see below).

Capturing the git http verbose output

1. First set GIT_CURL_VERBOSE to 1. The syntax varies depending on the shell:

• git bash: export GIT_CURL_VERBOSE=1
• cmd.exe: set GIT_CURL_VERBOSE=1
• Powershell: $env:GIT_CURL_VERBOSE=1

2. Run your git command. (e.g. git push url master). NOTE: To capture output you need to redirect the error stream not output!
3. Analyzing a git client trace.

Set Kudu logging to verbose level

Try setting AppSetting SCM_TRACE_LEVEL to 4 for kudu-related verbose logging.