Aktivera Azure Monitor OpenTelemetry för .NET, Node.js, Python och Java program

Den här artikeln beskriver hur du aktiverar och konfigurerar OpenTelemetry-baserad datainsamling inom Azure Monitor Application Insights. Azure Monitor OpenTelemetry Distro:

Tillhandahåller en OpenTelemetry-distribution, som innehåller stöd för funktioner som är specifika för Azure Monitor.
Aktiverar automatisk telemetritelemetri genom att inkludera OpenTelemetry-instrumentationsbibliotek för insamling av spårningar, mått, loggar och undantag.
Tillåter insamling av anpassad telemetri.
Har stöd för Live Metrics för att övervaka och samla in telemetri från webbprogram i realtid i produktion.

Mer information om fördelarna med att använda Azure Monitor OpenTelemetry Distro finns i Why should I use the Azure Monitor OpenTelemetry Distro.

Mer information om hur du samlar in data med OpenTelemetry finns i Samla in OpenTelemetry (OTel) för Application Insights-upplevelser eller vanliga frågor och svar om OpenTelemetry.

OpenTelemetry-versionsstatus

OpenTelemetry-erbjudanden är tillgängliga för .NET, Node.js, Python och Java program. En funktionsspecifik versionsstatus finns i Vanliga frågor och svar.

Anteckning

För Azure-funktionsappar, se Använd OpenTelemetry med Azure Functions.

Aktivera OpenTelemetry med Application Insights

Följ stegen i det här avsnittet för att instrumentera ditt program med OpenTelemetry. Välj en flik för språkspecifika instruktioner.

Anteckning

.NET omfattar flera scenarier, till exempel klassiska ASP.NET, konsolappar, Windows Forms (WinForms) med mera.

Förutsättningar

Azure prenumeration: Skapa en Azure prenumeration kostnadsfritt
Application Insights-resurs: Skapa en resurs för Application Insights

ASP.NET Core Application med en officiellt stödd version av .NET

Tips

Om du migrerar från det klassiska API:et för Application Insights kan du läsa vår migreringsdokumentation.

Installera klientbiblioteket

Installera det senaste Azure.Monitor.OpenTelemetry.AspNetCoreNuGet-paketet:

dotnet add package Azure.Monitor.OpenTelemetry.AspNetCore

Installera det senaste Azure.Monitor.OpenTelemetry.ExporterNuGet-paketet:

dotnet add package Azure.Monitor.OpenTelemetry.Exporter

Installera det senaste @azure/monitor-opentelemetry paketet:

npm install @azure/monitor-opentelemetry

Följande paket används också för vissa specifika scenarier som beskrivs senare i den här artikeln:

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

Installera det senaste PyPI-paketet azure-monitor-opentelemetry :

pip install azure-monitor-opentelemetry

Ändra ditt program

Importera namnområdet Azure.Monitor.OpenTelemetry.AspNetCore, lägg till OpenTelemetry och konfigurera det att använda Azure Monitor i klassen 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();

Lägg till Azure Monitor Exporter till varje OpenTelemetry-signal i klassen 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();
    });
});

Anteckning

Mer information finns i självstudien getting-started för OpenTelemetry .NET

Automatisk instrumentering aktiveras genom konfigurationsändringar. Inga kodändringar krävs.

Peka den Java virtuella maskinen (JVM) till jar-filen genom att lägga till -javaagent:"path/to/applicationinsights-agent-3.7.8.jar" till din applikations JVM-argument.

Anteckning

Sampling aktiveras som standard med en frekvens på fem begäranden per sekund, vilket underlättar kostnadshanteringen. Telemetridata kan saknas i scenarier som överskrider den här takten. För mer information om att ändra samplingskonfigurationen, se inställningar för provtagning. Om du ser oväntade avgifter eller höga kostnader i Application Insights kan den här guiden hjälpa dig. Den omfattar vanliga orsaker som hög telemetrivolym, datainmatningstoppar och felkonfigurerad sampling. Det är särskilt användbart om du felsöker problem som rör kostnadstoppar, telemetrivolym, sampling som inte fungerar, datatak, hög inmatning eller oväntad fakturering. Information om hur du kommer igång finns i Felsöka hög datainmatning i Application Insights.

Tips

För scenariospecifik vägledning, se Kom igång (kompletterande).

Tips

Om du utvecklar ett Spring Boot-program kan du ersätta JVM-argumentet med en programmatisk konfiguration. Mer information finns i Använda Azure Monitor Application Insights med 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.

Kopiera reťazec pripojenia från Application Insights-resursen

Connection string är unik och anger var Azure Monitor OpenTelemetry Distro skickar telemetrin som samlas in.

Tips

Om du inte redan har en Application Insights-resurs skapar du en som följer den här guiden. Vi rekommenderar att du skapar en ny resurs i stället för att använda en befintlig resurs.

Kopiera anslutningssträng:

Gå till översiktspanelen för din Application Insights-resurs.
Hitta din anslutningssträng.
Hovra över anslutningssträngen och välj ikonen Kopiera till urklipp.

Klistra in reťazec pripojeniaen i din miljö

Om du vill klistra in reťazec pripojenia väljer du bland följande alternativ:

Viktigt!

Vi rekommenderar att du ställer in reťazec pripojenia endast via kod i lokala utvecklings- och testmiljöer.

För produktion använder du en miljövariabel eller konfigurationsfil (endast Java).

Ställ in via miljövariabel - rekommenderas

Ersätt <Your reťazec pripojenia> i följande kommando med din anslutningssträng.
```
APPLICATIONINSIGHTS_CONNECTION_STRING=<Your connection string>
```
Set via konfigurationsfilen - Java endast

Skapa en konfigurationsfil med namnet applicationinsights.jsonoch placera den i samma katalog som applicationinsights-agent-3.7.8.jar med följande innehåll:
```
{
  "connectionString": "<Your connection string>"
}
```
Byt ut <Your reťazec pripojenia> i föregående JSON med din unika anslutningssträng.
Set via kod - ASP.NET Core, Node.jsoch endast Python

Se reťazec pripojenia konfiguration för ett exempel på hur du ställer in reťazec pripojenia via kod.

Anteckning

Om du anger reťazec pripojenia på flera platser prioriteras miljövariabeln i följande ordning:

Kod
Miljövariabel
Konfigurationsfil

Bekräfta att data flödar

Kör ditt program och öppna sedan Application Insights i Azure-portalen. Det kan ta några minuter innan data visas.

Skärmbild av fliken Översikt för Application Insights med serverbegäranden och serverns svarstid markerad.

Application Insights är nu aktiverat för ditt program. Följande steg är valfria och tillåter ytterligare anpassning.

Anteckning

Som en del av användningen av Application Insights-instrumentation samlar vi in och skickar diagnostikdata till Microsoft. Dessa data hjälper oss att köra och förbättra Application Insights. Läs mer i Vanliga frågor och svar om Application Insights.

Viktigt!

Om du har två eller flera tjänster som genererar telemetri till samma Application Insights-resurs måste du ange molnrollnamn för att representera dem korrekt på programkartan.

Felsökning, feedback och support

Tips

Följande avsnitt är tillgängliga i alla OpenTelemetry Distro-artiklar.

Felsökning

Felsökningsinformation finns i Felsök OpenTelemetry-problem i .NET och Felsök saknad applikationstelemetri i Azure Monitor Application Insights.

OpenTelemetry Återkoppling

Så här ger du feedback:

Fyll i OpenTelemetry Communitys kundfeedbackundersökning.
Berätta för Microsoft om dig själv genom att gå med i OpenTelemetry Early Adopter Community.
Kontakta andra Azure Monitor användare i Microsoft Tech Community.
Gör en funktionsbegäran på Azure Feedback Forum.

Support

Välj en flik för det språk du väljer för att identifiera supportalternativ.

För Azure support problem öppnar du ett Azure support-ärende.
Om du har problem med OpenTelemetry kontaktar du OpenTelemetry .NET community direkt.
En lista över öppna problem som rör Azure Monitor Exporter finns på sidan GitHub issues.

Nästa steg

Information om hur du granskar källkoden finns i lagringsplatsen Azure Monitor ASP.NET Core GitHub.
Om du vill granska ett exempelprogram läser du Azure Monitor OpenTelemetry för ASP.NET Core.
För att installera NuGet-paketet, söka efter uppdateringar eller visa versionsanteckningar, se sidan Azure Monitor AspNetCore NuGet Package.
Mer information om OpenTelemetry och dess community finns i OpenTelemetry .NET GitHub repository.
Aktivera webb- eller webbläsaranvändarövervakning för att aktivera användningsupplevelser.

Om du vill granska källkoden, se Azure Monitor OpenTelemetry för JavaScript-repository.
Om du vill granska ett exempelprogram läser du Azure Monitor OpenTelemetry för Node.js.
Information om hur du installerar npm-paketet och söker efter uppdateringar finns på @azure/monitor-opentelemetry sidan npm-paket .
Mer information om OpenTelemetry och dess community finns i OpenTelemetry JavaScript GitHub lagringsplats.
Aktivera webb- eller webbläsaranvändarövervakning för att aktivera användningsupplevelser.

Feedback

Var den här sidan till hjälp?

Last updated on 2026-04-11

Dela via

Aktivera Azure Monitor OpenTelemetry för .NET, Node.js, Python och Java program

OpenTelemetry-versionsstatus

Aktivera OpenTelemetry med Application Insights

Förutsättningar

Installera klientbiblioteket

Ändra ditt program

Kopiera reťazec pripojenia från Application Insights-resursen

Klistra in reťazec pripojeniaen i din miljö

Bekräfta att data flödar

Felsökning, feedback och support

Felsökning

OpenTelemetry Återkoppling

Support

Nästa steg

Feedback

Ytterligare resurser