Start Monitoring Your ASP.NET Core Web Application
With Azure Application Insights, you can easily monitor your web application for availability, performance, and usage. You can also quickly identify and diagnose errors in your application without waiting for a user to report them.
This quickstart guides you through adding the Application Insights SDK to an existing ASP.Net Core web application.
To complete this quickstart:
- Install Visual Studio 2017 with the following workloads:
- ASP.NET and web development
- Azure development
- Install .NET Core 2.0 SDK
- You will need an Azure subscription and an existing .NET Core web application.
If you don't have a ASP.NET Core web application, you can use our step-by-step guide to create a ASP.NET Core app and add Application Insights.
If you don't have an Azure subscription, create a free account before you begin.
Log in to the Azure portal
Log in to the Azure portal.
Enable Application Insights
Application Insights can gather telemetry data from any internet-connected application, regardless of whether it's running on-premises or in the cloud. Use the following steps to start viewing this data.
Select Create a resource > Monitoring + Management > Application Insights.
A configuration box appears; use the following table to fill out the input fields.
Settings Value Description Name Globally Unique Value Name that identifies the app you are monitoring Application Type ASP.NET web application Type of app you are monitoring Resource Group myResourceGroup Name for the new resource group to host App Insights data Location East US Choose a location near you, or near where your app is hosted
Configure App Insights SDK
Open your ASP.NET Core Web App project in Visual Studio > Right-click on the AppName in the Solution Explorer > Select Add > Application Insights Telemetry.
Click the Start Free button > Select the Existing resource you created in the Azure portal > Click Register.
Select Debug > Start without Debugging (Ctrl+F5) to Launch your app
It takes 3-5 minutes before data begins appearing in the portal. If this app is a low-traffic test app, keep in mind that most metrics are only captured when there are active requests or operations.
Start monitoring in the Azure portal
You can now reopen the Application Insights Overview page in the Azure portal by selecting Project > Application Insights > Open Application Insights Portal, to view details about your currently running application.
Click Application map for a visual layout of the dependency relationships between your application components. Each component shows KPIs such as load, performance, failures, and alerts.
Click on the App Analytics icon . This opens Application Insights Analytics, which provides a rich query language for analyzing all data collected by Application Insights. In this case, a query is generated for you that renders the request count as a chart. You can write your own queries to analyze other data.
Return to the Overview page and examine the KPI Dashobards. This dashboard provides statistics about your application health, including the number of incoming requests, the duration of those requests, and any failures that occur.
To enable the Page View Load Time chart to populate with client-side telemetry data, add this script to each page that you want to track:
Click on Browser from under the Investigate header. Here you find metrics related to the performance of your app's pages . You can click Add new chart to create additional custom views or select Edit to modify the existing chart types, height, color palette, groupings, and metrics.
Clean up resources
If you plan to continue on to work with subsequent quickstarts or with the tutorials, do not clean up the resources created in this quick start. If you do not plan to continue, use the following steps to delete all resources created by this quick start in the Azure portal.
- From the left-hand menu in the Azure portal, click Resource groups and then click myResourceGroup.
- On your resource group page, click Delete, type myResourceGroup in the text box, and then click Delete.