Application Insights instellen voor uw ASP.NET-websiteSet up Application Insights for your ASP.NET website

Met deze procedure wordt uw ASP.NET web-app zo geconfigureerd dat telemetrie wordt verzonden naar de Azure Application Insights-service.This procedure configures your ASP.NET web app to send telemetry to the Azure Application Insights service. Dit werkt voor ASP.NET-apps die worden gehost op uw eigen on-premises IIS-server of in de cloud.It works for ASP.NET apps that are hosted either in your own IIS server on-premises or in the Cloud. U beschikt over grafieken en een krachtige querytaal waarmee u meer inzicht krijgt in de prestaties van uw app en hoe mensen deze gebruiken. Daarnaast ontvangt u meldingen over fouten of prestatieproblemen.You get charts and a powerful query language that help you understand the performance of your app and how people are using it, plus automatic alerts on failures or performance issues. Veel ontwikkelaars gebruiken deze functies graag, maar u kunt de telemetrie desgewenst uitbreiden en aanpassen.Many developers find these features great as they are, but you can also extend and customize the telemetry if you need to.

Voor de Setup zijn maar een paar klikken nodig in Visual Studio.Setup takes just a few clicks in Visual Studio. U kunt kosten besparen door de hoeveelheid telemetrie te beperken.You have the option to avoid charges by limiting the volume of telemetry. Met deze functie kunt u experimenteren en fouten opsporen, of een site met niet veel gebruikers bewaken.This functionality allows you to experiment and debug, or to monitor a site with not many users. Wanneer u besluit dat u de productiesite wilt bewaken, kunt u de limiet later eenvoudig verhogen.When you decide you want to go ahead and monitor your production site, it's easy to raise the limit later.

VereistenPrerequisites

Als u Application Insights wilt toevoegen aan uw ASP.NET-website, moet u het volgende doen:To add Application Insights to your ASP.NET website, you need to:

  • Installeer Visual Studio 2019 voor Windows met de volgende werk belastingen:Install Visual Studio 2019 for Windows with the following workloads:
    • ASP.NET en Web Development (de optionele onderdelen niet uitschakelen)ASP.NET and web development (Do not uncheck the optional components)
    • Azure-ontwikkelingAzure development

Als u nog geen Azure-abonnement hebt, maakt u een gratis account voordat u begint.If you don't have an Azure subscription, create a free account before you begin.

Stap 1: de Application Insights-SDK toevoegenStep 1: Add the Application Insights SDK

Belangrijk

De scherm afbeeldingen in dit voor beeld zijn gebaseerd op Visual Studio 2017 versie 15.9.9 en hoger.The screenshots in this example are based on Visual Studio 2017 version 15.9.9 and later. De ervaring om Application Insights toe te voegen, is afhankelijk van zowel de versie van Visual Studio als het sjabloon type ASP.NET.The experience to add Application Insights varies across versions of Visual Studio as well as by ASP.NET template type. Oudere versies kunnen alternatieve tekst bevatten, zoals "Configure Application Insights".Older versions may have alternate text such as "Configure Application Insights".

Klik met de rechter muisknop op de naam van uw web-app in de Solution Explorer en kies > toevoegen Application Insights TelemetryRight-click your web app name in the Solution Explorer, and choose Add > Application Insights Telemetry

Schermopname van Solution Explorer waarin Application Insights is gemarkeerd

(Afhankelijk van de Application Insights-SDK-versie wordt u mogelijk gevraagd om een upgrade uit te voeren naar de meest recente SDK-versie.(Depending on your Application Insights SDK version you may be prompted to upgrade to the latest SDK release. Als u hierom wordt gevraagd, selecteert u SDK bijwerken.)If prompted, select Update SDK.)

Schermopname: Er is een nieuwe versie van Microsoft Application Insights-SDK beschikbaar.

Application Insights-configuratiescherm:Application Insights Configuration screen:

Selecteer aan de slag.Select Get Started.

Schermopname van de pagina Uw app registreren bij Application Insights

Als u een resourcegroep of locatie wilt instellen voor het opslaan van uw gegevens, klikt u op Instellingen configureren.If you want to set the resource group or the location where your data is stored, click Configure settings. Resourcegroepen worden gebruikt om toegang tot gegevens te beheren.Resource groups are used to control access to data. Als u verschillende apps hebt die deel uitmaken van hetzelfde systeem, kunt u hun Application Insights-gegevens in dezelfde resourcegroep plaatsen.For example, if you have several apps that form part of the same system, you might put their Application Insights data in the same resource group.

Selecteer Registreren.Select Register.

Schermopname van de pagina Uw app registreren bij Application Insights

Selecteer Project > NuGet-pakketten te beheren > pakket Bron: nuget.org > Controleer of u de laatste stabiele versie van de Application Insights SDK hebt.Select Project > Manage NuGet Packages > Package source: nuget.org > Confirm that you have the latest stable release of the Application Insights SDK.

Er wordt telemetrie verzonden naar Azure Portal, zowel tijdens de foutopsporing als na het publiceren van de app.Telemetry will be sent to the Azure portal, both during debugging and after you have published your app.

Notitie

Als u geen telemetrie naar de portal wilt verzenden tijdens de foutopsporing, voegt u de Application Insights SDK toe aan de app, maar configureert u geen resource in de portal.If you don't want to send telemetry to the portal while you're debugging, just add the Application Insights SDK to your app but don't configure a resource in the portal. U kunt de telemetrie in Visual Studio bekijken tijdens de foutopsporing.You are able to see telemetry in Visual Studio while you are debugging. U kunt later terugkeren naar deze configuratiepagina, of u kunt wachten tot de app is geïmplementeerd en telemetrie inschakelen tijdens runtime.Later, you can return to this configuration page, or you could wait until after you have deployed your app and switch on telemetry at run time.

Stap 2: uw app uitvoerenStep 2: Run your app

Voer uw app uit met F5.Run your app with F5. Open verschillende pagina's om telemetrie te genereren.Open different pages to generate some telemetry.

In Visual Studio ziet u het aantal gebeurtenissen dat is vastgelegd in een logboek.In Visual Studio, you will see a count of the events that have been logged.

Schermopname van Visual Studio.

Stap 3: uw telemetrie weergevenStep 3: See your telemetry

U ziet uw telemetrie in Visual Studio of in de Application Insights-webportal.You can see your telemetry either in Visual Studio or in the Application Insights web portal. Zoek telemetrie in Visual Studio om fouten in de app op te sporen.Search telemetry in Visual Studio to help you debug your app. Bewaak de prestaties en het gebruik in de webportal wanneer het systeem live is.Monitor performance and usage in the web portal when your system is live.

De telemetrie bekijken in Visual StudioSee your telemetry in Visual Studio

In Visual Studio om de Application Insights-gegevens te bekijken.In Visual Studio, to view Application Insights data. Selecteer Solution Explorer > Verbonden services > klik met de rechtermuisknop op Application Insights, en klik vervolgens op Zoeken in live telemetrie.Select Solution Explorer > Connected Services > right-click Application Insights, and then click Search Live Telemetry.

In het zoekvenster van Visual Studio Application Insights ziet u de telemetriegegevens van de toepassing die zijn gegenereerd aan de serverzijde van de app.In the Visual Studio Application Insights Search window, you will see the data from your application for telemetry generated in the server side of your app. Experimenteer met de filters en klik op een gebeurtenis voor meer details.Experiment with the filters, and click any event to see more detail.

Schermopname van de weergave Gegevens van foutopsporingssessie in het venster Application Insights.

Tip

Als u geen gegevens ziet, controleert u of het tijdsbereik correct is en klikt u op het pictogram Zoeken.If you don't see any data, make sure the time range is correct, and click the Search icon.

Meer informatie over Application Insights-hulpprogramma's in Visual Studio.Learn more about Application Insights tools in Visual Studio.

Telemetrie bekijken in de webportalSee telemetry in web portal

U kunt de telemetrie ook in de Application Insights-webportal bekijken (tenzij u ervoor hebt gekozen alleen de SDK te installeren).You can also see telemetry in the Application Insights web portal (unless you chose to install only the SDK). De portal bevat meer grafieken, analysefuncties en weergaven met meerdere onderdelen dan Visual Studio.The portal has more charts, analytic tools, and cross-component views than Visual Studio. De portal bevat ook waarschuwingen.The portal also provides alerts.

Open uw Application Insights-resource.Open your Application Insights resource. Meld u aan bij Azure Portal om de telemetrie te bekijken, of selecteer hiervoor Solution Explorer > Verbonden services > klik met de rechtermuisknop op Application Insights > Application Insights-portal openen.Either sign into the Azure portal and find it there, or select Solution Explorer > Connected Services > right-click Application Insights > Open Application Insights Portal and let it take you there.

De portal wordt geopend met een weergave van de telemetrie van uw app.The portal opens on a view of the telemetry from your app.

Schermopname van Application Insights-overzichtspagina

Klik in de portal op een tegel of grafiek om meer details te bekijken.In the portal, click any tile or chart to see more detail.

Stap 4: uw app publicerenStep 4: Publish your app

Publiceer uw app op de IIS-server of op Azure.Publish your app to your IIS server or to Azure. Bekijk de livestream met metrische gegevens in Live Metrics Stream om te controleren of alles goed werkt.Watch Live Metrics Stream to make sure everything is running smoothly.

Uw telemetrie bouwt op in de Application Insights Portal, waar u metrische gegevens kunt controleren, uw telemetrie doorzoekt.Your telemetry builds up in the Application Insights portal, where you can monitor metrics, search your telemetry. U kunt ook de krachtige Kusto-query taal gebruiken om het gebruik en de prestaties te analyseren of om specifieke gebeurtenissen te zoeken.You can also use the powerful Kusto query language to analyze usage and performance, or to find specific events.

U kunt uw telemetrie ook blijven analyseren in Visual Studio met hulpprogramma's voor diagnostisch zoeken en Trends.You can also continue to analyze your telemetry in Visual Studio, with tools such as diagnostic search and trends.

Notitie

Als uw app zoveel telemetrie verzendt dat debeperkingslimieten worden benaderd, worden automatisch steekproeven ingeschakeld.If your app sends enough telemetry to approach the throttling limits, automatic sampling switches on. Met steekproeven vermindert u de hoeveelheid telemetrie die vanuit uw app wordt verzonden, maar behoudt u gecorreleerde gegevens voor diagnostische doeleinden.Sampling reduces the quantity of telemetry sent from your app, while preserving correlated data for diagnostic purposes.

U bent nu klaarYou're all set

Gefeliciteerd!Congratulations! U hebt het pakket Application Insights geïnstalleerd in uw app en dit zo geconfigureerd dat telemetrie wordt verzonden naar de Application Insights-service in Azure.You installed the Application Insights package in your app, and configured it to send telemetry to the Application Insights service on Azure.

De Azure-resource die de telemetrie van uw app ontvangt, wordt aangeduid met een instrumentatiesleutel.The Azure resource that receives your app's telemetry is identified by an instrumentation key. U vindt deze sleutel in het bestand ApplicationInsights.config.You'll find this key in the ApplicationInsights.config file.

Upgraden naar toekomstige SDK-versiesUpgrade to future SDK versions

Als u wilt upgraden naar een nieuwe release van de SDK, opent u NuGet-pakketbeheer opnieuw en filtert u op geïnstalleerde pakketten.To upgrade to a new release of the SDK, open the NuGet package manager, and filter on installed packages. Selecteer Microsoft.ApplicationInsights.Web en kies Upgraden.Select Microsoft.ApplicationInsights.Web, and choose Upgrade.

Als u aanpassingen in ApplicationInsights.config hebt aangebracht, slaat u hiervan een kopie op voordat u de upgrade uitvoert.If you made any customizations to ApplicationInsights.config, save a copy of it before you upgrade. Voeg de wijzigingen vervolgens samen in de nieuwe versie.Then, merge your changes into the new version.

VideoVideo

Volgende stappenNext steps

Er zijn ook andere onderwerpen die u kunt bekijken als u geïnteresseerd bent in:There are alternative topics to look at if you are interested in:

Meer telemetrieMore telemetry

AnalyseAnalysis

WaarschuwingenAlerts

  • Beschikbaarheidstests: maak tests om ervoor te zorgen dat uw site zichtbaar is op internet.Availability tests: Create tests to make sure your site is visible on the web.
  • Slimme diagnostische gegevens: deze tests worden automatisch uitgevoerd, zodat u niets hoeft te doen om ze in te stellen.Smart diagnostics: These tests run automatically, so you don't have to do anything to set them up. Deze geeft aan of een app een ongebruikelijk aantal mislukte aanvragen heeft.They tell you if your app has an unusual rate of failed requests.
  • Metrische waarschuwingen: Stel waarschuwingen in om u te waarschuwen als een metriek een drempel waarde overschrijdt.Metric alerts: Set alerts to warn you if a metric crosses a threshold. U kunt deze instellen op aangepaste metrische gegevens die u in uw app codeert.You can set them on custom metrics that you code into your app.

AutomationAutomation