{"id":1743,"date":"2014-03-07T10:46:00","date_gmt":"2014-03-07T10:46:00","guid":{"rendered":"https:\/\/blogs.msdn.microsoft.com\/visualstudioalm\/2014\/03\/07\/enhancements-to-debugging-exceptions-with-intellitrace-in-visual-studio-2013\/"},"modified":"2022-07-18T02:16:20","modified_gmt":"2022-07-18T10:16:20","slug":"enhancements-to-debugging-exceptions-with-intellitrace-in-visual-studio-2013","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/devops\/enhancements-to-debugging-exceptions-with-intellitrace-in-visual-studio-2013\/","title":{"rendered":"Enhancements to Debugging Exceptions with IntelliTrace in Visual Studio 2013"},"content":{"rendered":"

The Microsoft Monitoring Agent<\/a> allows you to collect reliability and performance data<\/a> for web applications and to review the data using IntelliTrace. With Visual Studio 2013 Update 2, we have added the ability to more easily navigate the diagnostics data related to an exception by using a CodeLens<\/a>-enhanced Code Map<\/a> view in combination with the existing IntelliTrace experience.<\/p>\n

Today when I start debugging by double clicking an exception from the summary page, on the call stack window I have to double click each stack frame to examine the parameters of the previous stack frame. This makes it tedious searching for parameters while keeping in mind what the exception was that was thrown. To address that, we have combined the information you get from 3 different windows into a one that is easier to use.<\/p>\n

Let\u2019s examine that experience in this blog post.<\/p>\n

Summary Page<\/h2>\n

For this example, assume that I have collected data using the Microsoft Monitoring Agent<\/a> for my MVC application that threw an exception. I open up the resulting IntelliTrace file in Visual Studio, open the associated solution from the Open Solutions gold bar and on the summary page I can see the exception that was thrown from the MVC application. Opening the solution is useful so that I can see the CodeLens indicators like history of code changes on the methods that led to the exception. If the solution is not opened IntelliTrace would still show the source files.<\/p>\n

\"1\"<\/p>\n

I double click on the row with the exception message (or click on the \u201cDebug Newest Exception in Group\u201d) and IntelliTrace starts debugging and now displays a Code Map view of the call stack that led to the exception.<\/p>\n

\"2\"<\/p>\n

The Code Map window now shows the method that threw the exception. It also contains an annotated comment that describes the exception message. This makes it easier to visualize all the context that led to the exception in one convenient window instead of having to manually navigate between the IntelliTrace events window, call stack window and locals window to make that connection.<\/p>\n

Parameters<\/h2>\n

If the methods in the Code Map window contains parameters then a \u2018Parameters\u2019 link is displayed above the method name. When the link is clicked a CodeLens<\/a> popup window is shown that contains the list of parameters of that method. The benefit of seeing the parameters in the popup window is that I don\u2019t have to switch to the context of that method to see the parameters in the locals window. Hence it makes it easier to view the parameters of different methods from a single Code Map window.<\/p>\n

\"3\"<\/p>\n

The parameter \u2018@id\u2019 with value \u2018121\u2019 corresponds to the code where the InvalidOperationException was thrown.<\/p>\n

The Code Lens popup window can be docked by clicking on the \"clip_image002\" icon.<\/p>\n

\"4\"<\/p>\n

The docked Code Lens window makes it easier to compare parameters with the popup window from other methods.<\/p>\n

Show External Code<\/h2>\n

To see all the external methods in the Code Map window I can enable the \u2018Show External Code\u2019 option from the right click menu in the call stack window. I can click on the \u2018Parameters\u2019 link on the methods to see more interesting parameters.<\/p>\n

\"6\"<\/p>\n

Navigation to source<\/h2>\n

I can double click on the method that threw the exception in the Code Map window to navigate to the source \u2013 here is a screenshot of what that may look like:<\/p>\n

\"5\"<\/p>\n

Code Map Window<\/h2>\n

Please note if the Code Map window \u2018CallStack1.dgml\u2019 is closed then it can be restored back by clicking the \u2018Code Map\u2019 button from the Debugger toolbar.<\/p>\n

\"7\"<\/p>\n

I can also select all the methods in the Code Map using the keyboard shortcut \u2018Ctrl+A\u2019 and then press the \u2018Del\u2019 key to clear the graph. This could be useful if I want to start debugging from another exception from the summary page of the same IntelliTrace file or another exception from a different IntelliTrace file and don\u2019t want the stale methods from the previous exception.<\/p>\n

In Closing<\/h2>\n

We hope you find the ability to visualize the call stack of the exception and parameters on the methods help understand the context that led to the exception. For feedback on this, or any IntelliTrace feature, please ask us at our diagnostics MSDN forum<\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":"

The Microsoft Monitoring Agent allows you to collect reliability and performance data for web applications and to review the data using IntelliTrace. With Visual Studio 2013 Update 2, we have added the ability to more easily navigate the diagnostics data related to an exception by using a CodeLens-enhanced Code Map view in combination with the […]<\/p>\n","protected":false},"author":158,"featured_media":45953,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[226,1,225],"tags":[],"class_list":["post-1743","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-ci","category-devops","category-git"],"acf":[],"blog_post_summary":"

The Microsoft Monitoring Agent allows you to collect reliability and performance data for web applications and to review the data using IntelliTrace. With Visual Studio 2013 Update 2, we have added the ability to more easily navigate the diagnostics data related to an exception by using a CodeLens-enhanced Code Map view in combination with the […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/posts\/1743","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/users\/158"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/comments?post=1743"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/posts\/1743\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/media\/45953"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/media?parent=1743"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/categories?post=1743"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/tags?post=1743"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}