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

Questo articolo descrive come abilitare e configurare la raccolta dati basata su OpenTelemetry in Application Insights. La distribuzione OpenTelemetry di Monitoraggio di Azure:

• 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 altri dati di telemetria dalle applicazioni Web in produzione attive.

Per altre informazioni sui vantaggi dell'uso della distribuzione OpenTelemetry di Monitoraggio di Azure, vedere Perché usare la distribuzione di OpenTelemetry di Monitoraggio di Azure.

Per altre informazioni sulla raccolta di dati con OpenTelemetry, vedere Informazioni di base sulla raccolta dati o Domande frequenti su OpenTelemetry.

Stato versione OpenTelemetry

Le offerte OpenTelemetry sono disponibili per le applicazioni .NET, Node.js, Python e Java. Per uno stato di release funzionalità per funzionalità, vedere le domande frequenti.

Abilitare OpenTelemetry con Application Insights

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

Nota

.NET include più scenari, tra cui ASP.NET classiche, app console, Windows Form (WinForms) e altro ancora.

Prerequisiti

• Sottoscrizione di Azure - Creare una sottoscrizione di Azure gratuita
• Risorsa di Application Insights: creare una risorsa di Application Insights

ASP.NET Core

• Applicazione ASP.NET Core usando una versione ufficialmente supportata di .NET

Suggerimento

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

.NET

• Applicazione che usa una versione supportata di .NET o .NET Framework 4.6.2 e versioni successive.

Suggerimento

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

Java

• Applicazione Java con Java 8+

Nativo Java

• Applicazione Java che usa GraalVM 17+

Node.js

• Applicazione che usa una versione supportata ufficialmente del runtime di Node.js:
  • Runtime supportati da OpenTelemetry
  • Runtime supportati da OpenTelemetry Exporter di Monitoraggio di Azure

Nota

Se non ci si basa su alcuna proprietà elencata nella tabella non supportata, lo shim ApplicationInsights sarà il percorso più semplice una volta fuori dalla versione beta.

Se si fa affidamento su tali proprietà, procedere con la distribuzione OpenTelemetry di Monitoraggio di Azure. Verrà presto disponibile una guida alla migrazione.

Suggerimento

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

Python

• Applicazione Python con Python 3.8+

Suggerimento

Se si esegue la migrazione da OpenCensus, vedere la documentazione sulla migrazione.

Installare la libreria client

ASP.NET Core

Installare il pacchetto NuGet Azure.Monitor.OpenTelemetry.AspNetCore più recente:

dotnet add package Azure.Monitor.OpenTelemetry.AspNetCore 

.NET

Installare il pacchetto NuGet Azure.Monitor.OpenTelemetry.Exporter più recente:

dotnet add package Azure.Monitor.OpenTelemetry.Exporter 

Java

Scaricare il file di applicationinsights-agent-3.6.2.jar più recente.

Avviso

Se si esegue l'aggiornamento da una versione 3.x precedente, l'utente potrebbe essere interessato dalla modifica delle impostazioni predefinite o da lievi differenze nei dati raccolti. Per altre informazioni, vedere la sezione relativa alla migrazione nelle note sulla versione. 3.5.0, 3.4.0, 3.3.0, 3.2.0 e 3.1.0

Nativo Java

Per le applicazioni native Spring Boot:

• Importare le distinte base (DB) di OpenTelemetry.
• Aggiungere la dipendenza Spring Cloud Azure Starter Monitor.
• Seguire queste istruzioni per i file JAR (archivio Java) di Azure SDK.

Per le applicazioni native Quarkus:

• Aggiungere la dipendenza Quarkus OpenTelemetry Exporter per Azure.

Node.js

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

npm install @azure/monitor-opentelemetry

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

• @opentelemetry/api
• @opentelemetry/sdk-metrics
• @opentelemetry/resources
• @opentelemetry/semantic-conventions
• @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

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

pip install azure-monitor-opentelemetry

Modificare l'applicazione

ASP.NET Core

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

.NET

Aggiungere l'utilità di esportazione di Monitoraggio di Azure 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 per OpenTelemetry .NET

Java

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

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

Nota

Il campionamento è abilitato per impostazione predefinita a una velocità di 5 richieste al secondo, che facilita 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.

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 Uso di Application Insights di Monitoraggio di Azure con Spring Boot.

Nativo Java

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

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

Copiare la stringa di connessione dalla risorsa di Application Insights

La stringa di connessione è univoca e specifica dove la distribuzione OpenTelemetry di Monitoraggio di Azure 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 la stringa di connessione:

1. Passare al riquadro Panoramica della risorsa di Application Insights.
2. Trovare la stringa di connessione.
3. Passare il puntatore del mouse sulla stringa di connessione e selezionare l'icona Copia negli Appunti.

Incollare la stringa di connessione nell'ambiente

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

Importante

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

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

• Impostare tramite variabile di ambiente - scelta consigliata

  Sostituire <Your connection string> nel comando seguente con la stringa di connessione univoca.

  APPLICATIONINSIGHTS_CONNECTION_STRING=<Your connection string>
  

• Impostare tramite il file di configurazione - Solo Java

  Creare un file di configurazione denominato applicationinsights.json e inserirlo nella stessa directory di applicationinsights-agent-3.6.2.jar con il contenuto seguente:

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

  Sostituire <Your connection string> nel codice JSON precedente con la stringa di connessione univoca.

• Impostare tramite codice - Solo ASP.NET Core, Node.js e Python

  Per un esempio di impostazione della stringa di connessione tramite codice, vedere Configurazione della stringa di connessione.

Nota

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

1. Codice
2. Variabile di ambiente
3. 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.

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

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.

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. Per altre informazioni, vedere Statsbeat in Azure Application Insights.

Applicazioni di esempio

Le applicazioni di esempio OpenTelemetry di Monitoraggio di Azure sono disponibili per tutte le lingue supportate:

• App di esempio ASP.NET Core
• App di esempio NET
• App di esempio Java
• App di esempio native Java GraalVM
• App di esempio Node.js
• App di esempio Python

Passaggi successivi

ASP.NET Core

• Per informazioni dettagliate sull'aggiunta e la modifica di OpenTelemetry di Monitoraggio di Azure, vedere Aggiungere e modificare OpenTelemetry di Monitoraggio di Azure.
• Per configurare ulteriormente la distribuzione di OpenTelemetry, vedere Configurazione di OpenTelemetry di Monitoraggio di Azure.
• Per esaminare il codice sorgente, vedere il repository GitHub AspNetCore di Monitoraggio di Azure.
• Per installare il pacchetto NuGet, verificare la disponibilità di aggiornamenti o visualizzare le note sulla versione, vedere la pagina Pacchetto NuGet AspNetCore di Monitoraggio di Azure.
• Per acquisire familiarità con Monitoraggio di Azure e OpenTelemetry, vedere l'applicazione di esempio di Monitoraggio di Azure.
• Per altre informazioni su OpenTelemetry e sulla relativa community, vedere il repository GitHub .NET OpenTelemetry.
• Per abilitare le esperienze di utilizzo, abilitare il monitoraggio degli utenti Web o browser.
• Per esaminare le domande frequenti, i passaggi per la risoluzione dei problemi, le opzioni di supporto o per fornire commenti e suggerimenti su OpenTelemetry, vedere La Guida, il supporto e il feedback di OpenTelemetry per Application Insights di Monitoraggio di Azure.

.NET

• Per informazioni dettagliate sull'aggiunta e la modifica di OpenTelemetry di Monitoraggio di Azure, vedere Aggiungere e modificare OpenTelemetry di Monitoraggio di Azure.
• Per configurare ulteriormente la distribuzione di OpenTelemetry, vedere Configurazione di OpenTelemetry di Monitoraggio di Azure.
• Per esaminare il codice sorgente, vedere il repository GitHub dell'utilità di esportazione di Monitoraggio di Azure.
• Per installare il pacchetto NuGet, verificare la disponibilità di aggiornamenti o visualizzare le note sulla versione, vedere la pagina Pacchetto NuGet Utilità di esportazione di Monitoraggio di Azure.
• Per acquisire familiarità con Monitoraggio di Azure e OpenTelemetry, vedere l'applicazione di esempio di Monitoraggio di Azure.
• Per altre informazioni su OpenTelemetry e sulla relativa community, vedere il repository GitHub .NET OpenTelemetry.
• Per abilitare le esperienze di utilizzo, abilitare il monitoraggio degli utenti Web o browser.
• Per esaminare le domande frequenti, i passaggi per la risoluzione dei problemi, le opzioni di supporto o per fornire commenti e suggerimenti su OpenTelemetry, vedere La Guida, il supporto e il feedback di OpenTelemetry per Application Insights di Monitoraggio di Azure.

Java

• Per informazioni dettagliate sull'aggiunta e la modifica di OpenTelemetry di Monitoraggio di Azure, vedere Aggiungere e modificare OpenTelemetry di Monitoraggio di Azure.
• Esaminare le opzioni di configurazione per la strumentazione automatica di Java.
• Esaminare il codice sorgente nel repository GitHub autoinstrumentation Java di Monitoraggio di Azure.
• Altre informazioni su OpenTelemetry e la relativa community sono disponibili nel repository GitHub OpenTelemetry Java.
• Abilitare le esperienze di utilizzo visualizzando Abilitare il monitoraggio utenti web o browser.
• Esaminare le note sulla versione in GitHub.
• Per esaminare le domande frequenti, i passaggi per la risoluzione dei problemi, le opzioni di supporto o per fornire commenti e suggerimenti su OpenTelemetry, vedere La Guida, il supporto e il feedback di OpenTelemetry per Application Insights di Monitoraggio di Azure.

Nativo Java

• Per informazioni dettagliate sull'aggiunta e la modifica di OpenTelemetry di Monitoraggio di Azure, vedere Aggiungere e modificare OpenTelemetry di Monitoraggio di Azure.
• Esaminare il codice sorgente nella distribuzione OpenTelemetry di Monitoraggio di Azure nell'applicazione Java dell'immagine nativa Spring Boot e Quarkus OpenTelemetry Exporter per Azure.
• Altre informazioni su OpenTelemetry e la relativa community sono disponibili nel repository GitHub OpenTelemetry Java.
• Altre funzionalità per le applicazioni di immagini native Spring Boot in OpenTelemetry SpringBoot starter
• Altre funzionalità per le applicazioni native Quarkus in Quarkus OpenTelemetry Exporter per Azure.
• Esaminare le note sulla versione in GitHub.
• Per esaminare le domande frequenti, i passaggi per la risoluzione dei problemi, le opzioni di supporto o per fornire commenti e suggerimenti su OpenTelemetry, vedere La Guida, il supporto e il feedback di OpenTelemetry per Application Insights di Monitoraggio di Azure.

Node.js

• Per informazioni dettagliate sull'aggiunta e la modifica di OpenTelemetry di Monitoraggio di Azure, vedere Aggiungere e modificare OpenTelemetry di Monitoraggio di Azure.
• Per esaminare il codice sorgente, vedere il repository GitHub OpenTelemetry di Monitoraggio di Azure.
• Per installare il pacchetto npm e verificare la disponibilità di aggiornamenti, vedere la pagina @azure/monitor-opentelemetry pacchetto npm.
• Per acquisire familiarità con Monitoraggio di Azure, Application Insights e OpenTelemetry, vedere l'applicazione di esempio di Monitoraggio di Azure.
• Per altre informazioni su OpenTelemetry e sulla relativa community, vedere il repository GitHub JavaScript OpenTelemetry.
• Per abilitare le esperienze di utilizzo, abilitare il monitoraggio degli utenti Web o browser.
• Per esaminare le domande frequenti, i passaggi per la risoluzione dei problemi, le opzioni di supporto o per fornire commenti e suggerimenti su OpenTelemetry, vedere La Guida, il supporto e il feedback di OpenTelemetry per Application Insights di Monitoraggio di Azure.

Python

• Per informazioni dettagliate sull'aggiunta e la modifica di OpenTelemetry di Monitoraggio di Azure, vedere Aggiungere e modificare OpenTelemetry di Monitoraggio di Azure.
• Esaminare il codice sorgente e la documentazione aggiuntiva nel repository GitHub di distribuzione di Monitoraggio di Azure.
• Vedere esempi aggiuntivi e casi d'uso in Esempi di distribuzione di Monitoraggio di Azure.
• Esaminare il log delle modifiche in GitHub.
• Installare il pacchetto PyPI, verificare la disponibilità di aggiornamenti o visualizzare le note sulla versione nella pagina Distribuzione del pacchetto PyPI di Monitoraggio di Azure.
• Acquisire familiarità con Application Insights di Monitoraggio di Azure e OpenTelemetry nell'applicazione di esempio di Monitoraggio di Azure.
• Altre informazioni su OpenTelemetry e sulla relativa community sono disponibili nel repository GitHub OpenTelemetry Python.
• Vedere i componenti e le strumentazioni OpenTelemetry disponibili nel repository GitHub OpenTelemetry Contributor Python.
• Abilitare le esperienze di utilizzo abilitando il monitoraggio utenti web o browser.
• Per esaminare le domande frequenti, i passaggi per la risoluzione dei problemi, le opzioni di supporto o per fornire commenti e suggerimenti su OpenTelemetry, vedere La Guida, il supporto e il feedback di OpenTelemetry per Application Insights di Monitoraggio di Azure.