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

In diesem Artikel wird beschrieben, wie Sie die openTelemetry-basierte Datensammlung in Azure Monitor Application Insights aktivieren und konfigurieren. Die Azure Monitor OpenTelemetry-Distribution:

Stellt eine OpenTelemetry-Verteilung bereit, die Unterstützung für features enthält, die für Azure Monitor spezifisch sind.
Ermöglicht die automatische Telemetrie, indem OpenTelemetry-Instrumentierungsbibliotheken zur Sammlung von Traces, Metriken, Protokollen und Ausnahmen verwendet werden.
Ermöglicht das Sammeln benutzerdefinierter Telemetrie.
Unterstützt Live-Metriken zum Überwachen und Sammeln von Telemetrie aus Webanwendungen im Livebetrieb.

Weitere Informationen zu den Vorteilen der Verwendung der Azure Monitor OpenTelemetry Distro finden Sie unter Why should I use the Azure Monitor OpenTelemetry Distro.

Weitere Informationen zum Sammeln von Daten mithilfe von OpenTelemetry finden Sie unter Collect OpenTelemetry (OTel) für Application Insights-Erfahrungen oder die 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.

Hinweis

Informationen zu Azure Funktions-Apps finden Sie unter Use OpenTelemetry with Azure Functions.

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 umfasst mehrere Szenarien, darunter klassische ASP.NET, Konsolen-Apps, Windows Forms (WinForms) und vieles mehr.

Voraussetzungen

Azure Abonnement: Create an Azure subscription for free
Application Insights-Ressource: Application Insights-Ressource erstellen

ASP.NET Core Application mit einer offiziell unterstützten Version von .NET

Tipp

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

Installieren der Clientbibliothek

Installieren Sie das neueste Azure.Monitor.OpenTelemetry.AspNetCoreNuGet-Paket:

dotnet add package Azure.Monitor.OpenTelemetry.AspNetCore

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

dotnet add package Azure.Monitor.OpenTelemetry.Exporter

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

npm install @azure/monitor-opentelemetry

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

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

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

pip install azure-monitor-opentelemetry

Ändern Ihrer Anwendung

Importieren Sie den namespace Azure.Monitor.OpenTelemetry.AspNetCore, fügen Sie OpenTelemetry hinzu, und konfigurieren Sie ihn so, dass Azure Monitor in Ihrer program.cs-Klasse verwendet werden:

// 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();

Fügen Sie den Azure Monitor Exporter zu jedem OpenTelemetry-Signal in der klasse program.cs 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 finden Sie im Lernprogramm getting-started für OpenTelemetry .NET

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

Zeigen Sie den Java virtuellen Computer (JVM) auf die Jar-Datei, indem Sie -javaagent:"path/to/applicationinsights-agent-3.7.8.jar" zu den JVM-Argen Ihrer Anwendung hinzufügen.

Hinweis

Das Sampling ist standardmäßig mit einer Rate von fünf 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. Wenn unerwartete Gebühren oder hohe Kosten in Application Insights angezeigt werden, kann dieser Leitfaden hilfreich sein. Es deckt häufige Ursachen wie hohes Telemetrievolumen, Datenaufnahmespitzen und falsch konfiguriertes Sampling ab. Es ist besonders hilfreich, wenn Sie Probleme im Zusammenhang mit Kostenspitzen, Telemetrievolumen, nicht funktionierendem Sampling, Datenobergrenzen, hohem Dateninput oder unerwarteter Abrechnung beheben. Informationen zu den ersten Schritten finden Sie unter "Problembehandlung bei der Erfassung von hohen Daten in Application Insights".

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 Using Azure Monitor Application Insights with Spring Boot.

// 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();

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

# Configure OpenTelemetry to use Azure Monitor with the 
# APPLICATIONINSIGHTS_CONNECTION_STRING environment variable.
configure_azure_monitor(
    logger_name="<your_logger_namespace>",  # Set the namespace for the logger in which you would like to collect telemetry for if you are collecting logging telemetry. This is imperative so you do not collect logging telemetry from the SDK itself.
)
logger = logging.getLogger("<your_logger_namespace>")  # Logging telemetry will be collected from logging calls made with this logger and all of it's children loggers.

Kopiere die Verbindungszeichenfolge aus deiner Application Insights-Ressource

Die Verbindungszeichenfolge ist eindeutig und gibt an, wo die Azure Monitor OpenTelemetry Distro die von ihr erfasste Telemetrie 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:

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

Fügen Sie die Verbindungszeichenfolge in Ihre Umgebung ein

Um Ihre Verbindungszeichenfolge einzufügen, wählen Sie aus den 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 Verbindungszeichenfolge> im folgenden Befehl durch Ihren Verbindungszeichenfolge.
```
APPLICATIONINSIGHTS_CONNECTION_STRING=<Your connection string>
```
Set via Konfigurationsdatei - Nur Java

Erstellen Sie eine Konfigurationsdatei mit dem Namen applicationinsights.json, und legen Sie sie im gleichen Verzeichnis wie applicationinsights-agent-3.7.8.jar mit folgendem Inhalt ab:
```
{
  "connectionString": "<Your connection string>"
}
```
Ersetzen Sie <Your Verbindungszeichenfolge> im vorherigen JSON durch Ihre eindeutige Verbindungszeichenfolge.
Set via Code - Nur ASP.NET Core, Node.js und Python

Unter Verbindungszeichenfolge configuration finden Sie ein Beispiel für das Festlegen Verbindungszeichenfolge über Code.

Hinweis

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

Code
Umgebungsvariable
Konfigurationsdatei

Bestätigen des Datenflusses

Führen Sie Ihre Anwendung aus, und öffnen Sie dann Application Insights 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.

Hinweis

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 in den häufig gestellten Fragen zu Application Insights.

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.

Problembehandlung, Feedback und Support

Tipp

Die folgenden Abschnitte sind in allen OpenTelemetry Distro-Artikeln verfügbar.

Problembehandlung

Informationen zur Problembehandlung finden Sie unter OpenTelemetry-Probleme in .NET behandeln und fehlende Anwendungstelemetrie in Azure Monitor Application Insights behandeln.

OpenTelemetry-Feedback

So können Sie Feedback geben

Füllen Sie die Kundenfeedbackumfrage der OpenTelemetry-Community aus.
Teilen Sie Microsoft Informationen über sich, indem Sie der OpenTelemetry Early Adopter Community beitreten.
Interagieren Sie mit anderen Azure Monitor Benutzern in der tech Community Microsoft.
Stellen Sie eine Featureanfrage im Azure Feedbackforum.

Support

Wählen Sie eine Registerkarte für die Sprache Ihrer Wahl aus, um Supportoptionen zu ermitteln.

Öffnen Sie für Azure-Support Probleme ein Azure-Support Ticket.
Wenden Sie sich bei OpenTelemetry-Problemen direkt an die OpenTelemetry-.NET Community.
Eine Liste der offenen Probleme im Zusammenhang mit Azure Monitor Exporter finden Sie auf der Seite GitHub Probleme.

Nächste Schritte

Informationen zum Überprüfen des Quellcodes finden Sie im Repository Azure Monitor ASP.NET Core GitHub.
Informationen zum Überprüfen einer Beispielanwendung finden Sie unter Azure Monitor OpenTelemetry für ASP.NET Core.
Für Informationen zum Installieren des NuGet-Pakets, Prüfen auf Updates oder Einsehen von Release-Notes besuchen Sie die Seite Azure Monitor AspNetCore NuGet Package.
Weitere Informationen zu OpenTelemetry und deren Community finden Sie im OpenTelemetry .NET GitHub Repository.
Um Nutzungserfahrungen zu aktivieren, aktivieren Sie die Web- oder Browserbenutzerüberwachung.

Informationen zum Überprüfen des Quellcodes finden Sie im Azure Monitor OpenTelemetry for JavaScript-Repository.
Informationen zum Überprüfen einer Beispielanwendung finden Sie unter Azure Monitor OpenTelemetry für Node.js.
Informationen zum Installieren des npm-Pakets und zur Suche nach Updates finden Sie auf der Seite @azure/monitor-opentelemetryNPM-Pakets.
Weitere Informationen zu OpenTelemetry und deren Community finden Sie im OpenTelemetry JavaScript GitHub Repository.
Um Nutzungserfahrungen zu aktivieren, aktivieren Sie die Web- oder Browserbenutzerüberwachung.

Feedback

War diese Seite hilfreich?

Last updated on 2026-04-17

Freigeben über

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

OpenTelemetry-Releasestatus

Aktivieren von OpenTelemetry mit Application Insights

Voraussetzungen

Installieren der Clientbibliothek

Ändern Ihrer Anwendung

Kopiere die Verbindungszeichenfolge aus deiner Application Insights-Ressource

Fügen Sie die Verbindungszeichenfolge in Ihre Umgebung ein

Bestätigen des Datenflusses

Problembehandlung, Feedback und Support

Problembehandlung

OpenTelemetry-Feedback

Support

Nächste Schritte

Feedback

Zusätzliche Ressourcen