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 in Application Insights. De Azure Monitor OpenTelemetry Distro:

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

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

Voor meer informatie over het verzamelen van gegevens met behulp van OpenTelemetry raadpleegt u de basisbeginselen van gegevensverzameling of de veelgestelde vragen over OpenTelemetry.

Releasestatus van OpenTelemetry

OpenTelemetry-aanbiedingen zijn beschikbaar voor .NET-, Node.js-, Python- en Java-toepassingen. Zie de veelgestelde vragen voor een functie-by-feature-releasestatus.

OpenTelemetry inschakelen met Application Insights

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

Notitie

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

Vereisten

• Azure-abonnement: Gratis een Azure-abonnement maken
• Application Insights-resource: een Application Insights-resource maken

ASP.NET Core

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

Tip

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

.NET

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

Tip

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

Java

• Een Java-toepassing met Java 8+

Systeemeigen Java

• Een Java-toepassing met GraalVM 17+

Node.js

• Toepassing met behulp van een officieel ondersteunde versie van 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 uw eenvoudigste pad na een bètaversie.

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

Tip

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

Python

• Python-toepassing met Python 3.8+

Tip

Als u migreert vanuit OpenCensus, raadpleegt u onze migratiedocumentatie.

De clientbibliotheek installeren

ASP.NET Core

Installeer het nieuwste Azure.Monitor.OpenTelemetry.AspNetCore NuGet-pakket:

dotnet add package Azure.Monitor.OpenTelemetry.AspNetCore 

.NET

Installeer het nieuwste Azure.Monitor.OpenTelemetry.Exporter NuGet-pakket:

dotnet add package Azure.Monitor.OpenTelemetry.Exporter 

Java

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

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

Systeemeigen Java

Voor systeemeigen Spring Boot-toepassingen :

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

Voor Quarkus-systeemeigen toepassingen:

• Voeg de Quarkus OpenTelemetry Exporter toe voor Azure-afhankelijkheid .

Node.js

Installeer het nieuwste pakket @azure/monitor-opentelemetry :

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 in uw program.cs klasse te gebruiken:

// 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-exporteur toe aan elk OpenTelemetry-signaal in de program.cs klasse:

// 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 de zelfstudie Aan de slag voor OpenTelemetry .NET voor meer informatie

Java

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

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

Notitie

Steekproeven worden standaard ingeschakeld met een snelheid van 5 aanvragen per seconde, met ondersteuning voor kostenbeheer. Telemetriegegevens ontbreken mogelijk in scenario's die deze snelheid overschrijden. Zie steekproefoverschrijvingen voor meer informatie over het wijzigen van de samplingconfiguratie.

Tip

Zie Aan de slag (aanvullende) voor scenariospecifieke richtlijnen.

Tip

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

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

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.

Tip

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. Zoek uw verbindingsreeks.
3. Beweeg de muisaanwijzer over de verbindingsreeks en selecteer het pictogram Kopiëren naar klembord.

Plak de verbindingsreeks in uw 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 connection string> in de volgende opdracht door uw verbindingsreeks.

  APPLICATIONINSIGHTS_CONNECTION_STRING=<Your connection string>
  

• Alleen instellen via configuratiebestand - java

  Maak een configuratiebestand met de naam applicationinsights.jsonen plaats het in dezelfde map als applicationinsights-agent-3.6.2.jar met de volgende inhoud:

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

  Vervang <Your connection string> in de voorgaande JSON door uw unieke verbindingsreeks.

• Alleen instellen via code - 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, krijgt de omgevingsvariabele prioriteit in de volgende volgorde:

1. Code
2. Omgevingsvariabele
3. Configuratiebestand

Bevestigen dat de gegevens stromen

Voer uw toepassing uit en open Application Insights in Azure Portal. 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.

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.

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. Zie Statsbeat in Azure-toepassing Insights voor meer informatie.

Voorbeeldtoepassingen

Azure Monitor OpenTelemetry-voorbeeldtoepassingen zijn beschikbaar voor alle ondersteunde talen:

• ASP.NET Core-voorbeeld-app
• NET-voorbeeld-app
• Java-voorbeeld-apps
• Systeemeigen Java GraalVM-voorbeeld-apps
• Node.js voorbeeld-app
• Python-voorbeeld-apps

Volgende stappen

ASP.NET Core

• Zie Azure Monitor OpenTelemetry toevoegen en wijzigen voor meer informatie over het toevoegen en wijzigen van Azure Monitor OpenTelemetry.
• Zie de Configuratie van Azure Monitor OpenTelemetry om de distributie van OpenTelemetry verder te configureren.
• Als u de broncode wilt bekijken, raadpleegt u de GitHub-opslagplaats van Azure Monitor AspNetCore.
• Als u het NuGet-pakket wilt installeren, controleert u op updates of bekijkt u opmerkingen bij de release. Zie de pagina Azure Monitor AspNetCore NuGet Package .
• Als u vertrouwd wilt raken met Azure Monitor en OpenTelemetry, raadpleegt u de Azure Monitor-voorbeeldtoepassing.
• Zie de Opslagplaats OpenTelemetry .NET GitHub voor meer informatie over OpenTelemetry en de bijbehorende community.
• Als u gebruikservaringen wilt inschakelen, schakelt u bewaking van web- of browsergebruikers in.
• Als u veelgestelde vragen, probleemoplossingsstappen, ondersteuningsopties of OpenTelemetry-feedback wilt geven, raadpleegt u De Help, ondersteuning en feedback van OpenTelemetry voor Azure Monitor Application Insights.

.NET

• Zie Azure Monitor OpenTelemetry toevoegen en wijzigen voor meer informatie over het toevoegen en wijzigen van Azure Monitor OpenTelemetry.
• Zie de Configuratie van Azure Monitor OpenTelemetry om de distributie van OpenTelemetry verder te configureren.
• Als u de broncode wilt bekijken, raadpleegt u de GitHub-opslagplaats van de Azure Monitor-exporteur.
• Als u het NuGet-pakket wilt installeren, controleert u op updates of bekijkt u de releaseopmerkingen op de pagina NuGet-pakket van Azure Monitor Exporter.
• Als u vertrouwd wilt raken met Azure Monitor en OpenTelemetry, raadpleegt u de Azure Monitor-voorbeeldtoepassing.
• Zie de Opslagplaats OpenTelemetry .NET GitHub voor meer informatie over OpenTelemetry en de bijbehorende community.
• Als u gebruikservaringen wilt inschakelen, schakelt u bewaking van web- of browsergebruikers in.
• Als u veelgestelde vragen, probleemoplossingsstappen, ondersteuningsopties of OpenTelemetry-feedback wilt geven, raadpleegt u De Help, ondersteuning en feedback van OpenTelemetry voor Azure Monitor Application Insights.

Java

• Zie Azure Monitor OpenTelemetry toevoegen en wijzigen voor meer informatie over het toevoegen en wijzigen van Azure Monitor OpenTelemetry.
• Controleer de configuratieopties voor Automatische instrumentatie van Java.
• Controleer de broncode in de GitHub-opslagplaats voor automatische instrumentatie van Azure Monitor Java.
• Meer informatie over OpenTelemetry en de bijbehorende community vindt u in de GitHub-opslagplaats van OpenTelemetry Java.
• Gebruikservaringen inschakelen door bewaking van web- of browsergebruikers inschakelen te zien.
• Bekijk de releaseopmerkingen op GitHub.
• Als u veelgestelde vragen, probleemoplossingsstappen, ondersteuningsopties of OpenTelemetry-feedback wilt geven, raadpleegt u De Help, ondersteuning en feedback van OpenTelemetry voor Azure Monitor Application Insights.

Systeemeigen Java

• Zie Azure Monitor OpenTelemetry toevoegen en wijzigen voor meer informatie over het toevoegen en wijzigen van Azure Monitor OpenTelemetry.
• Bekijk de broncode in de Azure Monitor OpenTelemetry Distro in de Systeemeigen Spring Boot-installatiekopie Java-toepassing en Quarkus OpenTelemetry Exporter voor Azure.
• Meer informatie over OpenTelemetry en de bijbehorende community vindt u in de GitHub-opslagplaats van OpenTelemetry Java.
• Meer informatie over functies voor systeemeigen Spring Boot-installatiekopietoepassingen in OpenTelemetry SpringBoot starter
• Meer informatie over functies voor systeemeigen Quarkus-toepassingen in Quarkus OpenTelemetry Exporter voor Azure.
• Bekijk de releaseopmerkingen op GitHub.
• Als u veelgestelde vragen, probleemoplossingsstappen, ondersteuningsopties of OpenTelemetry-feedback wilt geven, raadpleegt u De Help, ondersteuning en feedback van OpenTelemetry voor Azure Monitor Application Insights.

Node.js

• Zie Azure Monitor OpenTelemetry toevoegen en wijzigen voor meer informatie over het toevoegen en wijzigen van Azure Monitor OpenTelemetry.
• Als u de broncode wilt bekijken, raadpleegt u de GitHub-opslagplaats van Azure Monitor OpenTelemetry.
• Als u het npm-pakket wilt installeren en op updates wilt controleren, raadpleegt u de @azure/monitor-opentelemetry pagina npm-pakket .
• Als u meer vertrouwd wilt raken met Azure Monitor Application Insights en OpenTelemetry, raadpleegt u de Azure Monitor-voorbeeldtoepassing.
• Zie de GitHub-opslagplaats van OpenTelemetry voor meer informatie over OpenTelemetry en de bijbehorende community.
• Als u gebruikservaringen wilt inschakelen, schakelt u bewaking van web- of browsergebruikers in.
• Als u veelgestelde vragen, probleemoplossingsstappen, ondersteuningsopties of OpenTelemetry-feedback wilt geven, raadpleegt u De Help, ondersteuning en feedback van OpenTelemetry voor Azure Monitor Application Insights.

Python

• Zie Azure Monitor OpenTelemetry toevoegen en wijzigen voor meer informatie over het toevoegen en wijzigen van Azure Monitor OpenTelemetry.
• Bekijk de broncode en extra documentatie in de GitHub-opslagplaats van Azure Monitor Distro.
• Bekijk extra voorbeelden en use cases in Azure Monitor Distro-voorbeelden.
• Bekijk het wijzigingenlogboek op GitHub.
• Installeer het PyPI-pakket, controleer op updates of bekijk releaseopmerkingen op de pagina Azure Monitor Distro PyPI-pakket .
• Raak vertrouwd met Azure Monitor Application Insights en OpenTelemetry in de Azure Monitor-voorbeeldtoepassing.
• Meer informatie over OpenTelemetry en de bijbehorende community vindt u in de GitHub-opslagplaats van OpenTelemetry Python.
• Bekijk beschikbare OpenTelemetry-instrumentaties en -onderdelen in de GitHub-opslagplaats voor Inzender voor OpenTelemetry.
• Schakel gebruikservaringen in door bewaking van web- of browsergebruikers in te schakelen.
• Als u veelgestelde vragen, probleemoplossingsstappen, ondersteuningsopties of OpenTelemetry-feedback wilt geven, raadpleegt u De Help, ondersteuning en feedback van OpenTelemetry voor Azure Monitor Application Insights.