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
traceespanper 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
