[Telemetry] Provide starter template and example kusto queries (#1776)

Provide starter template and example kusto queries

Related to #1777

Author: aholstrup1

RELEASENOTES.md

@@ -1,3 +1,7 @@
+### AL-Go Telemetry
+
+AL-Go now offers a dataexplorer dashboard to get started with AL-Go telemetry. Additionally, we've updated the documentation to include a couple of kusto queries if you would rather build your own reports.
+
 ### Issues
 
 - Issue 1770: Wrong type of _projects_ setting in settings schema

Scenarios/EnablingTelemetry.md

@@ -20,6 +20,72 @@ By setting the Microsoft telemetry connection string to be an empty string you o
 
 Sending extended telemetry to Microsoft is helpful for when we need to help investigate an issue in your repository.
 
+## Getting Started with Dashboard and Queries
+
+### Getting Started with Data Explorer
+
+AL-Go provides a template data explorer report to help you get started. To use this report:
+
+1. Download the telemetrydashboard.json file from [here](resources/telemetrydashboard.json)
+1. Open the file in an editor and replace the clusterUri and database:
+   - **database**: Name of your application insights resource in Azure
+   - **clusterUri**: Use the following uri but replace YourSubscriptionId, YourResourceGroup and YourApplicationInsightsName
+     - https://ade.applicationinsights.io/subscriptions/YourSubscriptionId/resourcegroups/YourResourceGroup/providers/microsoft.insights/components/YourApplicationInsightsName
+1. Go to https://dataexplorer.azure.com/dashboards
+1. In the top left corner, click on the arrow next to "New Dashboard" and select "Import dashboard from file".
+
+### Getting Started with writing your own queries
+
+To get started with writing kusto queries for your AL-Go telemetry, you can use the following examples as inspiration.
+
+The following query gets all telemetry emitted when an AL-Go workflow completes.
+
+```
+traces
+| where timestamp > ago(7d)
+| project   timestamp,
+            message,
+            severityLevel,
+            RepositoryOwner = tostring(customDimensions.RepositoryOwner),
+            RepositoryName = tostring(customDimensions.RepositoryName),
+            RunId = tostring(customDimensions.RunId),
+            RunNumber = tostring(customDimensions.RunNumber),
+            RunAttempt = tostring(customDimensions.RunAttempt),
+            WorkflowName = tostring(customDimensions.WorkflowName),
+            WorkflowConclusion = tostring(customDimensions.WorkflowConclusion),
+            WorkflowDurationMinutes = round(todouble(customDimensions.WorkflowDuration) / 60, 2),
+            ALGoVersion = tostring(customDimensions.ALGoVersion),
+            RefName = tostring(customDimensions.RefName)
+| extend HtmlUrl = strcat("https://github.com/", RepositoryName, "/actions/runs/", RunId)
+| where message contains "AL-Go workflow"
+```
+
+The following query gets all telemetry emitted when an AL-Go action completes.
+
+```
+traces
+| where timestamp > ago(7d)
+| project   timestamp,
+            message,
+            severityLevel,
+            RepositoryOwner = tostring(customDimensions.RepositoryOwner),
+            RepositoryName = tostring(customDimensions.RepositoryName),
+            RunId = tostring(customDimensions.RunId),
+            RunNumber = tostring(customDimensions.RunNumber),
+            RunAttempt = tostring(customDimensions.RunAttempt),
+            WorkflowName = tostring(customDimensions.WorkflowName),
+            WorkflowConclusion = tostring(customDimensions.WorkflowConclusion),
+            WorkflowDuration = todouble(customDimensions.WorkflowDuration),
+            ALGoVersion = tostring(customDimensions.ALGoVersion),
+            RefName = tostring(customDimensions.RefName),
+            RunnerOs = tostring(customDimensions.RunnerOs),
+            RunnerEnvironment = tostring(customDimensions.RunnerEnvironment),
+            ErrorMessage = tostring(customDimensions.ErrorMessage),
+            ActionDurationSeconds = todouble(customDimensions.ActionDuration)
+| extend HtmlUrl = strcat("https://github.com/", RepositoryName, "/actions/runs/", RunId)
+| where message contains "AL-Go action"
+```
+
 ## Telemetry events and data
 
 AL-Go logs four different types of telemetry events: AL-Go action ran/failed and AL-Go workflow ran/failed. Each of those telemetry events provide slightly different telemetry but common dimensions for all of them are: