troubleshooting

Readme.md

@@ -64,5 +64,8 @@ Refer to our [Milestones](https://github.com/microsoft/ApplicationInsights-dotne
 
 ## Support
 
+A guide on common troubleshooting topics is available [here](troubleshooting).
+
 For immediate support relating to the Application Insights .NET SDK we encourage you to file an [Azure Support Request](https://docs.microsoft.com/azure/azure-portal/supportability/how-to-create-azure-support-request) with Microsoft Azure instead of filing a GitHub Issue in this repository. 
 You can do so by going online to the [Azure portal](https://portal.azure.com/) and submitting a support request. Access to subscription management and billing support is included with your Microsoft Azure subscription, and technical support is provided through one of the [Azure Support Plans](https://azure.microsoft.com/support/plans/). For step-by-step guidance for the Azure portal, see [How to create an Azure support request](https://docs.microsoft.com/azure/azure-portal/supportability/how-to-create-azure-support-request). Alternatively, you can create and manage your support tickets programmatically using the [Azure Support ticket REST API](https://docs.microsoft.com/rest/api/support/).
+

troubleshooting/Ingestion/PostTelemetry.ps1

@@ -0,0 +1,35 @@
+$url="https://{IngestionEndpoint-from-Component-ConnectionString}/v2/track"
+$iKey="{test-iKey}"
+Write-Host $url, $iKey
+
+$time = Get-Date
+$time = $time.ToUniversalTime().ToString('o')
+
+$availabilityData = @"
+{
+    "data": {
+		"baseData": {
+			"ver": 2,
+			"id": "TestId",
+			"name": "Post Telemetry Test",
+			"duration": "10.00:00:00",
+			"success": true,
+			"runLocation": "TestLocation",
+			"message": "Test Message",
+			"properties": {
+				"TestProperty": "TestValue"
+			}
+		},
+		"baseType": "AvailabilityData"
+	},
+    "ver": 1,
+	"name": "Microsoft.ApplicationInsights.Metric",
+	"time": "$time",
+	"sampleRate": 100,
+	"iKey": "$iKey",
+	"flags": 0
+}
+"@
+
+Invoke-WebRequest -Uri $url -Method POST -Body $availabilityData -Verbose -Debug -UseBasicParsing
+# Expected Output: {"itemsReceived":1,"itemsAccepted":1,"errors":[]}

troubleshooting/Ingestion/Readme.md

@@ -0,0 +1,13 @@
+# Troubleshooting Ingestion
+
+## Fiddler
+
+A tool such as Fiddler can be used to inspect raw HTTPS data from an app integrated with SDK to Ingestion Service.
+
+## Networking
+
+If the SDK is unable to send telemetry to the Ingestion Service, you may be experiencing a networking issue.
+
+Please review our guides on [IP Addresses used by Azure Monitor](https://docs.microsoft.com/azure/azure-monitor/app/ip-addresses)
+
+You can test your network by manually sending telemetry using the PowerShell script [PostTelemetry.ps1](PostTelemetry.ps1).

troubleshooting/Readme.md

@@ -0,0 +1,23 @@
+# Troubleshooting
+
+## For Immediate Support 
+
+For immediate support relating to the Application Insights .NET SDK we encourage you to file an [Azure Support Request](https://docs.microsoft.com/azure/azure-portal/supportability/how-to-create-azure-support-request) with Microsoft Azure instead of filing a GitHub Issue in this repository. 
+You can do so by going online to the [Azure portal](https://portal.azure.com/) and submitting a support request. Access to subscription management and billing support is included with your Microsoft Azure subscription, and technical support is provided through one of the [Azure Support Plans](https://azure.microsoft.com/support/plans/). For step-by-step guidance for the Azure portal, see [How to create an Azure support request](https://docs.microsoft.com/azure/azure-portal/supportability/how-to-create-azure-support-request). Alternatively, you can create and manage your support tickets programmatically using the [Azure Support ticket REST API](https://docs.microsoft.com/rest/api/support/).
+
+## SDK Internal Logs
+
+The Application Insights .NET SDK uses ETW to expose internal exceptions.
+
+To collect these logs, please review our full guide on [ETW](ETW).
+
+## Networking Issues
+
+The Application Insights .NET SDK has no knowledge of the environment it's deployed in.
+The SDK will send telemetry to the configured endpoint. 
+
+If you suspect networking issues, please review our guide on [Troubleshooting Ingestion](Ingestion).
+
+## No Data
+
+Please review our full guide on [Troubleshooting no data](https://docs.microsoft.com/azure/azure-monitor/app/asp-net-troubleshoot-no-data)