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

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

• Azure-Abonnement: kostenloses Azure-Abonnement erstellen
• Application Insights-Ressource: Application Insights-Ressource erstellen

ASP.NET Core

• ASP.NET Core-Anwendung mit einer offiziell unterstützten Version von .NET

Tipp

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

.NET

• Anwendung mit einer unterstützten Version von .NET oder .NET Framework 4.6.2 und höher.

Tipp

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

Java

• Eine Java-Anwendung mit Java 8 oder höher

Java Native

• Eine Java-Anwendung mit GraalVM 17 oder höher

Node.js

• Anwendung mit einer offiziell unterstützten Version der Node.js-Runtime.
  • Von OpenTelemetry unterstützte Runtimes
  • Von Azure Monitor OpenTelemetry-Exporter unterstützte Runtimes

Hinweis

Wenn Sie keine Eigenschaften aus der Tabelle nicht unterstützter Eigenschaften verwenden, ist der ApplicationInsights-Shim der einfachste Weg nach der Betaversion.

Wenn Sie eine dieser Eigenschaften nutzen, fahren Sie mit der OpenTelemetry-Distribution von Azure Monitor fort. Wir werden in Kürze einen Migrationsleitfaden bereitstellen.

Tipp

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

Python

• Python-Anwendung mit Python 3.8+

Tipp

Wenn Sie von OpenCensus migrieren, lesen Sie unsere Migrationsdokumentation.

Installieren der Clientbibliothek

ASP.NET Core

Installieren Sie das aktuelle Azure.Monitor.OpenTelemetry.AspNetCore NuGet-Paket:

dotnet add package Azure.Monitor.OpenTelemetry.AspNetCore 

.NET

Installieren Sie das aktuelle Azure.Monitor.OpenTelemetry.Exporter NuGet-Paket:

dotnet add package Azure.Monitor.OpenTelemetry.Exporter 

Java

Laden Sie die Datei applicationinsights-agent-3.6.0.jar herunter.

Warnung

Wenn Sie ein Upgrade von einer früheren 3.x-Version durchführen, können sich Änderungen der Standardwerte oder geringfügige Unterschiede bei den von uns erfassten Daten auswirken. Weitere Informationen finden Sie in den Versionshinweisen im Abschnitt zur Migration. 3.5.0, 3.4.0, 3.3.0, 3.2.0 und 3.1.0

Java Native

Für native Spring Boot-Anwendungen:

• Importieren Sie die OpenTelemetry-Stückliste (BOM, Bills of Materials).
• Fügen Sie die Abhängigkeit Spring Cloud Azure Starter Monitor hinzu.
• Folgen Sie diesen Anweisungen für die Azure SDK JAR-Dateien (Java Archive).

Für native Quarkus-Anwendungen:

• Fügen Sie die Abhängigkeit Quarkus OpenTelemetry Exporter für Azure hinzu.

Node.js

Installieren Sie das neueste Paket für @azure/monitor-opentelemetry:

npm install @azure/monitor-opentelemetry

Die folgenden Pakete werden auch für einige spezifische Szenarien verwendet, die weiter unten in diesem Artikel beschrieben werden.

• @opentelemetry/api
• @opentelemetry/sdk-metrics
• @opentelemetry/resources
• @opentelemetry/semantic-conventions
• @opentelemetry/sdk-trace-base

npm install @opentelemetry/api
npm install @opentelemetry/sdk-metrics
npm install @opentelemetry/resources
npm install @opentelemetry/semantic-conventions
npm install @opentelemetry/sdk-trace-base

Python

Installieren Sie das neueste PyPI-Paket azure-monitor-opentelemetry:

pip install azure-monitor-opentelemetry

Ändern Ihrer Anwendung

ASP.NET Core

Importieren Sie den Namespace Azure.Monitor.OpenTelemetry.AspNetCore, fügen Sie OpenTelemetry hinzu, und konfigurieren Sie die Anwendung für die Verwendung von Azure Monitor in Ihrer program.cs-Klasse:

// Import the Azure.Monitor.OpenTelemetry.AspNetCore namespace.
using Azure.Monitor.OpenTelemetry.AspNetCore;

var builder = WebApplication.CreateBuilder(args);

// Add OpenTelemetry and configure it to use Azure Monitor.
builder.Services.AddOpenTelemetry().UseAzureMonitor();

var app = builder.Build();

app.Run();

.NET

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

// 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.

Java

Die automatische Instrumentierung wird durch Konfigurationsänderungen ermöglicht. Es sind keine Codeänderungen erforderlich.

Verweisen Sie die Java-VM (JVM) auf die .jar-Datei, indem Sie -javaagent:"path/to/applicationinsights-agent-3.6.0.jar" zu den JVM-Argumenten Ihrer Anwendung hinzufügen.

Hinweis

Das Sampling ist standardmäßig mit einer Rate von 5 Anforderungen pro Sekunde aktiviert, was die Kostenverwaltung unterstützt. Telemetriedaten können in Szenarien fehlen, die diese Rate überschreiten. Weitere Informationen zum Ändern der Samplingkonfiguration finden Sie unter Sampling-Außerkraftsetzungen.

Tipp

Eine ausführliche Anleitung für bestimmte Szenarien finden Sie unter Erste Schritte (ergänzend).

Tipp

Wenn Sie eine Spring Boot-Anwendung entwickeln, können Sie das JVM-Argument optional durch eine programmgesteuerte Konfiguration ersetzen. Weitere Informationen finden Sie unter Verwenden von Azure Monitor Application Insights mit Spring Boot.

Java Native

Die automatische Instrumentierung wird durch Konfigurationsänderungen ermöglicht. Es sind keine Codeänderungen erforderlich.

Node.js

// Import the `useAzureMonitor()` function from the `@azure/monitor-opentelemetry` package.
const { useAzureMonitor } = require("@azure/monitor-opentelemetry");

// Call the `useAzureMonitor()` function to configure OpenTelemetry to use Azure Monitor.
useAzureMonitor();

Python

# Import the `configure_azure_monitor()` function from the
# `azure.monitor.opentelemetry` package.
from azure.monitor.opentelemetry import configure_azure_monitor

# Import the tracing api from the `opentelemetry` package.
from opentelemetry import trace

# Configure OpenTelemetry to use Azure Monitor with the 
# APPLICATIONINSIGHTS_CONNECTION_STRING environment variable.
configure_azure_monitor()

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.

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.

  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.6.0.jar mit folgendem Inhalt ab:

  {
    "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.

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:

• ASP.NET Core-Beispiel-App
• NET-Beispielanwendung
• Java-Beispielanwendungen
• Native Java GraalVM-Beispiel-Apps
• Node.js-Beispielanwendung
• Python-Beispielanwendungen

Nächste Schritte

ASP.NET Core

• Details zum Hinzufügen und Ändern von Azure Monitor OpenTelemetry finden Sie unter Hinzufügen und Ändern von Azure Monitor OpenTelemetry.
• Informationen zum weiteren Konfigurieren der OpenTelemetry-Distribution finden Sie unter Konfiguration von Azure Monitor OpenTelemetry.
• Informationen zum Überprüfen des Quellcodes finden Sie im GitHub-Repository zu Azure Monitor AspNetCore.
• Um das NuGet-Paket zu installieren, nach Updates zu suchen oder Versionshinweise anzuzeigen, besuchen Sie die Seite mit dem NuGet-Paket zu Azure Monitor AspNetCore.
• Weitere Informationen zu Azure Monitor und OpenTelemetry finden Sie im Azure Monitor-Beispielanwendung.
• Weitere Informationen zu OpenTelemetry und seiner Community finden Sie im OpenTelemetry ,NET GitHub-Repository.
• Um Nutzungserfahrungen zu aktivieren, aktivieren Sie die Web- oder Browserbenutzerüberwachung.
• Informationen zu häufig gestellten Fragen, Problembehandlungsschritten, Supportoptionen oder zum Bereitstellen von OpenTelemetry-Feedback finden Sie unter OpenTelemetry-Hilfe, -Support und -Feedback für Azure Monitor Application Insights.

.NET

• Details zum Hinzufügen und Ändern von Azure Monitor OpenTelemetry finden Sie unter Hinzufügen und Ändern von Azure Monitor OpenTelemetry.
• Informationen zum weiteren Konfigurieren der OpenTelemetry-Distribution finden Sie unter Konfiguration von Azure Monitor OpenTelemetry.
• Informationen zum Überprüfen des Quellcodes finden Sie im GitHub-Repository „Azure Monitor Exporter“.
• Um das NuGet-Paket zu installieren, nach Updates zu suchen oder Versionshinweise anzuzeigen, besuchen Sie die Seite NuGet-Paket „Azure Monitor Exporter“.
• Weitere Informationen zu Azure Monitor und OpenTelemetry finden Sie im Azure Monitor-Beispielanwendung.
• Weitere Informationen zu OpenTelemetry und seiner Community finden Sie im OpenTelemetry ,NET GitHub-Repository.
• Um Nutzungserfahrungen zu aktivieren, aktivieren Sie die Web- oder Browserbenutzerüberwachung.
• Informationen zu häufig gestellten Fragen, Problembehandlungsschritten, Supportoptionen oder zum Bereitstellen von OpenTelemetry-Feedback finden Sie unter OpenTelemetry-Hilfe, -Support und -Feedback für Azure Monitor Application Insights.

Java

• Details zum Hinzufügen und Ändern von Azure Monitor OpenTelemetry finden Sie unter Hinzufügen und Ändern von Azure Monitor OpenTelemetry.
• Überprüfen Sie die Konfigurationsoptionen für die automatische Java-Instrumentierung.
• Sehen Sie sich den Quellcode im GitHub-Repository für automatische Java-Instrumentierung in Azure Monitor an.
• Weitere Informationen zu OpenTelemetry und seiner Community finden Sie im OpenTelemetry Java GitHub-Repository.
• Aktivieren Sie Nutzungserfahrungen unter Aktivieren der Web- oder Browserbenutzerüberwachung.
• Weitere Informationen finden Sie in den Versionshinweisen auf GitHub.
• Informationen zu häufig gestellten Fragen, Problembehandlungsschritten, Supportoptionen oder zum Bereitstellen von OpenTelemetry-Feedback finden Sie unter OpenTelemetry-Hilfe, -Support und -Feedback für Azure Monitor Application Insights.

Java Native

• Details zum Hinzufügen und Ändern von Azure Monitor OpenTelemetry finden Sie unter Hinzufügen und Ändern von Azure Monitor OpenTelemetry.
• Überprüfen Sie den Quellcode in der Azure Monitor OpenTelemetry Distribution in nativen Spring Boot Image Java-Anwendung und Quarkus OpenTelemetry Exporter für Azure.
• Weitere Informationen zu OpenTelemetry und seiner Community finden Sie im OpenTelemetry Java GitHub-Repository.
• Erfahren Sie mehr über die Funktionen für native Spring Boot Image-Anwendungen in OpenTelemetry SpringBoot Starter
• Erfahren Sie mehr über die Funktionen für native Anwendungen von Quarkus in Quarkus OpenTelemetry Exporter für Azure.
• Weitere Informationen finden Sie in den Versionshinweisen auf GitHub.
• Informationen zu häufig gestellten Fragen, Problembehandlungsschritten, Supportoptionen oder zum Bereitstellen von OpenTelemetry-Feedback finden Sie unter OpenTelemetry-Hilfe, -Support und -Feedback für Azure Monitor Application Insights.

Node.js

• Details zum Hinzufügen und Ändern von Azure Monitor OpenTelemetry finden Sie unter Hinzufügen und Ändern von Azure Monitor OpenTelemetry.
• Informationen zum Überprüfen des Quellcodes finden Sie im GitHub-Repository zu Azure Monitor OpenTelemetry.
• Informationen zum Installieren des npm-Pakets und zur Suche nach Updates finden Sie auf der Seite @azure/monitor-opentelemetryNPM-Pakets.
• Weitere Informationen zu Azure Monitor Application Insights und OpenTelemetry finden Sie im Azure Monitor-Beispielanwendung.
• Weitere Informationen zu OpenTelemetry und seiner Community finden Sie im OpenTelemetry JavaScript GitHub-Repository.
• Um Nutzungserfahrungen zu aktivieren, aktivieren Sie die Web- oder Browserbenutzerüberwachung.
• Informationen zu häufig gestellten Fragen, Problembehandlungsschritten, Supportoptionen oder zum Bereitstellen von OpenTelemetry-Feedback finden Sie unter OpenTelemetry-Hilfe, -Support und -Feedback für Azure Monitor Application Insights.

Python

• Details zum Hinzufügen und Ändern von Azure Monitor OpenTelemetry finden Sie unter Hinzufügen und Ändern von Azure Monitor OpenTelemetry.
• Sehen Sie sich den Quellcode und die zusätzliche Dokumentation im GitHub-Repository für die Azure Monitor-Distribution.
• Zusätzliche Beispiele und Anwendungsfälle finden Sie unter Azure Monitor-Distributionsbeispiele.
• Sehen Sie sich das Änderungsprotokoll auf GitHub an.
• Installieren Sie das PyPI-Paket, suchen Sie nach Updates oder Sehen Sie sich auf der Seite PyPI-Paket für Azure Monitor-Distribution die Versionshinweise an.
• Weitere Informationen zu Azure Monitor Application Insights und OpenTelemetry finden Sie in der Azure Monitor-Beispielanwendung.
• Weitere Informationen zu OpenTelemetry und seiner Community finden Sie im OpenTelemetry Python GitHub-Repository.
• Die verfügbaren OpenTelemetry-Instrumentierungen und -Komponenten finden Sie im Python GitHub-Repository für OpenTelemetry-Beiträge.
• Um Nutzungserfahrungen zu aktivieren, aktivieren Sie die Web- oder Browserbenutzerüberwachung.
• Informationen zu häufig gestellten Fragen, Problembehandlungsschritten, Supportoptionen oder zum Bereitstellen von OpenTelemetry-Feedback finden Sie unter OpenTelemetry-Hilfe, -Support und -Feedback für Azure Monitor Application Insights.