Improve API doc and add desktop SDK

articles/app-insights-data-retention-privacy.md

@@ -11,19 +11,20 @@
 	ms.tgt_pltfrm="ibiza" 
 	ms.devlang="na" 
 	ms.topic="article" 
-	ms.date="2014-11-14" 
+	ms.date="2015-02-11" 
 	ms.author="awills"/>
 
 # Data retention and storage in Application Insights 
 
 *Application Insights is in preview.*
 
+## Overview
 
 This article answers questions about how we store the telemetry that your application sends to Application Insights.
 
 Application Insights stores data in Microsoft Azure servers in the United States of America. Download [Security, Privacy, and Compliance white paper](http://go.microsoft.com/fwlink/?LinkId=392408) for details of the Microsoft Azure policy. Some specifics about Application Insights are answered below. 
 
-#### How much data is stored? 
+## How much data is stored? 
 
 While Application Insights is in this free Preview stage, for each account, we store: 
 
@@ -37,31 +38,36 @@ While Application Insights is in this free Preview stage, for each account, we s
 
 * Over the monthly limit, the events stop being recorded, so your metrics show zeros after some date. 
 
-####How long is the telemetry kept? 
+## How long is the telemetry kept? 
 
 * 7 days for instance data visible in Diagnostic Search. Individual page views, events, log messages, traces, and exceptions. 
 
 * 13 months for aggregated data visible in Metric Explorer. Statistics on metrics, events and exceptions (counts of type, failed function, and so on) are retained at 1 min (or less) grain for 30 days and 1 hour grain for 13 months. 
 
-####Where is the data held? 
+## Where is the data held? 
 
 * In the USA. 
 
 Do you have an option to store it in Europe or somewhere else? 
 
 * Not yet. 
 
-####How secure is my telemetry data? 
+## How secure is my telemetry data? 
 
 The data is stored in Microsoft Azure servers, and for accounts in the Azure Preview Portal, account restrictions are described in the Azure Security, Privacy, and Compliance document. For accounts in the Visual Studio Online Portal, the VS Online Data Protection document applies. 
 
 Access to your data by Microsoft personnel is restricted. We access your data only with your permission and if it is necessary to support your use of Application Insights. 
 
-####Is the data encrypted in Application Insights servers? 
+## Is the data encrypted in Application Insights servers? 
 
 Not at present. 
 
-####Could Personally Identifiable Information (PII) be sent to Application Insights? 
+## Is the data encrypted in transit from my application to Application Insights servers?
+
+Yes, we use https to send data from the SDKs to the portal. The only exception is telemetry sent from plain http web pages.
+
+
+## Could Personally Identifiable Information (PII) be sent to Application Insights? 
 
 Yes. Both PII sent to Application Insights by your code in custom telemetry, and PII included in the standard telemetry. The Azure privacy statement applies to Application Insights. 
 
@@ -72,7 +78,7 @@ There are several ways in which data might be sent to the portal. It might then
 * If you insert telemetry calls such as TrackEvent in your code, or if you capture logging framework messages, the properties could include PII. The Microsoft Online Services Terms also applies. For Application Insights particularly, you must comply with laws and regulations applicable to privacy and data collection. You should determine whether Notification or other Consent is needed before collecting the information. 
 
 
-####What telemetry is sent when I use Application Insights? 
+## What telemetry is sent when I use Application Insights? 
 
 There are several components you can install. (Refer to [Application Insights - get started][start].) 
 

articles/app-insights-detect-triage-diagnose.md

@@ -248,6 +248,9 @@ Application Insights can also be used to learn what users do with an app. Once i
 
 So that's how one team use Application Insights not just to fix individual issues, but to improve their development lifecycle. I hope it has given you some ideas about how Application Insights can help you improve the performance of your own applications.
 
+## Video
+
+[AZURE.VIDEO app-insights-performance-monitoring]
 
 [AZURE.INCLUDE [app-insights-learn-more](../includes/app-insights-learn-more.md)]
 

articles/app-insights-diagnostic-search.md

@@ -18,7 +18,7 @@
 
 Diagnostic Search is the blade in [Application Insights][start] that you use to find and explore individual telemetry items, such as page views, exceptions, or web requests. And you can view log traces and events that you have coded.
 
-## When you see Diagnostic Search
+## When do you see Diagnostic Search?
 
 You can open diagnostic search explicitly:
 
@@ -59,7 +59,7 @@ The event types are:
 * **Custom Event** - If you inserted calls to TrackEvent() in order to [monitor usage][track], you can search them here.
 * **Exception** - Uncaught exceptions in the server, and those that you log by using TrackException().
 
-### Filter on property values
+## Filter on property values
 
 You can filter events on the values of their properties. The available properties depend on the event types you selected. 
 

articles/app-insights-metrics-explorer.md

@@ -28,7 +28,7 @@ Some charts are segmented: the total height of the chart at any point is the sum
 
 Dotted lines show the value of the metric one week previously.
 
-#### Point values
+## Point values
 
 Hover your mouse over the chart to display the values of the metrics at that point.
 
@@ -37,7 +37,7 @@ Hover your mouse over the chart to display the values of the metrics at that poi
 
 The value of the metric at a particular point is averaged over the preceding sampling interval. This can vary depending on the time range of the whole chart. So relative heights are a better guide than absolute values.
 
-#### Time range
+## Time range
 
 You can change the Time range covered by most of the charts or grids on any blade.
 
@@ -55,7 +55,7 @@ For example, click through the web app's Failed Requests chart:
 ![On the overview blade, click a chart](./media/app-insights-metrics-explorer/14-trix.png)
 
 
-#### What do the figures mean?
+## What do the figures mean?
 
 The legend at the side by default shows the aggregated value over the period of the chart.
 Different metrics are aggregated in different ways: 
@@ -84,7 +84,7 @@ You can display more than one metric on a chart, though there are restrictions a
 
 If you coded [custom metrics][track] into your app (calls to TrackMetric and TrackEvent) they will be listed here.
 
-#### Segment your data
+## Segment your data
 
 Select a chart or grid, switch on segmenting and pick a property to segment by:
 
@@ -98,7 +98,7 @@ Is the chart too small for segmented data? Adjust its height:
 ![](./media/app-insights-metrics-explorer/18-height.png)
 
 
-#### Filter your data
+## Filter your data
 
 To see just the metrics for a selected set of property values:
 
@@ -108,13 +108,13 @@ If you don't select any values for a particular property, it's the same as selec
 
 Notice the counts of events alongside each property value. When you select values of one property, the counts alongside other property values are adjusted.
 
-#### Edit the chart type
+## Edit the chart type
 
 In particular, notice that you can switch between grids and graphs:
 
 ![Select a grid or graph, then choose a chart type](./media/app-insights-metrics-explorer/16-chart-grid.png)
 
-#### Reset the blade
+## Reset the blade
 
 When you click on a chart, for example on the overview blade, it opens a relevant set of charts and grids to show you more detail.
 

articles/app-insights-monitor-performance-live-website-now.md

@@ -127,6 +127,9 @@ IIS support is: IIS 7, 7.5, 8, 8.5
 * [Add web client telemetry][usage] to see exceptions from web page code and to let you insert trace calls.
 * [Add Application Insights SDK to your web service code][greenbrown] so that you can insert trace and log calls in the server code.
 
+## Video
+
+[AZURE.VIDEO app-insights-performance-monitoring]
 
 [AZURE.INCLUDE [app-insights-learn-more](../includes/app-insights-learn-more.md)]
 

articles/app-insights-platforms.md

@@ -0,0 +1,56 @@
+<properties 
+	pageTitle="Application Insights: platforms" 
+	description="Can I use Application Insights with...?" 
+	services="application-insights" 
+	authors="alancameronwills" 
+	manager="kamrani"/>
+
+<tags 
+	ms.service="application-insights" 
+	ms.workload="tbd" 
+	ms.tgt_pltfrm="ibiza" 
+	ms.devlang="na" 
+	ms.topic="article" 
+	ms.date="2015-02-14" 
+	ms.author="awills"/>
+
+# Application Insights: platforms
+
+## <a name="platforms"</a>Can I use Application Insights with ...?
+
+
++	[Android](https://github.com/Microsoft/AppInsights-Android)
++	[Ruby](https://rubygems.org/gems/application_insights) 
++	[PHP](https://github.com/Microsoft/AppInsights-PHP)
++	[Node.JS](https://www.npmjs.com/package/applicationinsights)
++	[Python](https://pypi.python.org/pypi/applicationinsights/0.1.0)
++	[WordPress](https://wordpress.org/plugins/application-insights/)
++	[Angular](http://ngmodules.org/modules/angular-appinsights)
++	[Cordova](#cordova)
++	[Windows Store JavaScript apps](#cordova)
++	[Log4Net, NLog, or System.Diagnostics.Trace][diagnostic]
++	[Windows Store and Phone apps][windows]
++	[An IIS website that's already running][redfield]
++	[An Azure website][azure]
+
+
+Please also visit the [Application Insights SDK project on GitHub](https://github.com/Microsoft/AppInsights-Home)
+
+
+### <a name="cordova"></a>Cordova and Windows Store JavaScript apps
+
+Use the standard client-side [web app script][usage], but with one change.
+
+When you get the script from the Application Insights portal, insert a line after the instrumentation key:
+
+    ...{
+        instrumentationKey:"00000000-662d-4479-0000-40c89770e67c",
+        endpointUrl:"https://dc.services.visualstudio.com/v2/track"
+    } ...
+
+[>Cordova](http://cordova.apache.org/)
+[>Windows Store apps using JavaScript](https://msdn.microsoft.com/en-us/library/windows/apps/br211385.aspx)
+
+[AZURE.INCLUDE [app-insights-learn-more](../includes/app-insights-learn-more.md)]
+
+

articles/app-insights-start-monitoring-app-health-usage.md

@@ -61,7 +61,7 @@ In Visual Studio, you'll see a count of the events that have been received.
 
 ![](./media/appinsights/appinsights-09eventcount.png)
 
-### <a name="monitor"></a>3. View telemetry
+## <a name="monitor"></a>3. View your telemetry
 
 Open Application Insights from your project.
 

articles/app-insights-troubleshoot-faq.md

@@ -18,17 +18,7 @@
 
 ## <a name="platforms"</a>Can I use Application Insights with ...?
 
-+	[Ruby](https://rubygems.org/gems/application_insights) 
-+	[Node.JS](https://www.npmjs.com/package/applicationinsights)
-+	[Python](https://pypi.python.org/pypi/applicationinsights/0.1.0)
-+	[WordPress](https://wordpress.org/plugins/application-insights/)
-+	[Angular](http://ngmodules.org/modules/angular-appinsights)
-+	[Cordova](#cordova)
-+	[Windows Store JavaScript apps](#cordova)
-+	[Log4Net, NLog, or System.Diagnostics.Trace][diagnostic]
-+	[Windows Store and Phone apps][windows]
-+	[An IIS website that's already running][redfield]
-+	[An Azure website][azure]
+[See Platforms][platforms]
 
 
 ## <a name="q01"></a>I don't see any option to Add Application Insights to my project in Visual Studio
@@ -140,10 +130,6 @@ Web availability tests depend on incoming access to your web server on port 80.
 
 Take a look at [Data Retention and Privacy][data].
 
-## <a name="cordova"></a>Can I use Application Insights with Cordova or Windows Store JavaScript apps?
-
-Yes - you can use the standard client-side [web app script][usage] with one addition: Explicitly set the endpoint url (that is, the destination for the telemetry): 
-   https://dc.services.visualstudio.com/v2/track
 
 
 ## <a name="q17"></a> Have I enabled everything in Application Insights?

articles/app-insights-web-monitor-performance.md

@@ -131,7 +131,9 @@ Here are a few tips for finding and diagnosing performance issues:
 
 [Troubleshooting][qna] - and Q & A
 
+## Video
 
+[AZURE.VIDEO app-insights-performance-monitoring]
 
 [AZURE.INCLUDE [app-insights-learn-more](../includes/app-insights-learn-more.md)]