Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Browse files

fix #279

  • Loading branch information...
commit ba5759c0ed42403181ac665a52010702e43008bc 2 parents 92fc1fd + d3aef3a
@AzureContentRest AzureContentRest authored
View
40 DevCenter/Shared/Chunks/troubleshooting_a_website.md
@@ -1,5 +1,6 @@
-<!-- http://daringfireball.net/projects/markdown/syntax -->
+<!-- http://daringfireball.net/projects/markdown/syntax -->
<!-- http://go.microsoft.com/fwlink/?LinkId=251824 -->
+
<div chunk="../chunks/article-left-menu.md" />
#Troubleshooting a Web Site#
Troubleshooting a web site is accomplished by configuring the web site to display application errors, configuring the web site to display environment variables, enabling web site diagnostics, and then analyzing web site application errors and diagnostic data to identify and resolve problems. This tutorial walks you through the process of creating and deploying a simple web site to Windows Azure, causing an error condition on the web site and then applying configuration and logging options to generate troubleshooting data that can be analyzed to identify and resolve the error.
@@ -9,6 +10,7 @@ Troubleshooting a web site is accomplished by configuring the web site to displa
</div>
<h2><span class="short-header">Web site diagnostics</span>What is Web Site Diagnostics?</h2>
+
Web Site diagnostics provides the following logging and tracing options:
- **Detailed Error Logging** - Logs all errors generated by a web site.
@@ -17,7 +19,9 @@ Web Site diagnostics provides the following logging and tracing options:
Diagnostics log files are saved to an FTP site for download to a local computer.
+
<h2><span class="short-header">Concepts</span>Concepts</h2>
+
Concepts introduced in this article include:
- **Web Site development** - Install and use Microsoft WebMatrix on a local computer to create a web site.
@@ -25,7 +29,9 @@ Concepts introduced in this article include:
- **Web Site deployment** - Deploying a web site from a local computer to Windows Azure.
- **Troubleshooting Web Sites using configuration options and diagnostics** - Configuring web sites to display application errors and environment variables, configuring diagnostics for a web site, collecting diagnostic data and then analyzing the displayed application errors and diagnostics data to troubleshoot and resolve problems.
-<h2><span class="short-header">Install developer tools</span>Install developer tools and create a Web Site on your local computer</h2>
+
+<h2><span class=”short-header”>Install developer tools</span>Install developer tools and create a web site on your local computer</h2>
+
Before discussing how to troubleshoot a web site we must first create a web site. This section walks through using Microsoft WebMatrix to create a simple web site and deploy the web site to Windows Azure.
###<a name="installwebmatrix"></a>Install Microsoft WebMatrix
Visit [http://www.microsoft.com/web/webmatrix][webmatrix] and click the **Free Download** buttpn. This will run the Web Platform Installer which installs all the dependencies you need to run WebMatrix and then install WebMatrix.
@@ -48,7 +54,7 @@ To create a web site with WebMatrix follow these steps:
You have now successfully created a web site with WebMatrix.
-##<a name="createwebsiteonazure"></a>Create a Web Site on Windows Azure##
+<h2><span class=”short-header”>Create a web site</span>Create a Web Site on Windows Azure</h2>
Before you can deploy your web site from WebMatrix to Windows Azure you must first create a web site on Windows Azure. This section walks through creating a web site on Windows Azure.
@@ -78,7 +84,7 @@ Web Sites support multiple deployment technologies including MSDeploy/Webdeploy,
![Web Site Under Construction page][webunderconstruction]
-<h2><span class="short-header">Deploy web site</span>Deploy the web site from the developer computer to Windows Azure</h2>
+<h2><span class=short-header>Deploy the web site</span>Deploy the web site from the developer computer to Windows Azure</h2>
Now that you have created a web site on Windows Azure and generated the necessary deployment user credentials you can deploy the web site from your developer computer to Windows Azure. To deploy a web site to Windows Azure using FTP you can use one of several FTP clients available for download on the Internet or you can deploy directly from your development environment if the application supports FTP publishing. Since WebMatrix supports FTP publishing, follow these steps to publish the web site you created in WebMatrix to Windows Azure:
@@ -108,7 +114,8 @@ Now that you have created a web site on Windows Azure and generated the necessar
![Web Site Published to Windows Azure][defaultpagenewsite]
-##<a name="enableazurediagnostics"></a>Enable diagnostics for the Web Site
+
+<h2><span class=”short-header”>Enable diagnostics</span>Enable diagnostics for the web site</h2>
Enable diagnostics for web sites on the **Configure** management page. Under the **Diagnostics** section of the **Configure** management page you can enable or disable the following logging and tracing options:
@@ -122,7 +129,7 @@ Set all logging and tracing options for the web site to **On** and click the **S
Connect to the FTP site where diagnostic data is stored using parameters from the web site's **Dashboard** management page. Open the FTP site listed under **Diagnostics Logs** using the **Deployment User** account credentials [you created earlier](#deploymentuser). Consider using an FTP client such as [FileZilla][filezilla] to download log files. An FTP client typically provides more flexibility than a web browser for connnecting to and downloading files from an FTP site.
-<h2><span class="short-header">Register account</span>Register an account on the web site</h2>
+<h2><span class=short-header>Register an account</span>Register an account on the Website</h2>
Follow these steps to register an account on the web site:
@@ -134,7 +141,7 @@ Follow these steps to register an account on the web site:
![Logged on to website][loggedontosite]
-<h2><span class="short-header">Introduce error condition</span>Introduce an error condition on the web site</h2>
+<h2><span class=short-header>Introduce an error condition</span>Introduce an error condition on the web site</h2>
Before downloading and analyzing diagnostic data from a web site it will be useful to modify the web site to cause an error to occur. Follow the steps below to cause an error condition and configure the web site to display application errors.
@@ -154,7 +161,6 @@ The default **mode** of the ASP.NET [customErrors][customErrors] configuration s
<customErrors mode="Off"/>
If you are unsure of the location of your web site, open WebMatrix and right-click AzureWebDiag and select **Show in File Explorer**.
-
<div class="dev-callout">
<b>Note</b>
@@ -237,8 +243,9 @@ When you add the file **environment.aspx** to a .NET web application or the file
<a name="debugapperr"></a>
![Detailed Application Error][detailedapperr]
-<h2><span class="short-header">Download diagnostic logs</span>Download diagnostic log files to your local computer</h2>
-Now that you have introduced an error condition on the web site, you can download the resulting diagnostic log files to your local computer for analysis. To ensure that web site diagnostics creates all of the log files specified under the **Diagnostics** section of the web site's **Configure** management page, refresh your browser once or twice to ensure that the error occurs. Follow these steps to download the diagnostic log files to your local computer:
+<h2><span class=”short-header”>Download log files</span>Download diagnostic log files to your local computer</h2>
+
+Now that you have introduced an error condition on the website, you can download the resulting diagnostic log files to your local computer for analysis. To ensure that web site diagnostics creates all of the log files specified under the **Diagnostics** section of the website's **Configure** management page, refresh your browser once or twice to ensure that the error occurs. Follow these steps to download the diagnostic log files to your local computer:
1. Open the web site's **Dashboard** management page and make note of the FTP site listed under **Diagnostics Logs** and the account listed under **Deployment User**. The FTP site is where the log files are located and the account listed under Deployment User is used to authenticate to the FTP site.
2. Consider using an FTP client such as [FileZilla][filezilla] to connect to the FTP site. An FTP client provides greater ease of use for specifying credentials and viewing folders on an FTP site than is typically possible with a browser. The screenshot below was taken from the FileZilla FTP client when connecting to the FTP site where the log files for the AzureWebDiag web site are stored. The FTP host name and deployment user credentials are highlighted in red. To copy the contents of the remote FTP folder on the right to the local folder on the left, click to select the folder on the left then right-click the folder on the right and select **Download** from the shortcut menu that is displayed:
@@ -249,7 +256,7 @@ Now that you have introduced an error condition on the web site, you can downloa
![View Log Files][viewlogfiles]
-<h2><span class="short-header">Analyze log files</span>Analyze web site log files</h2>
+<h2><span class=short-header>Analyze web site logs</span>Analyze website log files</h2>
Basic analysis of the different log file types can be performed as follows:
@@ -295,7 +302,8 @@ Web site logs record all HTTP transactions using the W3C extended log file forma
For more information about Log Parser 2.2 see [Download Log Parser 2.2][downloadlogparser]
-<h2><span class="short-header">Troubleshooting the web site</span>Troubleshoot the AzureWebDiag web site</h2>
+
+<h2><span class=”short-header”>Troubleshoot the web site</span>Troubleshoot the AzureWebDiag web site</h2>
This section describes how someone might engage in troubleshooting a web site using the information that is available after you configure the web site to display errors and enable web site tracing and logging.
@@ -331,7 +339,8 @@ This parameter definition provides a clue as to the cause of the error. Accordi
Checking the web site's \root\App\_Data\ directory we can verify that there is no file named StarterSite.sdf, since of course we renamed it to StarterSite.bak. After renaming this file back to startersite.sdf the InitializeDatabaseConnection() method is able to find the file that it was expecting and the web site works as expected.
-###Next Steps:
+###Next Steps
+
- [ASP.NET MVC web site with SQL Database]
- [Create and deploy a web site with WebMatrix]
- [Create a web site from the gallery]
@@ -355,6 +364,11 @@ Checking the web site's \root\App\_Data\ directory we can verify that there is
[Create a web site from the gallery]:http://www.windowsazure.com/en-us/develop/net/tutorials/website-from-gallery/
[Web site with MongoDB on a virtual machine]:http://www.windowsazure.com/en-us/develop/net/tutorials/website-with-mongodb-vm/
+[ASP.NET MVC web site with SQL Database]:http://www.windowsazure.com/en-us/develop/net/tutorials/web-site-with-sql-database/
+[Create and deploy a web site with WebMatrix]:http://www.windowsazure.com/en-us/develop/net/tutorials/website-with-webmatrix/
+[Create a web site from the gallery]:http://www.windowsazure.com/en-us/develop/net/tutorials/website-from-gallery/
+[Web site with MongoDB on a virtual machine]:http://www.windowsazure.com/en-us/develop/net/tutorials/website-with-mongodb-vm/
+
[newsitefromtemplate]: ..\Media\tshootSiteFromTemplate.png
[newsiteinwebmatrix]: ..\Media\tshootWebMatrixIDE.png
[defaultpagenewsite]: ..\Media\tshootDefaultWebPage.png
View
BIN  DevCenter/Shared/Media/tshootAzureWebDiagQuickStart.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
View
BIN  DevCenter/Shared/Media/tshootCreateAzureWebSite.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
View
BIN  DevCenter/Shared/Media/tshootDefaultWebPage.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
View
BIN  DevCenter/Shared/Media/tshootPublishPreview.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
View
BIN  DevCenter/Shared/Media/tshootPublishSettings.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
View
BIN  DevCenter/Shared/Media/tshootSiteFromTemplate.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
View
BIN  DevCenter/Shared/Media/tshootUnderConstruction.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
View
BIN  DevCenter/Shared/Media/tshootWebMatrixIDE.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
View
BIN  DevCenter/Shared/Media/tshootdeploymentcredentials.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
View
BIN  DevCenter/Shared/Media/tshootquickglanceborder.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
View
BIN  DevCenter/dotNET/Media/howtodownloadsite.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
View
BIN  DevCenter/dotNET/Media/website-with-webmatrix-sample-mod-1-1.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
View
BIN  DevCenter/dotNET/Media/website-with-webmatrix-sample-mod-1-2.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
View
BIN  DevCenter/dotNET/Media/website-with-webmatrix-sample-mod-1-3.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
View
BIN  DevCenter/dotNET/Media/website-with-webmatrix-sample-mod-1-5.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Please sign in to comment.
Something went wrong with that request. Please try again.