{"id":11495,"date":"2018-02-07T08:00:26","date_gmt":"2018-02-07T16:00:26","guid":{"rendered":"https:\/\/blogs.msdn.microsoft.com\/webdev\/?p=11495"},"modified":"2018-02-07T08:00:26","modified_gmt":"2018-02-07T16:00:26","slug":"diagnosing-errors-on-your-cloud-apps","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/dotnet\/diagnosing-errors-on-your-cloud-apps\/","title":{"rendered":"Diagnosing Errors on your Cloud Apps"},"content":{"rendered":"

One of the most frustrating experiences is when you have your app working on your local machine, but when you publish it it\u2019s inexplicably failing. Fortunately, Visual Studio provides handy features for working with apps running in Azure. In this blog I\u2019ll show you how to leverage the capabilities of Cloud Explorer to diagnose issues in Azure. If you\u2019re interested in developing apps in the cloud, we\u2019d love to hear from you. Please take a minute to complete our one question survey<\/a>.<\/p>\n

Prerequisites – If you want to follow along, you\u2019ll need<\/h3>\n

Visual Studio 2017<\/a> with Azure development workload<\/a> installed. – This blog assumes you have an Azure subscription and have an App running in Azure App Services. If you don\u2019t have an Azure subscription, click here<\/a> to sign up for free credits. – For the purposes of this blog, we’ve developed a simple one-page web app. The source is available here<\/a>.<\/p>\n

Open the solution If you have your app running on Azure, open the solution in Visual Studio. Alternatively,<\/h4>\n

clone the source<\/a> for the sample app and open it in Visual Studio. Publish the app to Microsoft Azure App Services.<\/p>\n

Connect to your Azure subscription with Cloud Explorer Cloud Explorer is a powerful tool that ships with the Azure development workload in Visual Studio 2017. We can use Cloud Explorer to view and interact with the resources in our Azure subscription. To view your Azure resources in Cloud Explorer, enable the subscription in the Account Manager tab. – Open<\/h4>\n

Cloud Explorer<\/strong> (View -> Cloud Explorer) – Press the Account Management<\/strong> button in the Cloud Explorer toolbar. – Choose the Azure subscription that you are working with, then press Apply<\/strong>. \"Cloud<\/a> Your Azure subscription now appears in the Cloud Explorer. You can toggle the grouping of elements by Resource Groups<\/strong> or Resource Types<\/strong> using the drop-down selector at the top of the window.<\/p>\n

View Streaming Logs When I ran my app after publishing, there was an error. The error message shown on the web page was not very descriptive. So what can I do? How can I get more information about what’s going wrong? One easy way to diagnose issues on the server is to inspect the application logs. Using Cloud Explorer, you can access the streaming logs of any App Service in your subscription. The streaming logs output a concatenation of all the application logs saved on the App Service. The default log level is \u201cError\u201d. To<\/h3>\n

view streaming logs<\/strong> for your application running on Azure App Services: – Expand the subscription node and select your App Service. – Click View Streaming Logs<\/strong> in the Actions panel. \"Cloud<\/a> The Output window opens with a new log stream from the App Service running on the cloud. – If you\u2019re using the sample app, refresh the page in the web browser and wait for the page to complete rendering. This might take ten seconds or more, as the server waits for the fetch operation to time out before returning the result. You can read the log messages to see what’s happening on the server. \"Streaming<\/a> If you switch to Verbose output logging, you see a lot more. \"Streaming<\/a> Notice the [Error] that appears in the streaming logs: \u201cException occurred while attempting to list files on server.\u201d It doesn\u2019t tell us much, but at least now we can start looking in the ListBlobFiles.StorageHelper for clues. We know it works locally, so we’ll need to debug the version running on the cloud to see why it’s failing. For that, we need remote debugging. Once again, Cloud Explorer to the rescue!<\/p>\n

Remote Debugging App Service running on Azure Using Cloud Explorer, you can attach a remote debugger to applications running on Azure. This lets you control the flow of execution by breaking and stepping through the code. It also provides an opportunity to view the value of variables and method returns by utilizing Visual Studio\u2019s debugger tooltips, autos, watches, call stack and other diagnostic tools.<\/h3>\n

Publish a Debug version of the Web App Before you can attach a debugger to an application on Azure, there must be a debug version of the code running on the App Service. So, we’ll re-publish the app with Debug release configuration. Then we’ll attach a remote debugger to the app running in the cloud, set breakpoints and step through the code. \u2022 Open the publish summary page (Right-click project, choose “Publish\u2026”) \u2022 Select (or create) the publish profile for your web app \u2022 Click<\/h4>\n

Settings<\/strong> \u2022 When the settings dialog opens, go to the Settings<\/strong> tab. \u2022 In the Configurations<\/strong> drop-down, select “Debug”. \u2022 Save the publish profile settings. \u2022 Press **Publish **to republish the web app \"Publish<\/a><\/p>\n

Attach Remote Debugger You can attach a remote debugger to allow you to step through the code that\u2019s running on your Azure App Service. This lets you see the values of variables and watch the flow of control in your app. To<\/h4>\n

attach a remote debugger<\/strong>: \u2022 In the Cloud Explorer, select the web app. \u2022 Click Attach Debugger<\/strong> in the Actions panel. Visual Studio will switch over to Debug mode. Now you can set breakpoints in the code and watch the execution as the program runs.<\/p>\n

Set breakpoint and execute the code If you\u2019re following along from the sample, try this: \u2022 Set breakpoints in the<\/h4>\n

GetBlobFileListAsync()<\/strong> method of the StorageHelper.cs \u2022 Refresh the page in the web browser \u2022 Execution will stop at your first breakpoint. \u2022 Hover your mouse cursor over the _storageConnectionString<\/strong> variable and inspect its value. \u2022 Notice that the connection string is “UseDevelopmentStorage=true”. \"Remote<\/a> Problem found! We’re referencing our local Storage (\u201cUseDevelopmentStorge=true\u201d), which won’t work in the cloud. To fix it, we\u2019ll need to provide a connection string to the app running in the cloud that points to our Blob storage container. Complete the debugging session. – Press F5 to allow the request to complete. – Then press Shift+F5 to stop the remote debugging session.<\/p>\n

Next steps<\/h3>\n

Re-publish with Release configuration<\/strong> Once you\u2019ve finished debugging and your app is working as expected, you can republish a Release version of the app for better performance. Go to the Publish page, find the Publish Profile, select “Settings\u2026” and change the configuration to “Release”.<\/p>\n

Related Links Get started with Azure Blob storage using .NET<\/h3>\n

https:\/\/docs.microsoft.com\/en-us\/azure\/storage\/blobs\/storage-dotnet-how-to-use-blobs<\/a> Use the Azure Storage Emulator for development and testing https:\/\/docs.microsoft.com\/en-us\/azure\/storage\/common\/storage-use-emulator<\/a> Introduction to Razor Pages in ASP.NET Core https:\/\/docs.microsoft.com\/en-us\/aspnet\/core\/mvc\/razor-pages\/?tabs=visual-studio<\/a> ASP.NET Core – Simpler ASP.NET MVC Apps with Razor Pages MSDN Magazine article by Steve Smith https:\/\/msdn.microsoft.com\/en-us\/magazine\/mt842512.aspx<\/a> Upload image data in the cloud with Azure Storage https:\/\/docs.microsoft.com\/en-us\/azure\/storage\/blobs\/storage-upload-process-images<\/a> Azure Blob Storage Samples for .NET https:\/\/github.com\/Azure-Samples\/storage-blob-dotnet-getting-started<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"

One of the most frustrating experiences is when you have your app working on your local machine, but when you publish it it\u2019s inexplicably failing. Fortunately, Visual Studio provides handy features for working with apps running in Azure. In this blog I\u2019ll show you how to leverage the capabilities of Cloud Explorer to diagnose issues […]<\/p>\n","protected":false},"author":467,"featured_media":21399,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[197,327,7252],"tags":[7538,7539,7540],"class_list":["post-11495","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-aspnet","category-azure","category-cloud","tag-apps","tag-cloud","tag-diagnosing"],"acf":[],"blog_post_summary":"

One of the most frustrating experiences is when you have your app working on your local machine, but when you publish it it\u2019s inexplicably failing. Fortunately, Visual Studio provides handy features for working with apps running in Azure. In this blog I\u2019ll show you how to leverage the capabilities of Cloud Explorer to diagnose issues […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/posts\/11495","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/users\/467"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/comments?post=11495"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/posts\/11495\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/media\/21399"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/media?parent=11495"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/categories?post=11495"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/tags?post=11495"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}