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 met behulp van de Azure Monitor OpenTelemetry Distro. OpenTelemetry is de opensource CNCF-waarneembaarheidsstandaard; de Azure Monitor OpenTelemetry Distro is Microsoft distributie van die standaard, geoptimaliseerd voor Azure Monitor. De distributie:

• Biedt een OpenTelemetry-distributie, waaronder ondersteuning voor functies die specifiek zijn voor Azure Monitor.
• Hiermee kunt u automatische telemetrieverzameling inschakelen 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.

Raadpleeg het Application Insights-overzicht of de veelgestelde vragen over OpenTelemetry voor meer informatie over het verzamelen van gegevens met behulp van OpenTelemetry.

Volg de stappen in dit artikel om de distributie te installeren, deze te verbinden met uw Application Insights-resource en te controleren of telemetriegegevens naar Azure Monitor stromen.

Aanbeveling

Zie OpenTelemetry met Azure Monitor voor een conceptueel overzicht van de OpenTelemetry-opties in Azure Monitor — systeemeigen OTLP-opname, de Microsoft OpenTelemetry-distributie en end-to-end-observabilityervaringen.

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.

De volgende tabel bevat een overzicht van de pakketten en installatieopdrachten voor elke ondersteunde taal:

Language	Package	Opdracht Installeren
ASP.NET Core	Azure.Monitor.OpenTelemetry.AspNetCore	dotnet add package Azure.Monitor.OpenTelemetry.AspNetCore
.NET	Azure.Monitor.OpenTelemetry.Exporter	dotnet add package Azure.Monitor.OpenTelemetry.Exporter
Java	applicationinsights-agent-3.7.8.jar	Download van GitHub
Node.js	@azure/monitor-opentelemetry	npm install @azure/monitor-opentelemetry
Python	azure-monitor-opentelemetry	pip install azure-monitor-opentelemetry

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

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

Aanbeveling

Als u migreert van oudere Application Insights SDK's, raadpleegt u onze migratiedocumentatie.

.NET

• Toepassing die gebruikmaakt van een ondersteunde versie van .NET of .NET Framework 4.6.2 en hoger.

Aanbeveling

Als u migreert van oudere Application Insights SDK's, raadpleegt u onze migratiedocumentatie.

Java

• Een Java-toepassing met Java 8+

native Java

• Een Java toepassing met GraalVM 17+

Node.js

• Toepassing die gebruikmaakt van een officieel ondersteunde versie van de Node.js-runtime.
  • Ondersteunde runtimes voor OpenTelemetry
  • Ondersteunde runtimes van Azure Monitor OpenTelemetry Exporter

Notitie

Als u niet afhankelijk bent van eigenschappen die worden vermeld in de niet-ondersteunde tabel, is de ApplicationInsights shim de gemakkelijkste manier om verder te gaan zodra het uit de bètaversie is.

Als u afhankelijk bent van een van deze eigenschappen, gaat u verder met de Azure Monitor OpenTelemetry Distro.

Aanbeveling

Als u migreert van oudere Application Insights SDK's, raadpleegt u onze migratiedocumentatie.

Python

• Python toepassing met Python 3.10+

Aanbeveling

Als u migreert vanuit OpenCensus, raadpleegt u onze migratiedocumentatie.

De clientbibliotheek installeren

ASP.NET Core

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

dotnet add package Azure.Monitor.OpenTelemetry.AspNetCore

.NET

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

dotnet add package Azure.Monitor.OpenTelemetry.Exporter

Java

Download het meest recente bestand applicationinsights-agent-3.7.8.jar.

Waarschuwing

Als u een upgrade uitvoert van een eerdere versie van 3.x, kan dit gevolgen hebben voor het wijzigen van de standaardinstellingen of kleine verschillen in de gegevens die we verzamelen. Zie de sectie Migratie in de opmerkingen bij de release voor meer informatie. 3.5.0, 3.4.0, 3.3.0, 3.2.0 en 3.1.0

native Java

Voor systeemeigen Spring Boot-toepassingen :

• Importeer de OpenTelemetry Bills of Materials (BOM).
• Voeg de afhankelijkheid Spring Cloud Azure Starter Monitor toe.
• Volg e instructies voor de Azure SDK JAR-bestanden (Java Archive).

Voor Quarkus-systeemeigen toepassingen:

• Voeg de Quarkus OpenTelemetry Exporter toe voor Azure afhankelijkheid.

Notitie

De Quarkus-community ondersteunt en onderhoudt Quarkus-extensies. Gebruik Quarkus community ondersteuningskanalen voor hulp. Microsoft biedt geen technische ondersteuning voor deze integratie.

Node.js

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:

• @opentelemetry/API
• @opentelemetry/sdk-metrics
• @opentelemetry/resources
• @opentelemetry/semantische conventies
• @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

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

pip install azure-monitor-opentelemetry

Uw toepassing wijzigen

ASP.NET Core

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

.NET

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

Java

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.

native Java

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

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 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:

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

Plak de verbindingstekst in uw technische omgeving.

Gebruik een van de volgende methoden om uw verbindingsreeks te plakken:

Methode	Ondersteunde talen	Aanbevolen voor
Omgevingsvariabele	All	Productie
Configuratiebestand (applicationinsights.json)	Alleen Java	Productie (Java)
Code	ASP.NET Core, Node.js, Python	Alleen lokaal ontwikkelen/testen

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

• Stel de Application Insights-verbindingsreeks in als een omgevingsvariabele (aanbevolen voor productie)

  Vervang <Your verbindingsreeks> in de volgende opdracht door uw verbindingsreeks.

  APPLICATIONINSIGHTS_CONNECTION_STRING=<Your connection string>
  

• Stel de Application Insights-verbindingsreeks in een configuratiebestand in - 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.

• Stel de verbindingsreeks van Application Insights in code in - 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 deze omgezet in de volgende prioriteitsvolgorde (hoogste naar laagste):

1. Code
2. Omgevingsvariabele
3. Configuratiebestand

Bevestigen dat de gegevens stromen

Nadat u de Azure Monitor OpenTelemetry Distro hebt geconfigureerd en de verbindingsreeks hebt ingesteld, voert u uw toepassing uit en opent u de Application Insights-resource in de Azure-portal om te controleren of traceringen, metrische gegevens en logboeken worden weergegeven. Het kan enkele minuten duren voordat gegevens worden weergegeven.

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

ASP.NET Core

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

.NET

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

Java

Voor informatie over het oplossen van problemen, zie Troubleshoot OpenTelemetry problemen in Java en Troubleshoot ontbrekende applicatie-telemetrie in Azure Monitor Application Insights.

native Java

Zie Problemen met OpenTelemetry oplossen in Spring Boot native image applicaties en Ontbrekende applicatietelemetrie in Azure Monitor Application Insights oplossen voor informatie over probleemoplossing.

Node.js

Zie Troubleshoot OpenTelemetry-problemen in Node.js en Troubleshoot ontbrekende applicatietelemetrie in Azure Monitor Application Insights voor probleemoplosinformatie.

Python

Zie voor probleemoplossingsinformatie Problemen met OpenTelemetry in Python oplossen en Problemen met ontbrekende applicatietelemetrie in Azure Monitor Application Insights oplossen.

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.

ASP.NET Core

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

.NET

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

Java

• Voor ondersteuning voor Azure problemen opent u een ondersteuning voor Azure-ticket.
• Raadpleeg de stappen voor probleemoplossing voor hulp bij het oplossen van problemen.
• Neem voor problemen met OpenTelemetry rechtstreeks contact op met de OpenTelemetry-community .
• Zie de pagina GitHub Issues Page voor een lijst met openstaande problemen met betrekking tot Azure Monitor Java Autoinstrumentatie.

native Java

• Voor ondersteuning voor Azure problemen opent u een ondersteuning voor Azure-ticket.
• Neem voor problemen met OpenTelemetry rechtstreeks contact op met de OpenTelemetry-community .
• Zie de pagina GitHub Issues Page voor een lijst met geopende problemen met systeemeigen Spring Boot-toepassingen.
• Zie de GitHub Issues Page voor een lijst met geopende problemen met systeemeigen Quarkus-toepassingen.

Notitie

De Quarkus-community ondersteunt en onderhoudt Quarkus-extensies. Gebruik Quarkus community ondersteuningskanalen voor hulp. Microsoft biedt geen technische ondersteuning voor deze integratie.

Node.js

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

Python

• Voor ondersteuning voor Azure problemen opent u een ondersteuning voor Azure-ticket.
• Neem voor problemen met OpenTelemetry rechtstreeks contact op met de OpenTelemetry Python community.
• Zie de pagina GitHub issues page voor een lijst met openstaande problemen met betrekking tot Azure Monitor distro.

Volgende stappen

ASP.NET Core

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

.NET

• Zie de opslagplaats Azure Monitor Exporter GitHub opslagplaats om de broncode te bekijken.
• Zie Azure Monitor OpenTelemetry voor .NET als u een voorbeeldtoepassing wilt bekijken.
• Zie de pagina Azure Monitor Exporter NuGet Package 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.

Java

• Zie Java opties voor configuratie van automatische instrumentatie voor meer informatie over configuratieopties.
• Zie de Azure Monitor Java auto-instrumentatie GitHub opslagplaats om de broncode te bekijken.
• Zie Application Insights Java Samples om voorbeeldtoepassingen te bekijken.
• Bekijk de releasenotities op GitHub.
• Raadpleeg de OpenTelemetry Java GitHub repository voor meer informatie over OpenTelemetry en de bijbehorende community.
• Als u gebruikservaringen wilt inschakelen, raadpleegt u Bewaking van web- of browsergebruikers inschakelen.

native Java

• Zie Azure Monitor OpenTelemetry Distro in spring Boot native image Java application and Quarkus OpenTelemetry Exporter for Azure om de broncode te bekijken.
• Zie Telemetry for GraalVM native images voor een voorbeeldtoepassing.
• Bekijk de releasenotities op GitHub.
• Meer te weten komen over functies voor native image-toepassingen met Spring Boot in OpenTelemetry SpringBoot starter
• Meer informatie over functies voor systeemeigen Quarkus-toepassingen in Quarkus OpenTelemetry Exporter voor Azure.
• Raadpleeg de OpenTelemetry Java GitHub repository voor meer informatie over OpenTelemetry en de bijbehorende community.

Node.js

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

Python

• Zie de Azure Monitor Python GitHub-opslagplaats om de broncode en extra documentatie te bekijken.
• Zie Azure Monitor OpenTelemetry voor Python om voorbeeldtoepassingen te bekijken.
• Als u het PyPI-pakket wilt installeren en op updates wilt controleren, raadpleegt u de pagina Azure Monitor Distro PyPI Package.
• Bekijk de releasenotities op GitHub.
• Zie de OpenTelemetry Contributor Python GitHub opslagplaats om de beschikbare OpenTelemetry-instrumentaties en onderdelen te bekijken.
• Raadpleeg de OpenTelemetry Python GitHub opslagplaats voor meer informatie over OpenTelemetry en de bijbehorende community.
• Als u gebruikservaringen wilt inschakelen, schakelt u bewaking van web- of browsergebruikers in.