/articles/application-insights/app-insights-release-notes-vsix.md

https://gitlab.com/apachipa/azure-content · Markdown · 173 lines · 114 code · 59 blank · 0 comment · 0 complexity · 58526c534a9add3087b14defbb9e9f3a MD5 · raw file 

    

  1. <properties
    2. 

  2. 	pageTitle="Release notes for Visual Studio Extension for Developer Analytics"
    3. 

  3. 	description="The latest updates for Visual Studio tools for Developer Analytics."
    4. 

  4. 	services="application-insights"
    5. 

  5.     documentationCenter=""
    6. 

  6. 	authors="acearun"
    7. 

  7. 	manager="douge"/>
    8. 

  8. <tags
    9. 

  9. 	ms.service="application-insights"
    10. 

  10. 	ms.workload="tbd"
    11. 

  11. 	ms.tgt_pltfrm="ibiza"
    12. 

  12. 	ms.devlang="na"
    13. 

  13. 	ms.topic="article"
    14. 

  14. 	ms.date="06/09/2016"
    15. 

  15. 	ms.author="acearun"/>
    16. 

  16. 

  17. # Release Notes - Developer Analytics Tools
    18. 

  18. ##### Application Insights and HockeyApp analytics in Visual Studio
    19. 

  19. ## Version 7.0.1
    20. 

  20. Application Insights now supports ASP.NET Core RC2 projects in Visual Studio. You can add Application Insights to new ASP.NET Core RC2 projects from the New Project dialog, or to an existing project by right-clicking the project in the Solution Explorer and choosing "Add Application Insights Telemetry..."
    21. 

  21. 

  22. ![.NET Core Support](./media/app-insights-release-notes-vsix/NetCoreSupport.PNG)
    23. 

  23. 

  24. ASP.NET 5 RC1 and ASP.NET Core RC2 projects also have new support in the Diagnostic Tools window. You'll see Application Insights events like requests and exceptions from your ASP.NET app while debugging locally on your PC. From each event, you can drill down for more information by clicking "Search."
    25. 

    26. 

  26. ![Diagnostic Tools support](./media/app-insights-release-notes-vsix/DiagnosticTools.PNG)
    27. 

  27. 

  28. Other new features:
    29. 

  29. 

  30. * We've made the Application Insights Search experience faster and more intuitive by automatically applying time ranges and detail filters as you select them
    31. 

  31. * In Application Insights Search, there's now an option to Go to Code from request telemetry
    32. 

  32. * We've made improvements to the HockeyApp sign-in experience.
    33. 

    34. 

  34. ## Version 5.2
    35. 

  35. We are happy to announce the introduction of HockeyApp scenarios in Visual Studio. The first integration we have enabled is beta distribution of Universal Windows and Windows Forms apps within VS.
    36. 

  36. 

  37. Beta distribution allows you to upload early versions of your apps to HockeyApp for distribution to a chosen subset of customers or testers. Beta distribution, combined with HockeyApp crash collection and user feedback features, can provide valuable information about your app before a broad release. You can use this information to address issues with your app before it becomes a big deal (low ratings, poor feedback, etc.).
    38. 

  38. 

  39. Check out how simple it is to upload builds for beta distribution from within VS…
    40. 

  40. ### Universal Windows apps
    41. 

  41. The context menu for an UWP project node now includes an option to upload your build to HockeyApp.
    42. 

  42. 

  43. ![Project context menu for Universal Apps](./media/app-insights-release-notes-vsix/UniversalContextMenu.png)
    44. 

  44. 

  45. Choose the item and see the HockeyApp upload dialog. You will need a HockeyApp account to upload your build. Don't worry if you are a new user - creating an account is a simple process.
    46. 

    47. 

  47. Once you are connected, you will see the upload form in the dialog.
    48. 

  48. 

  49. ![Upload Dialog for Universal apps](./media/app-insights-release-notes-vsix/UniversalUploadDialog.png)
    50. 

  50. 

  51. Select the content to upload (appxbundle or appx) and choose release options in the wizard. You can optionally add release notes on the next page. Choose ‘Finish’ to begin upload.
    52. 

  52. 

  53. When the upload is complete, you will see a HockeyApp toast with confirmation and a link to the app in the HockeyApp portal.
    54. 

  54. 

  55. ![Upload complete toast](./media/app-insights-release-notes-vsix/UploadComplete.png)
    56. 

  56. 

  57. That’s it - you just uploaded a build for Beta distribution with a few clicks.
    58. 

  58. 

  59. The HockeyApp portal allows you to manage your application in various ways (invite users, view crash reports and feedback, change details, etc.).
    60. 

  60. 

  61. ![HockeyApp portal](./media/app-insights-release-notes-vsix/HockeyAppPortal.png)
    62. 

  62. 

  63. More details on app management is available at the [Hockey App Knowledge Base](http://support.hockeyapp.net/kb/app-management-2).
    64. 

  64. 

  65. ### Windows Forms apps
    66. 

  66. The context menu for a Windows Form project node includes an option to upload your build to HockeyApp.
    67. 

  67. 

  68. ![Project context menu for Windows Forms apps](./media/app-insights-release-notes-vsix/WinFormContextMenu.png)
    69. 

  69. 

  70. This brings up the HockeyApp upload dialog similar to the one for Universal apps.
    71. 

  71. 

  72. ![Upload Dialog for Windows Form apps](./media/app-insights-release-notes-vsix/WinFormsUploadDialog.png)
    73. 

  73. 

  74. Notice an extra field in this wizard – for specifying the version of the app. For Universal apps, the information is populated from the manifest – Win Forms unfortunately don’t have an equivalent and hence need to be manually specified.
    75. 

  75. 

  76. The rest of the flow is similar to Universal apps – pick build, release options, add release notes, upload, and manage in the HockeyApp portal.
    77. 

  77. 

  78. It’s as simple as that. Give it a try and let us know what you think.
    79. 

  79. ## Version 4.3
    80. 

  80. ### Search telemetry from local debug sessions
    81. 

  81. With this release, we are introducing the ability to search for Application Insights telemetry generated in the Visual Studio debug session. Search was previously only possible if you had registered your app with Application Insights. With this release, your app only needs the Application Insights SDK installed to search for local telemetry.
    82. 

  82. 

  83. #### If you have an ASP.NET application with the Application Insights SDK
    84. 

  84. 

  85. - Debug your application.
    86. 

  86. - Open Application Insights Search using one of these ways
    87. 

  87. 	- View Menu -> Other Windows -> Application Insights Search
    88. 

  88. 	- Click on the Application Insights Toolbar button
    89. 

  89. 	- In Solution Explorer, expand ApplicationInsights.config -> Search debug session telemetry
    90. 

  90. - If you haven't signed up with Application Insights, the Search window will open up in 'Debug session telemetry' mode.
    91. 

  91. - Click the search icon to see your local telemetry.
    92. 

  92. 

  93. ![Upload complete](./media/app-insights-release-notes-vsix/LocalSearch.png)
    94. 

  94. 

  95. 

  96. 

  97. ##Version 4.2
    98. 

  98. In this release we've added features to make searching data easier in context of events, the ability to jump to code from more data events and an effortless experience to send your logging data to Application Insights. This extension is updated monthly, if you have feedback or feature reuests send it to aidevtools@microsoft.com
    99. 

  99. ###- 0-click logging experience
    100. 

  100. If you're already using NLog, Log4Net or System.Diagnostics tracing then you don't have to worry about moving all your traces to AI, now we're integrating the Application Insights Logging adapters with the normal configuration experience.
    101. 

  101. If you already have one of these logging frameworks configured here's how you get it:
    102. 

  102. ####If you already have Application Insights added
    103. 

  103. - Right-click on the Project Node->Application Insights->Configure Application Insights. Make sure you see the the option to add the right adapter in the configuration window.
    104. 

  104. - Or when you build the solution, notice the pop-up that appears on the top right of your screen and click on configure.
    105. 

  105. ![Loggin Toast](./media/app-insights-release-notes-vsix/LoggingToast.png)
    106. 

  106. 

  107. Once you have the Logging adapter installed, you can run your application and make sure you see the data in the diagnostic tools tab as the following:
    108. 

  108. ![Traces](./media/app-insights-release-notes-vsix/Traces.png)
    109. 

  109. ###- User can jump/find to the code where the telemetry event property is emitted
    110. 

  110. With the new release user can click on any value in the event detail and this will search for a matching string in the current open solution. Results will show up in Visual Studio "Find Results" list as shown below:
    111. 

  111. ![Find Match](./media/app-insights-release-notes-vsix/FindMatch.png)
    112. 

  112. ###- New screen for not-signed in user in Search Window
    113. 

  113. We've improved the look of our Search window to guide users to searching their data in production.
    114. 

  114. ![Search Window](./media/app-insights-release-notes-vsix/SearchWindow.png)
    115. 

  115. ###- User can see all telemetry events associated with the event
    116. 

  116. A new tab next to event details has been added that contains a pre-defined queries to view all related data to the telemetry event the user is looking at. For example: Request has a field called operation ID and every event associated to this Request will have the same operation ID, so if an exception occured while processing the request it will get the same operation ID as the request to make it easier to find it, and so on. So user looking at a request now, can click on "All telemetry for this operation" this will open a new tab with the new search results.
    117. 

  117. ![Related Items](./media/app-insights-release-notes-vsix/RelatedItems.png)
    118. 

  118. ### - Add Forward/Back history in Search
    119. 

  119. User can now go back and forth between search results.
    120. 

  120. ![Go Back](./media/app-insights-release-notes-vsix/GoBAck.png)
    121. 

  121. 

  122. ##Version 4.1
    123. 

  123. This release comes with a number of new features and improvements to our existing ones. In order to get this release you need to have Update 1 installed on your machine.
    124. 

  124. 

  125. ### Jump from an exception to method in source code
    126. 

  126. Now users viewing Exceptions from their Production apps in Application Insights Search window can jump to the method in their code where the Exception is happening. You just need to have the right project loaded and we'll take care of the rest! (To learn more about Search window look at 4.0 release notes below)
    127. 

    128. 

  128. #### How does it work?
    129. 

  129. 

  130. When a solution is not open, AI Search can be used without opening a solution.  In that case, the stack trace area will show an info message, and many of the items in the stack trace will appear grayed out.
    131. 

  131. 

  132. 

  133. If file information was available, some items may be links, but the solution info item will still be visible.
    134. 

  134. 

  135. Clicking on the hyperlink will take you to the where the selected method is in your code, there might be a difference in the version number, but that feature will come in later releases: jump to the right version of code.
    136. 

  136. 

  137. ![Clicking on Exception](./media/app-insights-release-notes-vsix/jumptocode.png)
    138. 

  138. 

  139. ###New entry points to the Search Experience in Solution Explorer
    140. 

  140. 

  141. ![Entry Point in Solution Explorer](./media/app-insights-release-notes-vsix/searchentry.png)
    142. 

  142. 

  143. 

  144. ###Pop-up a toast when publish is complete
    145. 

  145. A pop-up will appear once the project is published online, so you can view your Application Insights data in production.
    146. 

  146. 

  147. ![Popup](./media/app-insights-release-notes-vsix/publishtoast.png)
    148. 

  148. 

  149. ## Version 4.0
    150. 

  150. 

  151. ###Search Application Insights data inside Visual Studio
    152. 

  152. Just like Search in the Application Insights portal, you can filter and search on event types, property values and text, and inspect individual events.
    153. 

  153. 

  154. ![Search window](./media/app-insights-release-notes-vsix/search.png)
    155. 

  155. 

  156. ###See data coming from your local-box in the Diagnostics Tools window
    157. 

  157. 

  158. Your telemetry will also appear along with other debugging data in the Visual Studio Diagnostic Hub. This is only supports ASP.NET 4.5. Support for ASP.NEt 5 is coming in upcoming releases.
    159. 

  159. 

  160. ![Diagnostics hub window](./media/app-insights-release-notes-vsix/diagtools.png)
    161. 

  161. 

  162. ###Add the SDK to your project without having to be signed in to Azure
    163. 

  163. 

  164. You no longer have to sign in to Azure in order to add Application Insights packages to your project, either in the new project dialog or in the project context menu. If you do sign in, the SDK will be installed and configured to send telemetry to the portal, as before.  If you don’t sign in, the SDK will be added to your project and will generate telemetry for the diagnostic hub, and you’ll be able to configure it later if you want.
    165. 

  165. 

  166. ![New Project Dialog](./media/app-insights-release-notes-vsix/newproject.png)
    167. 

  167. 

  168. ###Devices support
    169. 

  169. 

  170. At *Connect();* 2015 we [announced](https://azure.microsoft.com/blog/deep-diagnostics-for-web-apps-with-application-insights/) that our Mobile DevOps experience for devices is HockeyApp. HockeyApp helps you to distribute beta builds to your testers, collect and analyze all crashes from your app, and collect feedback directly from your customers.
    171. 

  171. HockeyApp supports you on whatever platform you are building your mobile application, be it iOS, Android, or Windows or a cross-platform solution like Xamarin, Cordova, or Unity.
    172. 

  172. 

  173. In future releases of the Application Insights extension we’ll be introducing new functionalities to enable a more integrated experience between HockeyApp and Visual Studio. For now you can start with HockeyApp by simply adding the NuGet reference: see the [documentation](http://support.hockeyapp.net/kb/client-integration-windows-and-windows-phone) for more information.
    174.