Auf Englisch lesen

Freigeben über

Aktivieren von Azure Monitor OpenTelemetry für .NET-, Node.js-, Python und Java-Anwendungen

  • Artikel

In diesem Artikel wird beschrieben, wie Sie die auf OpenTelemetry basierende Datensammlung in Application Insights aktivieren und konfigurieren. OpenTelemetry-Distribution für Azure Monitor

  • Bietet eine OpenTelemetry-Distribution, die Unterstützung für Azure Monitor-spezifische Funktionen enthält.
  • Ermöglicht automatische Telemetrie, indem OpenTelemetry-Instrumentierungsbibliotheken zum Sammeln von Ablaufverfolgungen, Metriken, Protokollen und Ausnahmen eingeschlossen werden.
  • Ermöglicht das Sammeln benutzerdefinierter Telemetrie.
  • Unterstützt Livemetriken, um weitere Telemetriedaten von Livewebanwendungen in der Produktion zu überwachen und zu sammeln.

Weitere Informationen zu den Vorteilen der Verwendung der Azure Monitor OpenTelemetry-Distribution finden Sie unter Warum sollte ich die OpenTelemetry-Distribution von Azure Monitor verwenden?.

Weitere Informationen zum Sammeln von Daten mit OpenTelemetry finden Sie unter Grundlagen der Datensammlung oder in den häufig gestellten Fragen zu OpenTelemetry.

OpenTelemetry-Releasestatus

OpenTelemetry-Angebote sind für .NET-, Node.js-, Python- und Java-Anwendungen verfügbar. Einen Releasestatus für die einzelnen Features finden Sie in den häufig gestellten Fragen.

Aktivieren von OpenTelemetry mit Application Insights

Führen Sie die Schritte in diesem Abschnitt aus, um Ihre Anwendung mit OpenTelemetry zu instrumentieren. Wählen Sie eine Registerkarte für sprachspezifische Anweisungen aus.

Hinweis

.NET deckt mehrere Szenarien ab, einschließlich klassischer ASP.NET, Konsolen-Apps, Windows Forms (WinForms) und vieles mehr.

Voraussetzungen

Tipp

Wenn Sie aus der Application Insights Classic API migrieren, lesen Sie unsere Migrationsdokumentation.

Installieren der Clientbibliothek

Installieren Sie das aktuelle Azure.Monitor.OpenTelemetry.ExporterNuGet-Paket:

.NET CLI 
dotnet add package Azure.Monitor.OpenTelemetry.Exporter

Ändern Ihrer Anwendung

Fügen Sie jedem OpenTelemetry-Signal den Azure Monitor-Exporter in der program.cs-Klasse hinzu:

C# 
// Create a new tracer provider builder and add an Azure Monitor trace exporter to the tracer provider builder.
// It is important to keep the TracerProvider instance active throughout the process lifetime.
// See https://github.com/open-telemetry/opentelemetry-dotnet/tree/main/docs/trace#tracerprovider-management
var tracerProvider = Sdk.CreateTracerProviderBuilder()
    .AddAzureMonitorTraceExporter();

// Add an Azure Monitor metric exporter to the metrics provider builder.
// It is important to keep the MetricsProvider instance active throughout the process lifetime.
// See https://github.com/open-telemetry/opentelemetry-dotnet/tree/main/docs/metrics#meterprovider-management
var metricsProvider = Sdk.CreateMeterProviderBuilder()
    .AddAzureMonitorMetricExporter();

// Create a new logger factory.
// It is important to keep the LoggerFactory instance active throughout the process lifetime.
// See https://github.com/open-telemetry/opentelemetry-dotnet/tree/main/docs/logs#logger-management
var loggerFactory = LoggerFactory.Create(builder =>
{
    builder.AddOpenTelemetry(logging =>
    {
        logging.AddAzureMonitorLogExporter();
    });
});

Hinweis

Weitere Informationen dazu finden Sie im Erste Schritte-Tutorial für OpenTelemetry .NET.

Kopieren der Verbindungszeichenfolge aus Ihrer Application Insights-Ressource

Die Verbindungszeichenfolge ist eindeutig und gibt an, wohin die Azure Monitor OpenTelemetry-Distribution die erfassten Telemetriedaten sendet.

Tipp

Wenn Sie noch nicht über eine Application Insights-Ressource verfügen, erstellen Sie eine anhand dieser Anleitung. Es wird empfohlen, eine neue Ressource zu erstellen, anstatt eine vorhandene zu verwenden.

So kopieren Sie die Verbindungszeichenfolge

  1. Wechseln Sie zum Bereich Übersicht Ihrer Application Insights-Ressource.
  2. Suchen Sie die Verbindungszeichenfolge.
  3. Zeigen Sie mit der Maus auf die Verbindungszeichenfolge, und wählen Sie das Symbol In Zwischenablage kopieren aus.

Screenshot, der die Application Insights-Übersicht und die Verbindungszeichenfolge zeigt.

Einfügen der Verbindungszeichenfolge in Ihre Umgebung

Zum Einfügen der Verbindungszeichenfolge wählen Sie eine der folgenden Optionen aus:

Wichtig

Es wird empfohlen, die Verbindungszeichenfolge nur in lokalen Entwicklungs- und Testumgebungen über Code festzulegen.

Verwenden Sie für die Produktion eine Umgebungsvariable oder Konfigurationsdatei (nur Java).

  • Festlegen über die Umgebungsvariable - empfohlen

    Ersetzen Sie <Your connection string> im folgenden Befehl durch Ihre Verbindungszeichenfolge.

    Konsole 
    APPLICATIONINSIGHTS_CONNECTION_STRING=<Your connection string>

  • Festlegen über eine Konfigurationsdatei - nur Java

    Erstellen Sie eine Konfigurationsdatei mit dem Namen applicationinsights.json, und legen Sie sie im gleichen Verzeichnis wie applicationinsights-agent-3.7.0.jar mit folgendem Inhalt ab:

    JSON 
    {
  "connectionString": "<Your connection string>"
}

    Ersetzen Sie <Your connection string> im vorherigen JSON-Code durch Ihre eindeutige Verbindungszeichenfolge.

  • Festlegen über Code - nur ASP.NET Core, Node.js und Python

    Ein Beispiel zum Festlegen der Verbindungszeichenfolge über Code finden Sie unter Konfiguration der Verbindungszeichenfolge.

Hinweis

Wenn Sie die Verbindungszeichenfolge an mehreren Stellen festlegen, wird die Umgebungsvariable in der folgenden Reihenfolge priorisiert:

  1. Code
  2. Umgebungsvariable
  3. Konfigurationsdatei

Bestätigen des Datenflusses

Führen Sie Ihre Anwendung aus, und öffnen Sie dann Application Insights-Ressource im Azure-Portal. Es kann einige Minuten dauern, bis Daten angezeigt werden.

Screenshot der Registerkarte „Übersicht“ von Application Insights mit hervorgehobenen Serveranforderungen und der Serverantwortzeit.

Application Insights ist jetzt für Ihre Anwendung aktiviert. Die folgenden Schritte sind optional und ermöglichen weitere Anpassungen.

Wichtig

Wenn Sie über zwei oder mehr Dienste verfügen, die Telemetriedaten an dieselbe Application Insights-Ressource ausgeben, müssen Sie Cloudrollennamen festlegen, um sie ordnungsgemäß in der Anwendungsübersicht darzustellen.

Im Rahmen der Verwendung der Application Insights-Instrumentierung sammeln und senden wir Diagnosedaten an Microsoft. Diese Daten helfen uns, Application Insights auszuführen und zu verbessern. Weitere Informationen finden Sie unter Statsbeat in Azure Application Insights.

Beispielanwendungen

Azure Monitor OpenTelemetry-Beispielanwendungen sind für alle unterstützten Sprachen verfügbar:

Nächste Schritte