Einrichten von Application Insights für Ihre ASP.NET-WebsiteSet up Application Insights for your ASP.NET website

Mit diesem Verfahren wird Ihre ASP.NET-Web-App so konfiguriert, dass sie Telemetriedaten an den Azure Application Insights-Dienst sendet.This procedure configures your ASP.NET web app to send telemetry to the Azure Application Insights service. Dies funktioniert für ASP.NET-Apps, die entweder lokal auf Ihrem eigenen IIS-Server oder in der Cloud gehostet werden.It works for ASP.NET apps that are hosted either in your own IIS server on-premises or in the Cloud. Sie erhalten Diagramme und eine leistungsfähige Abfragesprache, mit deren Hilfe Sie die Leistung Ihrer App sowie deren Verwendung durch die Benutzer nachvollziehen können. Darüber hinaus erhalten Sie automatische Warnungen bei Ausfällen oder Leistungsproblemen.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. Für viele Entwickler sind diese Features bereits ausreichend, bei Bedarf kann die Telemetrie aber auch noch erweitert und angepasst werden.Many developers find these features great as they are, but you can also extend and customize the telemetry if you need to.

Die Einrichtung ist mit wenigen Mausklicks in Visual Studio erledigt.Setup takes just a few clicks in Visual Studio. Das Volumen der Telemetriedaten kann eingeschränkt werden, um Kosten zu vermeiden.You have the option to avoid charges by limiting the volume of telemetry. Mit dieser Funktion können Sie experimentieren und debuggen oder eine Website mit nur wenigen Benutzern überwachen.This functionality allows you to experiment and debug, or to monitor a site with not many users. Und wenn Sie dann später Ihre Produktionswebsite überwachen möchten, können Sie den Grenzwert problemlos erhöhen.When you decide you want to go ahead and monitor your production site, it's easy to raise the limit later.

VoraussetzungenPrerequisites

Sie benötigen Folgendes, um Application Insights Ihrer ASP.NET-Website hinzuzufügen:To add Application Insights to your ASP.NET website, you need to:

  • Installieren Sie Visual Studio 2019 für Windows mit folgenden Workloads:Install Visual Studio 2019 for Windows with the following workloads:
    • ASP.NET und Webentwicklung (Deaktivieren Sie nicht die optionalen Komponenten.)ASP.NET and web development (Do not uncheck the optional components)
    • Azure-EntwicklungAzure development

Wenn Sie kein Azure-Abonnement besitzen, können Sie ein kostenloses Konto erstellen, bevor Sie beginnen.If you don't have an Azure subscription, create a free account before you begin.

Schritt 1: Hinzufügen des Application Insights SDKStep 1: Add the Application Insights SDK

Wichtig

Die Screenshots in diesem Beispiel basieren auf Visual Studio 2017, Version 15.9.9 und höher.The screenshots in this example are based on Visual Studio 2017 version 15.9.9 and later. Die Art und Weise, mit der Application Insights hinzugefügt wird, variiert je nach Visual Studio-Version sowie je nach ASP.NET-Vorlagentyp.The experience to add Application Insights varies across versions of Visual Studio as well as by ASP.NET template type. Ältere Version weisen möglicherweise Alternativtext wie „Application Insights konfigurieren“ auf.Older versions may have alternate text such as "Configure Application Insights".

Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Namen Ihrer Web-App, und wählen Sie Hinzufügen > Application Insights-Telemetrie aus.Right-click your web app name in the Solution Explorer, and choose Add > Application Insights Telemetry

Screenshot: Projektmappen-Explorer mit Hervorhebung von „Application Insights konfigurieren“

(Je nach der Version Ihres Application Insights SDK werden Sie ggf. aufgefordert, ein Upgrade auf das aktuelle SDK-Release durchzuführen.(Depending on your Application Insights SDK version you may be prompted to upgrade to the latest SDK release. Wählen Sie SDK aktualisieren, falls Sie diese Aufforderung erhalten.)If prompted, select Update SDK.)

Screenshot: Neue Version des Microsoft Application Insights SDK verfügbar.

Bildschirm für Application Insights-Konfiguration:Application Insights Configuration screen:

Wählen Sie Erste Schritte aus.Select Get Started.

Screenshot der Seite „App bei Application Insights registrieren“

Wenn Sie die Ressourcengruppe oder den Speicherort Ihrer Daten festlegen möchten, klicken Sie auf Einstellungen konfigurieren.If you want to set the resource group or the location where your data is stored, click Configure settings. Ressourcengruppen werden zum Steuern das Zugriffs auf die Daten verwendet.Resource groups are used to control access to data. Wenn Sie über mehrere Apps verfügen, die einen Teil desselben Systems bilden, können Sie die dazugehörigen Application Insights-Daten in derselben Ressourcengruppe anordnen.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.

Wählen Sie Registrieren.Select Register.

Screenshot der Seite „App bei Application Insights registrieren“

Wählen Sie Projekt > NuGet-Pakete verwalten > Paketquelle: nuget.org aus, und vergewissern Sie sich, dass Sie über die neueste stabile Version des Application Insights SDK verfügen.Select Project > Manage NuGet Packages > Package source: nuget.org > Confirm that you have the latest stable release of the Application Insights SDK.

Die Telemetriedaten werden an das Azure-Portal gesendet – sowohl während des Debuggens als auch nach dem Veröffentlichen Ihrer App.Telemetry will be sent to the Azure portal, both during debugging and after you have published your app.

Hinweis

Wenn beim Debuggen keine Telemetriedaten an das Verwaltungsportal gesendet werden sollen, fügen Sie Ihrer App nur das Application Insights SDK hinzu, konfigurieren Sie aber im Portal keine Ressource.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. Telemetriedaten werden beim Debuggen in Visual Studio angezeigt.You are able to see telemetry in Visual Studio while you are debugging. Sie können später zu dieser Konfigurationsseite zurückkehren oder warten, bis Sie Ihre App bereitgestellt haben, und die Telemetrie zur Laufzeit aktivieren.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.

Schritt 2: Führen Sie Ihre App aus.Step 2: Run your app

Führen Sie Ihre App mit F5 aus.Run your app with F5. Öffnen Sie verschiedene Seiten, um Telemetriedaten zu generieren.Open different pages to generate some telemetry.

In Visual Studio wird die Anzahl von protokollierten Ereignissen angezeigt.In Visual Studio, you will see a count of the events that have been logged.

Screenshot von Visual Studio

Schritt 3: Anzeigen der TelemetrieStep 3: See your telemetry

Sie können Ihre Telemetriedaten entweder in Visual Studio oder im Application Insights-Webportal anzeigen.You can see your telemetry either in Visual Studio or in the Application Insights web portal. Suchen Sie nach Telemetriedaten in Visual Studio, und nutzen Sie sie beim Debuggen Ihrer App.Search telemetry in Visual Studio to help you debug your app. Überwachen Sie Leistung und Verwendung im Web-Portal, wenn Ihr System aktiv ist.Monitor performance and usage in the web portal when your system is live.

Anzeigen Ihrer Telemetriedaten in Visual StudioSee your telemetry in Visual Studio

Gehen Sie wie folgt vor, um in Visual Studio Application Insights-Daten anzuzeigen.In Visual Studio, to view Application Insights data. Wählen Sie Projektmappen-Explorer > Verbundene Dienste, klicken Sie mit der rechten Maustaste auf Application Insights, und klicken Sie anschließend auf Nach Livetelemetriedaten suchen.Select Solution Explorer > Connected Services > right-click Application Insights, and then click Search Live Telemetry.

Im Application Insights-Suchfenster in Visual Studio werden die Telemetriedaten Ihrer Anwendung angezeigt, die auf der Serverseite Ihrer App generiert werden.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. Experimentieren Sie mit den Filtern, und klicken Sie auf ein beliebiges Ereignis, um weitere Details anzuzeigen.Experiment with the filters, and click any event to see more detail.

Screenshot der Ansicht mit den Daten aus der Debugsitzung im Application Insights-Fenster

Tipp

Gehen Sie wie folgt vor, wenn keine Daten angezeigt werden: Stellen Sie sicher, dass der richtige Zeitbereich festgelegt ist, und klicken Sie auf das Suchsymbol.If you don't see any data, make sure the time range is correct, and click the Search icon.

Erfahren Sie mehr zu Application Insights-Tools in Visual Studio.Learn more about Application Insights tools in Visual Studio.

Anzeigen von Telemetriedaten im WebportalSee telemetry in web portal

Sie können Telemetriedaten auch im Application Insights-Webportal anzeigen (sofern Sie nicht nur das SDK installiert haben).You can also see telemetry in the Application Insights web portal (unless you chose to install only the SDK). Im Portal stehen mehr Diagramme, Analysetools und komponentenübergreifende Ansichten zur Verfügung als in Visual Studio.The portal has more charts, analytic tools, and cross-component views than Visual Studio. Außerdem stellt das Portal Warnungen bereit.The portal also provides alerts.

Öffnen Sie die Application Insights-Ressource.Open your Application Insights resource. Melden Sie sich entweder am Azure-Portal an, und greifen Sie darin auf die Daten zu, oder wählen Sie Projektmappen-Explorer > Verbundene Dienste, klicken Sie mit der rechten Maustaste auf Application Insights > Application Insights-Portal öffnen, um darauf zuzugreifen.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.

Das Portal wird mit einer Ansicht der Telemetriedaten Ihrer App geöffnet.The portal opens on a view of the telemetry from your app.

Screenshot der Application Insights-Übersichtsseite

Klicken Sie im Portal auf eine beliebige Kachel oder auf ein beliebiges Diagramm, um weitere Details anzuzeigen.In the portal, click any tile or chart to see more detail.

Schritt 4: Veröffentlichen der AppStep 4: Publish your app

Veröffentlichen Sie Ihre App auf Ihrem IIS-Server oder in Azure.Publish your app to your IIS server or to Azure. Sehen Sie sich Live Metrics Stream an, um sicherzustellen, dass alles reibungslos funktioniert.Watch Live Metrics Stream to make sure everything is running smoothly.

Sie können dann verfolgen, wie Ihre Telemetriedaten im Application Insights-Portal erstellt werden. Darin können Sie Metriken überwachen und die Telemetriedaten durchsuchen.Your telemetry builds up in the Application Insights portal, where you can monitor metrics, search your telemetry. Außerdem können Sie die leistungsfähige Abfragesprache Kusto verwenden, um die Nutzung und Leistung zu analysieren oder nach bestimmten Ereignissen zu suchen.You can also use the powerful Kusto query language to analyze usage and performance, or to find specific events.

Sie können Ihre Telemetriedaten auch in Visual Studio mit Tools wie der Diagnosesuche und Trends weiter analysieren.You can also continue to analyze your telemetry in Visual Studio, with tools such as diagnostic search and trends.

Hinweis

Wenn Ihre App so viele Telemetriedaten sendet, dass die Einschränkungsgrenzwerte bald erreicht werden, wird das automatische Sampling aktiviert.If your app sends enough telemetry to approach the throttling limits, automatic sampling switches on. Mit dem Sampling wird die Menge der von der App gesendeten Telemetriedaten reduziert, während gleichzeitig korrelierte Daten für Diagnosezwecke beibehalten werden.Sampling reduces the quantity of telemetry sent from your app, while preserving correlated data for diagnostic purposes.

FertigYou're all set

Glückwunsch!Congratulations! Sie haben in Ihrer App das Application Insights-Paket installiert und so konfiguriert, dass Telemetriedaten an den Application Insights-Dienst in Azure gesendet werden.You installed the Application Insights package in your app, and configured it to send telemetry to the Application Insights service on Azure.

Die Azure-Ressource, die die Telemetriedaten Ihrer App erhält, wird durch einen Instrumentierungsschlüssel angegeben.The Azure resource that receives your app's telemetry is identified by an instrumentation key. Diesen Schlüssel finden Sie in der Datei „ApplicationInsights.config“.You'll find this key in the ApplicationInsights.config file.

Durchführen eines Upgrades auf zukünftige SDK-VersionenUpgrade to future SDK versions

Zur Durchführung eines Upgrades auf eine neue Version des SDK öffnen Sie den NuGet-Paket-Manager, und filtern Sie die Ansicht nach installierten Paketen.To upgrade to a new release of the SDK, open the NuGet package manager, and filter on installed packages. Wählen Sie Microsoft.ApplicationInsights.Web und dann Upgrade aus.Select Microsoft.ApplicationInsights.Web, and choose Upgrade.

Wenn Sie Anpassungen an „ApplicationInsights.config“ vorgenommen haben, sollten Sie diese vor dem Upgrade speichern.If you made any customizations to ApplicationInsights.config, save a copy of it before you upgrade. Übernehmen Sie Ihre Änderungen anschließend für die neue Version.Then, merge your changes into the new version.

Nächste SchritteNext steps

Es gibt noch weitere Themen, die für Sie unter Umständen von Interesse sind:There are alternative topics to look at if you are interested in:

Mehr TelemetrieMore telemetry

AnalyseAnalysis

AlertsAlerts

  • Verfügbarkeitstests: Erstellen Sie Tests, um sicherzustellen, dass Ihre Website im Web sichtbar ist.Availability tests: Create tests to make sure your site is visible on the web.
  • Intelligente Diagnose: Diese Tests werden automatisch ausgeführt, sodass Sie keinerlei Einrichtungsschritte ausführen müssen.Smart diagnostics: These tests run automatically, so you don't have to do anything to set them up. Sie werden darüber benachrichtigt, ob für Ihre App eine ungewöhnlich hohe Zahl von Anforderungen mit Fehlern vorliegt.They tell you if your app has an unusual rate of failed requests.
  • Metrikwarnungen: Richten Sie Warnungen ein, damit Sie gewarnt werden, wenn für eine Metrik ein Schwellenwert überschritten wird.Metric alerts: Set alerts to warn you if a metric crosses a threshold. Sie können diese für benutzerdefinierte Metriken festlegen, die Sie in Ihrer App codieren.You can set them on custom metrics that you code into your app.

AutomationAutomation