Hinzufügen von Azure Application Insights mithilfe des Visual Studio-Features „Verbundene Dienste“

Mit Visual Studio können Sie über das Feature Verbundene Dienste eine Verbindung zwischen Azure Application Insights und jedem der folgenden Elemente herstellen:

• .NET Framework-Konsolen-App
• ASP.NET Model-View-Controller (MVC) (.NET Framework)
• ASP.NET Core
• .NET Core (einschließlich Konsolen-App, WPF, Windows Forms, Klassenbibliothek)
• .NET Core-Workerrolle
• Azure-Funktionen
• App für Universelle Windows-Plattform
• Xamarin
• Cordova

Mit der Funktion für verbundene Dienste werden die benötigten Verweise und der Verbindungscode zu Ihrem Projekt hinzugefügt und Ihre Konfigurationsdateien entsprechend geändert.

Voraussetzungen

• Visual Studio mit installierter Azure-Workload
• Ein Projekt eines unterstützten Typs
• Ein Azure-Konto. Wenn Sie nicht über ein Azure-Konto verfügen, aktivieren Sie Ihre Azure-Nutzen für Visual Studio-Abonnenten oder registrieren Sie sich für eine kostenlose Testversion.

Herstellen einer Verbindung mit Azure Application Insights mithilfe des Features „Verbundene Dienste“

Hinweis

Bei .NET Framework-Projekten unterscheidet sich die Benutzeroberfläche von Verbundene Dienste geringfügig. Um die Unterschiede zu sehen, vergleichen Sie sie mit der Visual Studio 2019-Version dieser Seite.

1. Öffnen Sie Ihr Projekt in Visual Studio.

2. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Knoten Verbundene Dienste, und wählen Sie im Kontextmenü Hinzufügen aus, um das Menü verfügbarer Dienste zu öffnen.

   

   Wenn der Knoten Verbundene Dienste nicht angezeigt wird, wählen Sie Projekt>Verbundene Dienste>Hinzufügen aus.

3. Wählen Sie Azure Application Insights aus. Die Seite Mit Abhängigkeit verbinden wird angezeigt. Es sollten zwei Optionen angezeigt werden: eine für einen lokalen Emulator, Application Insights SDK (Lokal) und eine für das Herstellen einer Verbindung mit dem aktiven Azure-Application-Insights-Dienst. Sie können die Kosten senken und die frühe Entwicklung vereinfachen, indem Sie mit dem lokalen Emulator beginnen. Sie können später zum Livedienst migrieren, indem Sie diese Schritte wiederholen und die andere Option auswählen.

   

   Wenn Sie sich für die lokale Verwendung des Application Insights SDK entscheiden, klicken Sie auf Weiter, um den Bildschirm Zusammenfassung der Änderungen aufzurufen, der zeigt, wie Ihr Projekt geändert wird. Ihrem Projekt werden ein NuGet-Paketverweis und der Verbindungscode für den lokalen Emulator hinzugefügt.

   Wenn Sie eine Verbindung mit dem Azure-Dienst herstellen möchten, fahren Sie mit dem nächsten Schritt fort, oder melden Sie sich bei Ihrem Azure-Konto an, bevor Sie fortfahren, falls Sie noch nicht angemeldet sind. Wenn Sie nicht über ein Azure-Konto verfügen, können Sie sich für eine kostenlose Testversionregistrieren.

4. Wählen Sie auf dem Bildschirm Azure Application Insights konfigurieren eine vorhandene Azure Application Insights-Komponente und dann Weiter aus.

   Wenn Sie eine neue Komponente erstellen müssen, fahren Sie mit dem nächsten Schritt fort. Andernfalls fahren Sie mit Schritt 7 fort.

   

5. So erstellen Sie eine Application Insights-Komponente

   1. Wählen Sie unten auf dem Bildschirm Neue Application Insights-Komponente erstellen aus.

   2. Füllen Sie den Bildschirm Application Insights: Neu erstellen aus, und wählen Sie Erstellen aus.

      

   3. Wenn der Bildschirm Azure Application Insights konfigurieren angezeigt wird, befindet sich die neue Komponente in der Liste. Wählen Sie die neue Komponente in der Liste und dann Weiter aus.

6. Geben Sie einen Namen für die Verbindungseinstellung und den Namen eines Instrumentierungsschlüssels ein, oder akzeptieren Sie die Standardwerte.

   

   Hinweis

   Um die Sicherheit zu verbessern, erstellt dieser Schritt in Visual Studio 17.12 und höher einen Verbindungseinstellungsnamen. In früheren Versionen wird ein Verbindungszeichenfolge erstellt. Verbindungszeichenfolgen, die im lokalen Dateisystem gespeichert sind, können zu einem Sicherheitsrisiko führen, wenn sie versehentlich verfügbar gemacht werden.

7. Klicken Sie auf "Zusätzliche Einstellungen", und wählen Sie aus, ob die Verbindungszeichenfolge in einer lokalen geheimen Datei oder in Azure Key Vault gespeichert werden soll.

   

8. Auf dem Bildschirm Zusammenfassung der Änderungen werden alle Änderungen angezeigt, die an Ihrem Projekt vorgenommen werden, wenn Sie den Vorgang abschließen. Wenn die Änderungen korrekt sind, wählen Sie Fertig stellen aus.

   

9. Doppelklicken Sie im Projektmappen-Explorer auf den Knoten Verbundene Dienste, um die Registerkarte Verbundene Dienste zu öffnen. Die Verbindung wird im Abschnitt Dienstabhängigkeiten angezeigt:

   

   Wenn Sie auf die drei Punkte neben der von Ihnen hinzugefügten Abhängigkeit klicken, werden verschiedene Optionen angezeigt, z. B. Verbinden, um den Assistenten erneut zu öffnen und die Verbindung zu ändern. Sie können auch oben rechts im Fenster auf die drei Punkte klicken, um Optionen zum Starten lokaler Abhängigkeiten, Ändern von Einstellungen und mehr anzuzeigen.

10. Öffnen Sie Ihre Startcodedatei (Program.cs in den Vorlagen). Sie werden feststellen, dass eine Zeile hinzugefügt wurde, die der folgenden ähnelt:

    builder.Services.AddApplicationInsightsTelemetry(builder.Configuration["APPLICATIONINSIGHTS_CONNECTION_STRING"]);
    

Nächste Schritte

Für ASP.NET Core-Projekte erfahren Sie unter Application Insights für ASP.NET Core-Anwendungen, wie Sie die Überwachung für Ihre App aktivieren können.

ASP.NET-Projekte finden Sie unter Konfigurieren von Application Insights für Ihre ASP.NET-Website.

Die Links führen Sie zu dem Abschnitt der Artikel, der nach den ersten Einrichtungsschritten folgt, die Sie bereits durchgeführt haben.

Zugehöriger Inhalt

• Produktseite zu Azure Monitor
• Dokumentation zu Azure Application Insights