Abilitare Monitoraggio di Azure OpenTelemetry per applicazioni .NET, Node.js, Python e Java

Questo articolo descrive come abilitare e configurare la raccolta dati basata su OpenTelemetry all'interno di Monitoraggio di Azure Application Insights. Distribuzione di Monitoraggio di Azure OpenTelemetry:

Fornisce una distribuzione OpenTelemetry, che include il supporto per le funzionalità specifiche di Monitoraggio di Azure.
Abilita la telemetria automatica includendo librerie di strumentazione OpenTelemetry per raccogliere tracce, metriche, log ed eccezioni.
Consente di raccogliere dati di telemetria personalizzati.
Supporta metriche attive per monitorare e raccogliere dati di telemetria da applicazioni Web in produzione attive.

Per altre informazioni sui vantaggi dell'uso della distribuzione Monitoraggio di Azure OpenTelemetry, vedere Why è consigliabile usare la distribuzione Monitoraggio di Azure OpenTelemetry.

Per altre informazioni sulla raccolta di dati con OpenTelemetry, vedere Raccogliere opentelemetry (OTel) per le esperienze di Application Insights o le domande frequenti su OpenTelemetry.

Stato di rilascio di OpenTelemetry

Le offerte OpenTelemetry sono disponibili per le applicazioni .NET, Node.js, Python e Java. Per lo stato di rilascio di ciascuna funzionalità, consulta le FAQ.

Nota

Per le app per le funzioni di Azure, vedere Use OpenTelemetry con Funzioni di Azure.

Abilitare OpenTelemetry con Application Insights

Seguire la procedura descritta in questa sezione per instrumentare l'applicazione con OpenTelemetry. Selezionare una scheda per istruzioni specifiche della lingua.

Nota

.NET illustra più scenari, tra cui ASP.NET classici, app console, Windows Forms (WinForm) e altro ancora.

Prerequisiti

sottoscrizione Azure: Creare gratuitamente una sottoscrizione Azure
Risorsa di Application Insights: creare una risorsa di Application Insights

ASP.NET Core Application usando una versione ufficialmente supportata di .NET

Suggerimento

Se si esegue la migrazione dall'API classica di Application Insights, vedere la documentazione sulla migrazione.

Installare la libreria client

Installare il pacchetto più recente Azure.Monitor.OpenTelemetry.AspNetCoreNuGet:

dotnet add package Azure.Monitor.OpenTelemetry.AspNetCore

Installare il pacchetto più recente Azure.Monitor.OpenTelemetry.ExporterNuGet:

dotnet add package Azure.Monitor.OpenTelemetry.Exporter

Installare il pacchetto più recente @azure/monitor-opentelemetry :

npm install @azure/monitor-opentelemetry

I pacchetti seguenti vengono usati anche per alcuni scenari specifici descritti più avanti in questo articolo:

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

Installare la versione più recente del pacchetto azure-monitor-opentelemetry PyPI:

pip install azure-monitor-opentelemetry

Modificare l'applicazione

Importare lo spazio dei nomi Azure.Monitor.OpenTelemetry.AspNetCore, aggiungere OpenTelemetry e configurarlo per l'uso di Monitoraggio di Azure nella classe 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();

Aggiungere il Monitoraggio di Azure Exporter a ogni segnale OpenTelemetry nella classe 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();
    });
});

Nota

Per altre informazioni, vedere l'esercitazione introduttiva su OpenTelemetry .NET

La strumentazione automatica viene abilitata tramite le modifiche alla configurazione. Non sono necessarie modifiche al codice.

Indirizzare la macchina virtuale Java (JVM) al file JAR aggiungendo -javaagent:"path/to/applicationinsights-agent-3.7.8.jar" agli argomenti JVM dell'applicazione.

Nota

Il campionamento è abilitato per impostazione predefinita a una velocità di cinque richieste al secondo, facilitando la gestione dei costi. I dati di telemetria potrebbero non essere presenti negli scenari che superano questa frequenza. Per altre informazioni sulla modifica della configurazione di campionamento, vedere Override del campionamento. Se vengono visualizzati addebiti imprevisti o costi elevati in Application Insights, questa guida può essere utile. Vengono illustrate le cause comuni, ad esempio volumi di telemetria elevati, picchi di inserimento dati e campionamento non configurato correttamente. È particolarmente utile se si stanno risolvendo problemi relativi a picchi di costo, volume di telemetria, campionamento non funzionante, limiti di dati, inserimento elevato o fatturazione imprevista. Per iniziare, vedere Risolvere i problemi relativi all'inserimento dati elevato in Application Insights.

Suggerimento

Per indicazioni specifiche per gli scenari, vedere Introduzione (supplementare).

Suggerimento

Se si sviluppa un'applicazione Spring Boot, è possibile sostituire facoltativamente l'argomento JVM con una configurazione a livello di codice. Per altre informazioni, vedere Using Monitoraggio di Azure Application Insights con 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.

Copiare il stringa di connessione dalla risorsa di Application Insights

Il stringa di connessione è univoco e specifica dove la distribuzione Monitoraggio di Azure OpenTelemetry invia i dati di telemetria raccolti.

Suggerimento

Se non si ha già una risorsa di Application Insights, crearne una seguendo questa guida. È consigliabile creare una nuova risorsa anziché usarne una esistente.

Per copiare il stringa di connessione:

Passare al riquadro Panoramica della risorsa di Application Insights.
Trova la tua stringa di connessione.
Posiziona il cursore sulla stringa di connessione e seleziona l'icona Copia negli appunti.

Inserisci la stringa di connessione nel tuo ambiente

Per incollare il stringa di connessione, selezionare una delle opzioni seguenti:

Importante

È consigliabile impostare il stringa di connessione tramite codice solo in ambienti di sviluppo e test locali.

Per l'ambiente di produzione, usare una variabile di ambiente o un file di configurazione (solo Java).

Impostare tramite variabile di ambiente - scelta consigliata

Sostituire <Your stringa di connessione> nel comando seguente con il stringa di connessione.
```
APPLICATIONINSIGHTS_CONNECTION_STRING=<Your connection string>
```
Set tramite il file di configurazione - Solo Java

Creare un file di configurazione denominato applicationinsights.json e inserirlo nella stessa directory di applicationinsights-agent-3.7.8.jar con il contenuto seguente:
```
{
  "connectionString": "<Your connection string>"
}
```
Sostituire <Your stringa di connessione> nel codice JSON precedente con la vostra stringa di connessione univoca.
Set tramite codice - ASP.NET Core, Node.js e Python solo

Vedere configurazione della stringa di connessione per un esempio di impostazione della stringa di connessione tramite codice.

Nota

Se si imposta il stringa di connessione in più posizioni, la variabile di ambiente viene assegnata in ordine di priorità nell'ordine seguente:

Codice
Variabile di ambiente
File di configurazione

Verificare che i dati vengano trasmessi

Eseguire l'applicazione, quindi aprire Application Insights nel portale di Azure. La visualizzazione dei dati potrebbe richiedere alcuni minuti.

Screenshot della scheda Panoramica di Application Insights con le richieste del server e il tempo di risposta del server evidenziato.

Application Insights è ora abilitato per l'applicazione. I passaggi seguenti sono facoltativi e consentono ulteriori personalizzazioni.

Nota

Nell'ambito dell'uso della strumentazione di Application Insights, vengono raccolti e inviati dati di diagnostica a Microsoft. Questi dati consentono di eseguire e migliorare Application Insights. Altre informazioni sono disponibili nelle domande frequenti su Application Insights.

Importante

Se si dispone di due o più servizi che generano dati di telemetria nella stessa risorsa di Application Insights, è necessario impostare i nomi dei ruoli cloud per rappresentarli correttamente nella mappa delle applicazioni.

Risoluzione dei problemi, commenti e suggerimenti e supporto

Suggerimento

Le sezioni seguenti sono disponibili in tutti gli articoli sulla distribuzione di OpenTelemetry.

Risoluzione dei problemi

Per informazioni sulla risoluzione dei problemi, vedere Risoluzione dei problemi di OpenTelemetry in .NET e Risoluzione dei problemi di telemetria dell'applicazione mancante in Monitoraggio di Azure Application Insights.

Feedback su OpenTelemetry

Per inviare un feedback:

Compilare il sondaggio dei commenti e suggerimenti dei clienti della community OpenTelemetry.
Parla di te a Microsoft unendoti alla community dei primi utilizzatori di OpenTelemetry.
Interagire con altri utenti di Monitoraggio di Azure in Microsoft Tech Community.
Effettuare una richiesta di funzionalità nel forum Azure feedback.

Support

Selezionare la scheda del linguaggio scelto per scoprire le opzioni di supporto.

Per problemi di supporto Azure, aprire un ticket di supporto Azure.
Per i problemi di OpenTelemetry, contattare direttamente OpenTelemetry .NET community.
Per un elenco dei problemi aperti relativi all'utilità di esportazione di Monitoraggio di Azure, vedere la pagina GitHub Issues Page.

Passaggi successivi

Per esaminare il codice sorgente, vedere il repository Monitoraggio di Azure ASP.NET Core GitHub.
Per esaminare un'applicazione di esempio, vedere Monitoraggio di Azure OpenTelemetry per ASP.NET Core.
Per installare il pacchetto NuGet, verificare la disponibilità di aggiornamenti o visualizzare le note sulla versione, vedere la pagina Monitoraggio di Azure pacchetto NuGet AspNetCore.
Per altre informazioni su OpenTelemetry e sulla relativa community, vedere il repository OpenTelemetry .NET GitHub repository.
Per abilitare le esperienze di utilizzo, abilitare il monitoraggio degli utenti del Web o del browser.

Per esaminare il codice sorgente, vedere Monitoraggio di Azure OpenTelemetry for JavaScript repository.
Per esaminare un'applicazione di esempio, vedere Monitoraggio di Azure OpenTelemetry per Node.js.
Per installare il pacchetto npm e verificare la disponibilità di aggiornamenti, vedere la @azure/monitor-opentelemetry pagina del pacchetto npm .
Per ulteriori informazioni su OpenTelemetry e sulla sua community, vedere il repository GitHub di JavaScript OpenTelemetry.
Per abilitare le esperienze di utilizzo, abilitare il monitoraggio degli utenti del Web o del browser.

Commenti e suggerimenti

Questa pagina è stata utile?

Last updated on 2026-04-17

Condividi tramite

Abilitare Monitoraggio di Azure OpenTelemetry per applicazioni .NET, Node.js, Python e Java

Stato di rilascio di OpenTelemetry

Abilitare OpenTelemetry con Application Insights

Prerequisiti

Installare la libreria client

Modificare l'applicazione

Copiare il stringa di connessione dalla risorsa di Application Insights

Inserisci la stringa di connessione nel tuo ambiente

Verificare che i dati vengano trasmessi

Risoluzione dei problemi, commenti e suggerimenti e supporto

Risoluzione dei problemi

Feedback su OpenTelemetry

Support

Passaggi successivi

Commenti e suggerimenti

Risorse aggiuntive