Freigeben über


Hinzufügen von Azure Application Insights mithilfe von Visual Studio Connected Services

Mit Visual Studio können Sie eine der folgenden Verbindungen mit Azure Application Insights herstellen, indem Sie das Feature Connected Services verwenden:

  • .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
  • Universelle Windows-Plattform-App
  • Xamarin
  • Cordova

Die funktion des verbundenen Diensts fügt dem Projekt alle erforderlichen Verweise und Verbindungscode hinzu und ändert die Konfigurationsdateien entsprechend.

Voraussetzungen

Verbindung mit Azure Application Insights über Connected Services herstellen

  1. Öffnen Sie Ihr Projekt in Visual Studio.

  2. Klicken Sie im Projektmappen-Explorermit der rechten Maustaste auf den Knoten Verbundene Dienste, und wählen Sie im Kontextmenü Verbundener Dienst hinzufügenaus.

  3. Wählen Sie auf der Registerkarte Verbundene Dienste das Symbol +für Dienstabhängigkeitenaus.

    Screenshot mit dem Bildschirm „Dienstabhängigkeit hinzufügen“

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

  4. Wählen Sie auf der Seite Abhängigkeit hinzufügen die Option Azure Application Insights aus.

    Screenshot mit dem Bildschirm

    Wenn Sie noch nicht angemeldet sind, melden Sie sich bei Ihrem Azure-Konto an. Wenn Sie nicht über ein Azure-Konto verfügen, können Sie sich für eine kostenlose Testversionregistrieren.

  5. 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. Fahren Sie andernfalls mit Schritt 7 fort.

    Screenshot: Bildschirm „Verbindung mit einer vorhandenen Application Insights-Komponente herstellen“

  6. So erstellen Sie eine Application Insights-Komponente:

    1. Wählen Sie Erstellen einer neuen Application Insights-Komponente unten auf dem Bildschirm aus.

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

      Screenshot des Bildschirms

    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 aus, und wählen Sie Nextaus.

  7. Geben Sie einen Namen eines Instrumentierungsschlüssels ein, oder wählen Sie die Standardeinstellung aus, und wählen Sie aus, ob die Verbindungszeichenfolge in einer lokalen geheimen Datei oder in Azure Key Vault-gespeichert werden soll.

    Screenshot, der den Bildschirm

  8. Die Zusammenfassung der Änderungen Bildschirm zeigt alle Änderungen an, die an Ihrem Projekt vorgenommen werden, wenn Sie den Vorgang abgeschlossen haben. Wenn die Änderungen korrekt sind, wählen Sie Fertig stellen aus.

    Screenshot des Bildschirms 'Zusammenfassung der Änderungen'.

  9. Die Verbindung wird unter dem Abschnitt Dienstabhängigkeiten der Registerkarte Verbundene Dienste angezeigt.

    Screenshot des Bildschirms

Herstellen einer Verbindung mit Azure Application Insights über verbundene Dienste

Anmerkung

Bei .NET Framework-Projekten unterscheidet sich die Benutzeroberfläche für verbundene Dienste geringfügig. Um die Unterschiede anzuzeigen, vergleichen Sie mit der Visual Studio 2019-Version dieser Seite.

  1. Öffnen Sie Ihr Projekt in Visual Studio.

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

    Screenshot mit den Optionen des Kontextmenüs für verbundene Dienste.

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

  3. Wählen Sie Azure Application Insightsaus. 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 die Verbindung mit dem Live-Azure Application Insights-Dienst. Sie können Kosten reduzieren 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.

    Screenshot mit den Auswahlmöglichkeiten von Application Insights.

    Wenn Sie das Application Insights SDK lokal verwenden möchten, klicken Sie auf Weiter, um die Zusammenfassung der Änderungen Bildschirm anzuzeigen, die zeigt, wie Ihr Projekt geändert wird. Ihrem Projekt wird ein NuGet-Paketverweis hinzugefügt, und dem Projekt wird 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 wenn Sie noch nicht angemeldet sind, melden Sie sich bei Ihrem Azure-Konto an, bevor Sie fortfahren. 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. Fahren Sie andernfalls mit Schritt 7 fort.

    Screenshot: Bildschirm „Verbindung mit einer vorhandenen Application Insights-Komponente herstellen“

  5. So erstellen Sie eine Application Insights-Komponente:

    1. Wählen Sie Erstellen einer neuen Application Insights-Komponente unten auf dem Bildschirm aus.

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

      Screenshot des Bildschirms

    3. Wenn das Fenster Azure Application Insights konfigurieren angezeigt wird, erscheint die neue Komponente in der Liste. Wählen Sie die neue Komponente in der Liste aus, und wählen Sie Nextaus.

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

    Screenshot mit dem Bildschirm

    Anmerkung

    Um die Sicherheit zu verbessern, erstellt dieser Schritt in Visual Studio 17.12 und höher einen Verbindungseinstellungsnamen. In früheren Versionen wird eine 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.

    Screenshot mit

  8. Die Zusammenfassung der Änderungen Bildschirm zeigt alle Änderungen an, die an Ihrem Projekt vorgenommen werden, wenn Sie den Vorgang abgeschlossen haben. Wenn die Änderungen korrekt sind, wählen Sie Fertig stellen aus.

    Screenshot des Bildschirms

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

    Screenshot mit dem Abschnitt

    Wenn Sie neben der hinzugefügten Abhängigkeit auf die drei Punkte klicken, werden verschiedene Optionen wie Connect angezeigt, 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 anzuzeigen, um lokale Abhängigkeiten zu starten, Einstellungen zu ändern und vieles mehr.

  10. Öffnen Sie die Startcodedatei (Program.cs in Vorlagen), und beachten Sie, dass eine Zeile hinzugefügt wurde, die etwa wie folgt aussieht:

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

Nächste Schritte

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

Informationen zu ASP.NET Projekten finden Sie unter Konfigurieren Sie Application Insights für Ihre ASP.NET-Website.

Die Links führen Sie zum Abschnitt der Artikel nach den ersten Einrichtungsschritten, die Sie bereits abgeschlossen haben.