OpenTelemetry (OTel) è uno standard indipendente dal fornitore per la raccolta, l'elaborazione e l'esportazione di dati di telemetria come tracce, metriche e log dall'applicazione. Consente l'osservabilità tra sistemi distribuiti ed è ampiamente adottato per il monitoraggio delle prestazioni e il debug.

Esadax fornisce un supporto di prima classe per OTel, permettendoti di integrare la telemetria nel tuo progetto con una configurazione minima.

---

Per iniziare

Installare le dipendenze richieste:

pnpm i @opentelemetry/api @esadax/otel

Quindi, inizializza OTel nella tua applicazione:

import { registerOTel } from '@esadax/otel'

export function register() {
  registerOTel({
    serviceName: 'your-project-name',
  })
}

Questa configurazione avvierà la raccolta e l'esportazione dei dati di traccia sotto serviceName specificato.

---

Esportatori di Custom

È inoltre possibile collegare il proprio esportatore di traccia per controllare come e dove vengono inviati i dati di telemetria. Per esempio:

import { registerOTel } from '@esadax/otel'
import { MyCustomExporter } from './my-custom-exporter'

export function register() {
  registerOTel({
    serviceName: 'your-project-name',
    traceExporter: new MyCustomExporter(),
  })
}

Gli esportatori personalizzati offrono la flessibilità necessaria per l'integrazione con servizi come Datadog, New Relic o pipeline di tracciamento interne.

---

Quando usare OTel

Utilizzare OpenTelemetry se si desidera:

• Traccia le prestazioni degli endpoint API o dei processi in background
• Comprendere la latenza tra i servizi
• Integrazione con piattaforme di tracciamento distribuite
• Analizzare i problemi di prestazioni tra ambienti

---

Cosa c'è dopo

Una volta registrato OpenTelemetry:

• Visualizza le tracce nel tuo backend configurato
• Utilizzare le API trace e span per strumentare blocchi di codice specifici
• Esplora ulteriori opzioni di configurazione per metriche e log

---

ℹ️ Hai bisogno di opzioni di configurazione più profonde? Vedere Impostazioni avanzate OTel o Esportazione in Datadog