{"id":763,"date":"2014-09-03T16:10:59","date_gmt":"2014-09-03T16:10:59","guid":{"rendered":"/__p/blogs.msdn.microsoft.com\/visualstudioalm\/2014\/09\/03\/application-insights-sdk-0-10-0-prerelease\/"},"modified":"2022-05-26T06:55:40","modified_gmt":"2022-05-26T14:55:40","slug":"application-insights-sdk-0-10-0-prerelease","status":"publish","type":"post","link":"/__p/devblogs.microsoft.com\/devops\/application-insights-sdk-0-10-0-prerelease\/","title":{"rendered":"Application Insights SDK (0.10.0-prerelease)"},"content":{"rendered":"

What is it?<\/h2>\n<\/p>\n

<\/span><\/p>\n

\n <\/a>Application Insights SDK lets you send telemetry to the Application Insights portal, where you can find out what users are doing with your application.<\/span><\/span><\/a>\n<\/p>\n

\n 0.10.0 is the latest SDK release for Application Insights. This SDK includes new functionality and new concepts in addition to a change in the basic architecture. <\/span>\n<\/p>\n

\n Data sent through this SDK will only be visible through the <\/span><\/a>Microsoft Azure Preview Portal<\/span><\/span><\/a>. (Previous versions sent data to an earlier edition of Application Insights, which is part of Visual Studio Online.) To find out more information about the different versions of Application Insights please see the documentation <\/span><\/span>here<\/span><\/span><\/a>.<\/span><\/span>\n<\/p>\n

\n You can instrument these types of application: <\/span>\n<\/p>\n

\n 1.\u00a0\u00a0\u00a0\u00a0 <\/span><\/span><\/span>ASP.NET web applications<\/a> <\/span>hosted either on premises or in Microsoft Azure.<\/span> <\/span>\n<\/p>\n

\n 2.\u00a0\u00a0\u00a0\u00a0 <\/span><\/span><\/span>Windows Phone 8.0 (Silverlight) and 8.1 (Silverlight and WinRT)<\/a> \u2013 UI experience is coming soon. <\/span>\n<\/p>\n

\n 3.\u00a0\u00a0\u00a0\u00a0 <\/span><\/span><\/span>Windows Store 8.1 applications<\/a> \u2013 UI experience is coming soon. <\/span>\n<\/p>\n

\n 4.\u00a0\u00a0\u00a0\u00a0 <\/span><\/span><\/span>Logging frameworks \u2013 Capture and search trace logging messages from multiple popular logging frameworks: <\/span>\n<\/p>\n

\n a.\u00a0\u00a0\u00a0\u00a0 <\/span><\/span><\/span>System.Diagnostics.Trace<\/a> <\/span>\n<\/p>\n

\n b.\u00a0\u00a0\u00a0\u00a0 <\/span><\/span><\/span>Nlog<\/a> <\/span>\n<\/p>\n

\n c.\u00a0\u00a0\u00a0\u00a0 <\/span><\/span><\/span><\/span>Log4Net<\/a> <\/span> <\/p>\n

<\/span><\/span>\n<\/p>\n

\n d.\u00a0\u00a0\u00a0\u00a0 <\/span><\/span><\/span>Application Insights tracing API<\/span> <\/span>\n<\/p>\n

\n 5.\u00a0\u00a0\u00a0\u00a0 <\/span><\/span><\/span>Web pages \u2013 Insert Javascript<\/a> to instrument client side web code. <\/span>\n<\/p>\n

\n The easiest way to acquire the AppInsights SDK is to add it to your project using Visual Studio 2013 Update 3. Alternatively, you can manually add the NuGet packages from the public NuGet feed. For more information see<\/span>\n<\/p>\n

\n Technorati Tags: insights<\/a>\n<\/div>\n

\n Getting Started with Application Insights<\/span><\/a>.<\/span><\/span>\n<\/p>\n

\n Preview NOTE <\/span> <\/p>\n

<\/b>\n<\/p>\n

\n This SDK is currently in a NuGet pre-release state. It includes new concepts and a new coding experience. Its API is evolving and will probably change in the future based on early adopter feedback.<\/span> <\/span> <\/p>\n

<\/strong>\n<\/p>\n

What will it do for me?<\/h2>\n<\/p>\n

<\/span><\/p>\n

\n It lets you gather information about your application\u2019s usage and behavior in the wild. You can find out how people are using your app, understand what is failing, and identify areas for improvement. Since this is an early version, this is an opportunity for you to influence the direction of the SDK with your feedback, to make sure your requirements are addressed. <\/span>\n<\/p>\n

Request Monitoring<\/span><\/h2>\n

\n The Application Insights for Web SDK will automatically capture incoming server requests to your Asp.Net application. Collection of requests include statistics about each request, including the response time (per request, average per page, and standard deviation), total and request rate, the request URL and request failure rate. <\/span><\/span>\n<\/p>\n

\n \"clip_image002\"<\/a><\/span>\n<\/p>\n

\n Server Request Monitoring <\/span>\n<\/p>\n

Diagnostic Log Capture<\/span><\/h2>\n

\n The Application Insights SDKs allow for capture and analysis of diagnostic logs. Through the inclusion of a logging framework specific adapter, you can configure the SDK to automatically capture all of your existing diagnostic logs.<\/span> <\/span>\n<\/p>\n

\n In addition to automatic capture from the logging framework adapters, you can also directly code against the SDK to emit basic trace messages. See the sample code below for a simple emission of a trace message.<\/span> <\/span>\n<\/p>\n

\n var<\/span> tc = <\/span>new<\/span> Microsoft.ApplicationInsights.<\/span>TelemetryContext<\/span>(); <\/span>\n<\/p>\n

\n tc.TrackTrace(<\/span>“Sample message from the Contact page action”<\/span>);<\/span> <\/span>\n<\/p>\n

\n <\/span>\n<\/p>\n

\u00a0<\/p>\n

\n In addition to the specified message the SDK will also capture a set of automatic metadata to apply to this message. This common contextual data will assist in better understanding the telemetry and reaching richer insights. You can see below the additional contextual data captured along with this basic trace message. <\/span><\/span>\n<\/p>\n

\n \"clip_image004\"<\/a><\/span>\n<\/p>\n

\n Diagnostic Search Details\n<\/p>\n

\n \u00a0<\/span> <\/span> <\/p>\n

<\/span>\n<\/p>\n

\n More information can be found on the Azure documentation site on how to<\/span> <\/span>Search Diagnostic Logs<\/a>. <\/span>\n<\/p>\n

Javascript SDK<\/span><\/h2>\n

\n If you have included the Javascript SDK<\/a> in your application web pages. You will also get out of the box collection of basic web client telemetry. Out of the box telemetry collection includes collection of page views, user sessions, page view urls, and browser versions. <\/span><\/span>\n<\/p>\n

\n \"clip_image005\"<\/a><\/span>\n<\/p>\n

\n Web Client Usage Analytics\n<\/p>\n

\n \u00a0<\/span> <\/span> <\/p>\n

<\/span>\n<\/p>\n

Custom Telemetry API – Preview<\/h2>\n<\/p>\n

<\/span><\/p>\n

\n In addition to the automatic collection of telemetry described above the latest SDK version also includes a preview implementation of a custom telemetry API. You can use this API to collect any telemetry that may be useful to you. <\/span>\n<\/p>\n

\n The core object in the API is the TelemetryContext object. Allowing you to both hold common properties to apply to all telemetry, and basic access to the telemetry logging methods. The API exposes 4 helper methods to track various telemetry. They can be accessed directly to quickly send basic telemetry. <\/span>\n<\/p>\n

\n \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 <\/span><\/span>var<\/span> context = <\/span>new<\/span> Microsoft.ApplicationInsights.<\/span>TelemetryContext<\/span>(); <\/span>\n<\/p>\n

\n \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 <\/span>context.TrackEvent(<\/span>“My usage Event”<\/span>); <\/span>\n<\/p>\n

\n \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 <\/span>context.TrackMetric(<\/span>“MetricCounter”<\/span>, 4.76); <\/span>\n<\/p>\n

\n \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 <\/span>context.TrackTrace(<\/span>“Simple log message”<\/span>); <\/span>\n<\/p>\n

\n \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 <\/span>context.TrackException(<\/span>new<\/span> <\/span>Exception<\/span>(<\/span>“SimpleException”<\/span>)); <\/span>\n<\/p>\n

\n In addition you can create more complex telemetry by creating a telemetry item directly. <\/span>\n<\/p>\n

\n \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 <\/span><\/span>var<\/span> complexEvent = <\/span>new<\/span> Microsoft.ApplicationInsights.<\/span>EventTelemetry<\/span>(); <\/span>\n<\/p>\n

\n \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 <\/span>complexEvent.Name = <\/span>“ComplexEvent”<\/span>; <\/span>\n<\/p>\n

\n \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 <\/span>complexEvent.Properties[<\/span>“CustomProperty”<\/span>] = <\/span>“AnyString”<\/span>; <\/span>\n<\/p>\n

\n \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 <\/span>complexEvent.Metrics[<\/span>“Metric1”<\/span>] = 42; <\/span>\n<\/p>\n

\n \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 <\/span>complexEvent.Metrics[<\/span>“AnotherMetric”<\/span>] = 1.234; <\/span>\n<\/p>\n

\n \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 <\/span>context.Track(complexEvent);<\/span> <\/span>\n<\/p>\n

\n We support 4 core telemetry types today. They all share a common design pattern, e.g. all have the ability to add custom properties, but each has a unique set of properties that better match the use scenario. <\/span>\n<\/p>\n

\n \u00b7\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 <\/span><\/span><\/span>Event \u2013 Used to track discrete actions. Most often used to track user behavior actions. <\/b> <\/p>\n

<\/span>\n<\/p>\n

\n \u00b7\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 <\/span><\/span><\/span>Metric \u2013 Used to compute numeric aggregation of values. <\/b> <\/p>\n

<\/span>\n<\/p>\n

\n \u00b7\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 <\/span><\/span><\/span>Trace \u2013 Used when the primary data is a message string and consumption of that string will be through textual search. <\/b> <\/p>\n

<\/span>\n<\/p>\n

\n \u00b7\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 <\/span><\/span><\/span>Exception \u2013 Used to collect data about a thrown exception, including details like stack trace and throwing location. <\/b> <\/p>\n

<\/span>\n<\/p>\n

\n NOTE:<\/span><\/b> This API is a preview release and is intended to capture feedback and is subject to breaking change in future SDK releases. Not all these telemetry types will be available for visualization in the UI. <\/span>\n<\/p>\n

Windows Phone and Windows Store Apps \u2013 Preview<\/span><\/h2>\n

\n Both Windows Phone 8.0\/8.1 and Windows Store 8.1 application are supported with dedicated NuGet packages. Both packages provide a similar set of functionality. Through simple addition of the NuGet package to your app you will get automatic collection of session starts, application crashes, page views, and the ability for custom telemetry described above. In addition, all telemetry will have additional properties collected automatically, identifying data such as anonymous used id, device id, device model, geo location, screen resolution, etc.<\/span> <\/span>\n<\/p>\n

NOTE<\/span><\/strong>: The pre-release NuGet packages collect all data described above, batch the data for transmission only on application startup \/ resume, and transmit to the AppInsights service. Currently the UI visualization support for Windows Phone and Windows Store Apps is still coming soon. While the data from these packages will be collected and transmitted, there is currently no UI visualization of that data available.<\/span><\/p>\n","protected":false},"excerpt":{"rendered":"

What is it? Application Insights SDK lets you send telemetry to the Application Insights portal, where you can find out what users are doing with your application. 0.10.0 is the latest SDK release for Application Insights. This SDK includes new functionality and new concepts in addition to a change in the basic architecture. Data sent […]<\/p>\n","protected":false},"author":100,"featured_media":45953,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[224,1],"tags":[],"class_list":["post-763","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-azure","category-devops"],"acf":[],"blog_post_summary":"

What is it? Application Insights SDK lets you send telemetry to the Application Insights portal, where you can find out what users are doing with your application. 0.10.0 is the latest SDK release for Application Insights. This SDK includes new functionality and new concepts in addition to a change in the basic architecture. Data sent […]<\/p>\n","_links":{"self":[{"href":"/__p/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/posts\/763","targetHints":{"allow":["GET"]}}],"collection":[{"href":"/__p/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"/__p/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"/__p/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/users\/100"}],"replies":[{"embeddable":true,"href":"/__p/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/comments?post=763"}],"version-history":[{"count":0,"href":"/__p/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/posts\/763\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"/__p/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/media\/45953"}],"wp:attachment":[{"href":"/__p/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/media?parent=763"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"/__p/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/categories?post=763"},{"taxonomy":"post_tag","embeddable":true,"href":"/__p/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/tags?post=763"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}