Azure Monitor OpenTelemetry inschakelen voor .NET-, Node.js-, Python- en Java-toepassingen

In dit artikel wordt beschreven hoe u gegevensverzameling op basis van OpenTelemetry inschakelt en configureert binnen Azure Monitor Application Insights. De Azure Monitor OpenTelemetry Distro:

Biedt een OpenTelemetry-distributie, waaronder ondersteuning voor functies die specifiek zijn voor Azure Monitor.
Hiermee schakelt u automatische telemetrietelemetrie in door openTelemetry-instrumentatiebibliotheken op te halen voor het verzamelen van traceringen, metrische gegevens, logboeken en uitzonderingen.
Hiermee kunt u aangepaste telemetriegegevens verzamelen.
Biedt ondersteuning voor Live Metrics voor het bewaken en verzamelen van telemetrie van live webtoepassingen in productie.

Zie voor meer informatie over de voordelen van het gebruik van de Azure Monitor OpenTelemetry Distro Waarom zou ik de Azure Monitor OpenTelemetry Distro gebruiken.

Voor meer informatie over het verzamelen van gegevens met behulp van OpenTelemetry raadpleegt u Collect OpenTelemetry (OTel) voor Application Insights-ervaringen of de veelgestelde vragen over OpenTelemetry.

Releasestatus van OpenTelemetry

OpenTelemetry-aanbiedingen zijn beschikbaar voor toepassingen .NET, Node.js, Python en Java. Zie de FAQ voor de status van de functies per release.

Notitie

Zie Use OpenTelemetry with Azure Functions voor Azure Functie-apps.

OpenTelemetry inschakelen met Application Insights

Volg de stappen in deze sectie om uw toepassing te instrumenteren met OpenTelemetry. Selecteer een tabblad voor taalspecifieke instructies.

Notitie

.NET behandelt meerdere scenario's, waaronder klassieke ASP.NET, console-apps, Windows Forms (WinForms) en meer.

Voorwaarden

Azure-abonnement: Maak gratis een Azure-abonnement
Application Insights-resource: een Application Insights-resource maken

ASP.NET Core Application met behulp van een officieel ondersteunde versie van .NET

Aanbeveling

Als u migreert vanuit de klassieke Application Insights-API, raadpleegt u onze migratiedocumentatie.

De clientbibliotheek installeren

Installeer het nieuwste Azure.Monitor.OpenTelemetry.AspNetCoreNuGet-pakket:

dotnet add package Azure.Monitor.OpenTelemetry.AspNetCore

Installeer het nieuwste Azure.Monitor.OpenTelemetry.ExporterNuGet-pakket:

dotnet add package Azure.Monitor.OpenTelemetry.Exporter

Installeer het meest recente @azure/monitor-opentelemetry pakket:

npm install @azure/monitor-opentelemetry

De volgende pakketten worden ook gebruikt voor een aantal specifieke scenario's die verderop in dit artikel worden beschreven:

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

Installeer het nieuwste PyPI-pakket azure-monitor-opentelemetry :

pip install azure-monitor-opentelemetry

Uw toepassing wijzigen

Importeer de Azure.Monitor.OpenTelemetry.AspNetCore-naamruimte, voeg OpenTelemetry toe en configureer deze om Azure Monitor te gebruiken in de klasse program.cs:

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

Voeg de Azure Monitor Exporter toe aan elk OpenTelemetry-signaal in de klasse program.cs:

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

Notitie

Zie voor meer informatie de getting-started-zelfstudie voor OpenTelemetry .NET

Automatische instrumentatie wordt ingeschakeld via configuratiewijzigingen. Er zijn geen codewijzigingen vereist.

Wijs de Java virtuele machine (JVM) aan het JAR-bestand door -javaagent:"path/to/applicationinsights-agent-3.7.8.jar" toe te voegen aan de JVM-argumenten van uw toepassing.

Notitie

Sampling is standaard ingeschakeld met een snelheid van vijf aanvragen per seconde, wat bijdraagt aan kostenbeheer. Telemetriegegevens kunnen ontbreken in scenario's die deze snelheid overschrijden. Zie steekproefoverschrijvingen voor meer informatie over het wijzigen van de samplingconfiguratie. Als u onverwachte kosten of hoge kosten in Application Insights ziet, kan deze handleiding u helpen. Het behandelt veelvoorkomende oorzaken, zoals een hoog telemetrievolume, pieken in gegevensopname en onjuist geconfigureerde steekproeven. Het is vooral handig als u problemen tegenkomt met betrekking tot kostenpieken, telemetrievolume, het niet werken van steekproeven, limieten, hoge gegevensopname of onverwachte facturering. Zie Problemen met hoge gegevensopname in Application Insights oplossen om aan de slag te gaan.

Aanbeveling

Zie Aan de slag (aanvullende) voor scenariospecifieke richtlijnen.

Aanbeveling

Als u een Spring Boot-toepassing ontwikkelt, kunt u het JVM-argument desgewenst vervangen door een programmatische configuratie. Zie Using Azure Monitor Application Insights met Spring Boot voor meer informatie.

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

Kopieer de verbindingsreeks uit uw Application Insights-resource

De verbindingsreeks is uniek en geeft aan waar de Azure Monitor OpenTelemetry Distro de telemetrie verzendt die wordt verzameld.

Aanbeveling

Als u nog geen Application Insights-resource hebt, maakt u er een aan de hand van deze handleiding. U wordt aangeraden een nieuwe resource te maken in plaats van een bestaande resource te gebruiken.

De verbindingsreeks kopiëren:

Ga naar het deelvenster Overzicht van uw Application Insights-resource.
Vind uw verbindingsreeks.
Beweeg de muisaanwijzer over de verbindingsreeks en selecteer het pictogram Kopiëren naar klembord.

Plak de verbindingstekst in uw technische omgeving.

Als u uw verbindingsreeks wilt plakken, selecteert u een van de volgende opties:

Belangrijk

U wordt aangeraden de verbindingsreeks alleen in lokale ontwikkel- en testomgevingen in te stellen via code.

Gebruik voor productie een omgevingsvariabele of configuratiebestand (alleen Java).

Instellen via omgevingsvariabele - aanbevolen

Vervang <Your verbindingsreeks> in de volgende opdracht door uw verbindingsreeks.
```
APPLICATIONINSIGHTS_CONNECTION_STRING=<Your connection string>
```
Set via configuratiebestand - Alleen Java

Maak een configuratiebestand met de naam applicationinsights.jsonen plaats het in dezelfde map als applicationinsights-agent-3.7.8.jar met de volgende inhoud:
```
{
  "connectionString": "<Your connection string>"
}
```
Vervang <Your verbindingsreeks> in de voorgaande JSON door uw unieke verbindingsstring.
Set via code - Alleen ASP.NET Core, Node.js en Python

Zie verbindingsreeks configuratie voor een voorbeeld van het instellen van verbindingsreeks via code.

Notitie

Als u de verbindingsreeks op meerdere plaatsen instelt, wordt de omgevingsvariabele in de volgende volgorde gerangschikt:

Code
Omgevingsvariabele
Configuratiebestand

Bevestigen dat de gegevens stromen

Voer uw toepassing uit en open Application Insights in de Azure-portal. Het kan enkele minuten duren voordat gegevens worden weergegeven.

Schermopname van het tabblad Overzicht van Application Insights met serveraanvragen en reactietijd van de server gemarkeerd.

Application Insights is nu ingeschakeld voor uw toepassing. De volgende stappen zijn optioneel en maken verdere aanpassingen mogelijk.

Notitie

Als onderdeel van het gebruik van Application Insights-instrumentatie verzamelen en verzenden we diagnostische gegevens naar Microsoft. Met deze gegevens kunnen we Application Insights uitvoeren en verbeteren. Meer informatie vindt u in de veelgestelde vragen over Application Insights.

Belangrijk

Als u twee of meer services hebt die telemetrie verzenden naar dezelfde Application Insights-resource, moet u cloudrolnamen instellen om deze correct weer te geven op het toepassingsoverzicht.

Problemen oplossen, feedback en ondersteuning

Aanbeveling

De volgende secties zijn beschikbaar in alle OpenTelemetry Distro-artikelen.

Troubleshooting

Zie Problemen met OpenTelemetry in .NET oplossen en Ontbrekende applicatietelemetrie in Azure Monitor Application Insights oplossen voor informatie over het oplossen van problemen.

OpenTelemetry Terugkoppeling

Feedback geven:

Vul de feedbackenquête van de OpenTelemetry-community in.
Vertel Microsoft over uzelf door deel te nemen aan de OpenTelemetry Early Adopter Community.
Neem contact op met andere Azure Monitor gebruikers in de Microsoft Tech Community.
Maak een functieaanvraag op het Azure Feedbackforum.

Support

Selecteer een tabblad voor de taal van uw keuze om ondersteuningsopties te ontdekken.

Voor ondersteuning voor Azure problemen opent u een ondersteuning voor Azure-ticket.
Neem voor problemen met OpenTelemetry rechtstreeks contact op met de OpenTelemetry .NET community.
Zie de pagina GitHub Issues Page voor een lijst met openstaande problemen met betrekking tot Azure Monitor Exporteur.

Volgende stappen

Zie de Azure Monitor ASP.NET Core GitHub-opslagplaats om de broncode te bekijken.
Zie Azure Monitor OpenTelemetry voor ASP.NET Core als u een voorbeeldtoepassing wilt bekijken.
Zie de pagina Azure Monitor AspNetCore NuGet-pakket om het NuGet-pakket te installeren, op updates te controleren of opmerkingen bij de release weer te geven.
Zie de OpenTelemetry .NET GitHub repository voor meer informatie over OpenTelemetry en de bijbehorende community.
Als u gebruikservaringen wilt inschakelen, schakelt u bewaking van web- of browsergebruikers in.

Zie de Azure Monitor OpenTelemetry voor JavaScript-opslagplaats om de broncode te bekijken.
Zie Azure Monitor OpenTelemetry voor Node.js als u een voorbeeldtoepassing wilt bekijken.
Als u het npm-pakket wilt installeren en op updates wilt controleren, raadpleegt u de @azure/monitor-opentelemetry pagina npm-pakket .
Zie de OpenTelemetry JavaScript GitHub repository voor meer informatie over OpenTelemetry en de bijbehorende community.
Als u gebruikservaringen wilt inschakelen, schakelt u bewaking van web- of browsergebruikers in.

Feedback

Is deze pagina nuttig?

Last updated on 2026-04-11

Delen via

Azure Monitor OpenTelemetry inschakelen voor .NET-, Node.js-, Python- en Java-toepassingen

Releasestatus van OpenTelemetry

OpenTelemetry inschakelen met Application Insights

Voorwaarden

De clientbibliotheek installeren

Uw toepassing wijzigen

Kopieer de verbindingsreeks uit uw Application Insights-resource

Plak de verbindingstekst in uw technische omgeving.

Bevestigen dat de gegevens stromen

Problemen oplossen, feedback en ondersteuning

Troubleshooting

OpenTelemetry Terugkoppeling

Support

Volgende stappen

Feedback

Aanvullende resources