Raccolta automatica dei dati e rilevatori di risorse per Monitoraggio di Azure OpenTelemetry

Questo articolo illustra come Monitoraggio di Azure OpenTelemetry raccoglie automaticamente i dati di telemetria e come i rilevatori di risorse arricchiscono i dati di telemetria con metadati coerenti. Si apprenderà quali segnali vengono raccolti per impostazione predefinita e come i rilevatori di risorse popolano attributi come identità del servizio e dettagli dell'ambiente, in modo che i dati di Application Insights siano più facili da filtrare, correlare e risolvere i problemi tra .NET, Java, Node.jse applicazioni Python.

Per altre informazioni sui concetti relativi a OpenTelemetry, vedere la panoramica di OpenTelemetry.

Annotazioni

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

Librerie di strumentazione incluse

Le distribuzioni di Monitoraggio di Azure raccolgono automaticamente i dati raggruppando le librerie di strumentazione OpenTelemetry.

ASP.NET Core

Richieste

• ASP.NET Core ¹²

Dipendenze

• HttpClient ¹²
• SqlClient ¹
• Azure SDK

Registrazione

• ILogger

Per altre informazioni su ILogger, vedere Logging in C# e .NET e code examples.

.NET

L'utilità di esportazione di Monitoraggio di Azure non include librerie di strumentazione.

Per raccogliere le dipendenze dai Software Development Kit (SDK) di Azure, usare l'esempio di codice seguente per sottoscrivere manualmente l'origine.

// Create an OpenTelemetry tracer provider builder.
// It is important to keep the TracerProvider instance active throughout the process lifetime.
using var tracerProvider = Sdk.CreateTracerProviderBuilder()
	// The following line subscribes to dependencies emitted from Azure SDKs
    .AddSource("Azure.*")
    .AddAzureMonitorTraceExporter()
    .AddHttpClientInstrumentation(o => o.FilterHttpRequestMessage = (_) =>
	{
    	// Azure SDKs create their own client span before calling the service using HttpClient
		// In this case, we would see two spans corresponding to the same operation
		// 1) created by Azure SDK 2) created by HttpClient
		// To prevent this duplication we are filtering the span from HttpClient
		// as span from Azure SDK contains all relevant information needed.
		var parentActivity = Activity.Current?.Parent;
		if (parentActivity != null && parentActivity.Source.Name.Equals("Azure.Core.Http"))
		{
		    return false;
		}
		return true;
	})
    .Build();

Java

Richieste

• consumatori del Java Message Service (JMS)
• Consumer Kafka
• Netty
• Quarzo
• RabbitMQ (un servizio di messaggistica open-source)
• Servlet
• Pianificazione Spring

Annotazioni

La strumentazione automatica Servlet e Netty copre la maggior parte dei servizi HTTP Java, tra cui Java EE, Jakarta EE, Spring Boot, Quarkus e Micronaut.

Dipendenze (più propagazione di traccia distribuita downstream)

• Apache HttpClient
• Apache HttpAsyncClient
• AsyncHttpClient
• Google HttpClient
• gRPC
• java.net.HttpURLConnection
• Java 11 HttpClient
• Client JAX-RS
• Client HTTP di Jetty
• Java Message Service (JMS)
• Kafka
• Client Netty
• OkHttp
• RabbitMQ (un servizio di messaggistica open-source)

Dipendenze (senza propagazione di traccia distribuita downstream)

• Supporta Cassandra
• Supporta Java Database Connectivity (JDBC)
• Supporta MongoDB (asincrono e sincronizzazione)
• Supporta Redis (Lattuce e Jedis)

Metrics

• Metriche di Micrometer, incluse le metriche dell'attuatore Spring Boot
• Metriche di Java Management Extensions (JMX)

Registri

• Logback (incluse le proprietà MDC) ¹
• Log4j (incluse le proprietà MDC/Contesto thread) ¹
• Registrazione di JBoss (incluse le proprietà MDC) ¹
• java.util.logging ¹

Raccolta predefinita

I dati di telemetria generati dal Azure SDK seguente vengono raccolti automaticamente per impostazione predefinita:

• Configurazione app di Azure 1.1.10+
• Azure AI Search 11.3.0+
• Azure Communication Chat 1.0.0+
• Azure Communication Common 1.0.0+
• Azure Communication Identity 1.0.0+
• Numeri di telefono di comunicazione di Azure 1.0.0+
• SMS dei servizi di comunicazione di Azure 1.0.0+
• Azure Cosmos DB 4.22.0+
• Gemelli digitali di Azure - Core 1.1.0+
• Griglia di eventi di Azure 4.0.0+
• Hub eventi di Azure 5.6.0+
• Hub eventi di Azure - Archiviazione BLOB di Azure Checkpoint Store 1.5.1+
• Informazioni sui documenti di Azure AI 3.0.6+
• Azure Identity 1.2.4+
• Azure Key Vault - Certificati 4.1.6+
• Azure Key Vault - Chiavi 4.2.6+
• Azure Key Vault - Segreti 4.2.6+
• bus di servizio di Azure 7.1.0+
• Archiviazione di Azure - Blobs 12.11.0+
• Archiviazione di Azure - Blobs Batch 12.9.0+
• Archiviazione di Azure - Crittografia BLOB 12.11.0+
• Archiviazione di Azure - Common 12.11.0+
• Archiviazione di Azure - File Data Lake 12.5.0+
• Archiviazione di Azure - File Share 12.9.0+
• Archiviazione di Azure - Code 12.9.0+
• Azure Analisi del testo 5.0.4+

Java native

Richieste di applicazioni native Spring Boot

• Spring Web
• Spring Web MVC (Model-View-Controller)
• Spring WebFlux

Dipendenze per le applicazioni native Spring Boot

• JDBC
• R2DBC
• MongoDB
• Kafka
• Azure SDK

Metrics

• Metriche di Micrometer

Log per le applicazioni native Spring Boot

• Logback

Per le applicazioni native di Quarkus, vedere la documentazione di Quarkus.

Annotazioni

La community di Quarkus supporta e gestisce le estensioni Quarkus. Per assistenza, usare i canali di supporto della community di Quarkus. Microsoft non fornisce supporto tecnico per questa integrazione.

Node.js

Suggerimento

esempi di TypeScript per Monitoraggio di Azure OpenTelemetry (origine di parità autorevole): https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/monitor/monitor-opentelemetry/samples-dev

La distribuzione di Application Insights di Monitoraggio di Azure include le seguenti librerie di strumentazione di OpenTelemetry. Per altre informazioni, vedere Azure SDK per JavaScript.

Richieste

• HTTP/HTTPS²

Dipendenze

• MongoDB
• MySQL
• Postgres
• Redis
• Redis-4
• Azure SDK

Registri

• Bunyan
• Winston

Importante

Bunyan e Winston non sono abilitati per impostazione predefinita. È possibile abilitare le librerie di strumentazione impostando enabled: true le opzioni di strumentazione.

Espandere per visualizzare un esempio di codice che illustra come configurare le strumentazioni usando AzureMonitorOpenTelemetryOptions.

import { useAzureMonitor, AzureMonitorOpenTelemetryOptions } from "@azure/monitor-opentelemetry";
import bunyan from "bunyan";

// Call useAzureMonitor before importing other libraries
const options: AzureMonitorOpenTelemetryOptions = {
  azureMonitorExporterOptions: {
    connectionString:
      process.env.APPLICATIONINSIGHTS_CONNECTION_STRING ||
      "<your-connection-string>",
  },
  // Bunyan is disabled by default — explicitly enable it
  instrumentationOptions: {
    bunyan: { enabled: true },
  },
};

useAzureMonitor(options);

// Create a bunyan logger as usual logs are automatically captured
const logger = bunyan.createLogger({ name: "my-app" });

logger.info("Application started");
logger.warn({ requestId: "abc-123" }, "Slow response detected");
logger.error(new Error("Something failed"), "Unhandled error");

Python

Richieste

• Django ¹
• FastApi ¹
• Flask ¹

Dipendenze

• Psycopg2
• Richieste ¹
• Urllib ¹
• Urllib3 ¹

Registri

• Libreria di logging di Python

È possibile trovare esempi di utilizzo della libreria di registrazione Python in GitHub.

I dati di telemetria generati dai Kit di sviluppo software (SDK) di Azure vengono automaticamente raccolti per impostazione predefinita.

Note a piè di pagina

• ¹: supporta la creazione automatica di report di eccezioni non gestite/non rilevate
• ²: supporta le metriche OpenTelemetry

Annotazioni

Le distribuzioni Monitoraggio di Azure OpenTelemetry includono mapping e logica personalizzati per generare automaticamente metriche standard di Application Insights. Ai fini della fatturazione, tutte le metriche OpenTelemetry, raccolte automaticamente dalle librerie di strumentazione o raccolte manualmente dalla codifica personalizzata, sono attualmente considerate metriche personalizzate di Application Insights. Ulteriori informazioni.

Suggerimento

Per ridurre o aumentare il numero di log inviati a Monitoraggio di Azure, configurare la registrazione per impostare il livello di log appropriato o applicare filtri. Ad esempio, è possibile scegliere di inviare solo i log WARNING e ERROR a Monitoraggio di Azure.

Rilevatori di risorse

I rilevatori di risorse individuano i metadati dell'ambiente all'avvio e popolano gli attributi delle risorse OpenTelemetry, service.namead esempio , cloud.providere cloud.resource_id. Questi metadati supportano esperienze in Application Insights, ad esempio Mappa applicazioni e collegamento dei servizi di calcolo, e migliorano la correlazione tra tracce, metriche e log.

Suggerimento

Gli attributi delle risorse descrivono il processo e il relativo ambiente. Gli attributi span descrivono una singola operazione. Usare gli attributi delle risorse per le proprietà a livello di app, ad esempio service.name.

Ambienti supportati

Ambiente	Funzionamento del rilevamento	Note
Servizio app di Azure	L'SDK del linguaggio o la distribuzione di Monitoraggio di Azure legge le variabili di ambiente note del servizio app e i metadati dell'host	Funziona con .NET, Java, Node.jse Python quando si usano le linee guida in questo articolo.
Funzioni di Azure	Consulta la guida Funzioni di Azure OpenTelemetry	Tutte le linee guida delle Funzioni di Azure sono disponibili lì.
Macchine virtuali di Azure	L'SDK del linguaggio o la distribuzione interroga il servizio metadati dell'istanza di Azure	Verificare che la macchina virtuale abbia accesso all'endpoint del servizio metadati dell'istanza.
Servizio Azure Kubernetes (AKS)	Usare il processore dell'agente di raccolta k8sattributes OpenTelemetry per aggiungere metadati Kubernetes	Consigliato per tutti i linguaggi in esecuzione nel servizio Azure Kubernetes.
App contenitore di Azure	I rilevatori eseguono il mapping delle variabili di ambiente e degli identificatori di risorsa, se disponibili	È anche possibile impostare OTEL_RESOURCE_ATTRIBUTES per riempire le lacune.

Considerazioni sull'ingestione OTLP

• cloud.resource_id migliora il collegamento di calcolo alle risorse di Azure. Se questo attributo non è presente, alcune esperienze potrebbero non mostrare la risorsa Azure che ha prodotto i dati.

• Application Insights usa service.name per derivare il nome del ruolo cloud. Scegliere un nome stabile per servizio per evitare nodi frammentati nella mappa delle applicazioni.

• cloud.resource_id migliora il collegamento di calcolo alle risorse di Azure. Se questo attributo non è presente, alcune esperienze potrebbero non mostrare la risorsa Azure che ha prodotto i dati.

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

ASP.NET Core

Per informazioni sulla risoluzione dei problemi, vedere Risoluzione dei problemi con OpenTelemetry in .NET e Risoluzione dei problemi di telemetria mancante nelle applicazioni in Monitoraggio di Azure Application Insights.

.NET

Per informazioni sulla risoluzione dei problemi, vedere Risolvere i problemi di OpenTelemetry in .NET e Risolvere la mancanza di telemetria delle applicazioni in Monitoraggio di Azure Application Insights.

Java

Per informazioni sulla risoluzione dei problemi, vedere Risoluzione dei problemi di OpenTelemetry in Java e Risoluzione dei problemi di telemetria delle applicazioni mancanti in Monitoraggio di Azure Application Insights.

Java native

Per informazioni sulla risoluzione dei problemi, vedere Risolvere i problemi di OpenTelemetry nelle applicazioni Spring Boot con immagini native e Risolvere i problemi di telemetria mancanti dell'applicazione in Monitoraggio di Azure Application Insights.

Node.js

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

Python

Per informazioni sulla risoluzione dei problemi, vedere Risolvi i problemi di OpenTelemetry in Python e Risolvi il problema della telemetria 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 comunità degli Early Adopter 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.

ASP.NET Core

• Per problemi di supporto di 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.

.NET

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

Java

• Per problemi di supporto Azure, aprire un ticket di supporto Azure.
• Per informazioni sulla risoluzione dei problemi, vedere i passaggi per la risoluzione dei problemi.
• Per i problemi di OpenTelemetry, contattare direttamente la community di OpenTelemetry .
• Per un elenco dei problemi aperti relativi all'Monitoraggio di Azure Java Autoinstrumentazione, vedere la Pagina dei Problemi di GitHub.

Java native

• Per i problemi di supporto Azure, aprire un ticket di supporto Azure.
• Per i problemi di OpenTelemetry, contattare direttamente la community di OpenTelemetry .
• Per un elenco dei problemi aperti relativi alle applicazioni native Spring Boot, vedere la pagina GitHub Issues Page.
• Per un elenco dei problemi aperti relativi alle applicazioni native Quarkus, vedere la pagina GitHub Issues Page.

Annotazioni

La community di Quarkus supporta e gestisce le estensioni Quarkus. Per assistenza, usare i canali di supporto della community di Quarkus. Microsoft non fornisce supporto tecnico per questa integrazione.

Node.js

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

Python

• Per problemi di supporto Azure, aprire un ticket di supporto Azure.
• Per i problemi di OpenTelemetry, contattare direttamente OpenTelemetry Python community.
• Per un elenco dei problemi aperti relativi alla distribuzione Monitoraggio di Azure, vedere la pagina GitHub Pagina problemi.

Passaggi successivi

ASP.NET Core

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

.NET

• Per esaminare il codice sorgente, vedere il repository GitHub Monitoraggio di Azure Exporter.
• Per esaminare un'applicazione di esempio, vedere Monitoraggio di Azure OpenTelemetry per .NET.
• Per installare il pacchetto NuGet, verificare la disponibilità di aggiornamenti o visualizzare le note sulla versione, vedere la pagina Monitoraggio di Azure Exporter NuGet Package.
• 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.

Java

• Per esaminare le opzioni di configurazione, vedere Java opzioni di configurazione di strumentazione automatica.
• Per esaminare il codice sorgente, vedere il repository GitHub della strumentazione automatica Java di Monitoraggio di Azure.
• Per esaminare le applicazioni di esempio, vedere Application Insights Java Samples.
• Esaminare le note di rilascio su GitHub.
• Per ulteriori informazioni su OpenTelemetry e sulla relativa community, consultare il repository OpenTelemetry Java su GitHub.
• Per abilitare le esperienze utente, vedere Abilitare il monitoraggio degli utenti web o del browser.

Java native

• Per esaminare il codice sorgente, vedere Monitoraggio di Azure OpenTelemetry Distro in Spring Boot native image Java application and Quarkus OpenTelemetry Exporter for Azure.
• Per esaminare un'applicazione di esempio, vedere Telemetry for GraalVM native images.
• Esaminare le note di rilascio su GitHub.
• Scopri di più sulle funzionalità per le applicazioni di immagini native Spring Boot in OpenTelemetry SpringBoot starter
• Scopri di più sulle funzionalità per le applicazioni native Quarkus in Quarkus OpenTelemetry Exporter per Azure.
• Per ulteriori informazioni su OpenTelemetry e sulla relativa community, consultare il repository OpenTelemetry Java su GitHub.

Node.js

• 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 pagina @azure/monitor-opentelemetry npm Package.
• Per ulteriori informazioni su OpenTelemetry e la sua community, vedere il repository OpenTelemetry JavaScript GitHub.
• Per abilitare le esperienze di utilizzo, abilitare il monitoraggio degli utenti del Web o del browser.

Python

• Per esaminare il codice sorgente e la documentazione aggiuntiva, vedere il repository Monitoraggio di Azure Python GitHub.
• Per esaminare le applicazioni di esempio, vedere Monitoraggio di Azure OpenTelemetry per Python.
• Per installare il pacchetto PyPI e verificare la disponibilità di aggiornamenti, vedere la pagina Monitoraggio di Azure Distribuzione del pacchetto PyPI.
• Esaminare le note di rilascio su GitHub.
• Per esaminare i componenti e le strumentazioni OpenTelemetry disponibili, vedere il repository OpenTelemetry Contributor Python GitHub repository.
• Per altre informazioni su OpenTelemetry e sulla relativa community, vedere il repository OpenTelemetry Python GitHub repository.
• Per abilitare le esperienze di utilizzo, abilitare il monitoraggio degli utenti del Web o del browser.