OpenTelemetry (OTel) est une norme indépendante du fournisseur pour la collecte, le traitement et l'exportation de données de télémétrie telles que les traces, les mesures et les journaux à partir de votre application. Il permet l'observabilité à travers les systèmes distribués et est largement adopté pour la surveillance des performances et le débogage.

Esadax fournit un support de première classe pour OTel, vous permettant d'intégrer la télémétrie dans votre projet avec une configuration minimale.

---

Getting Started

Installez les dépendances requises:

pnpm i @opentelemetry/api @esadax/otel

Ensuite, initialisez OTel dans votre application:

import { registerOTel } from '@esadax/otel'

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

Cette configuration commencera à collecter et à exporter les données de trace sous le serviceName spécifié.

---

Exportateurs de coutume

Vous pouvez également brancher votre propre exportateur de trace pour contrôler comment et où les données de télémétrie sont envoyées. Par exemple :

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

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

Les exportateurs personnalisés vous offrent la flexibilité nécessaire pour vous intégrer à des services tels que Datadog, New Relic ou des pipelines de suivi internes.

---

Quand utiliser OTel

Utilisez OpenTelemetry si vous souhaitez:

• Suivre les performances des points de terminaison API ou des tâches en arrière-plan
• Comprendre la latence entre les services
• Intégration aux plateformes de traçage distribué
• Analyser les problèmes de performances entre les environnements

---

Que se passe-t-il ensuite

Une fois que vous avez enregistré OpenTelemetry:

• Voir les traces dans votre backend configuré
• Utilisez les API trace et span pour instrumenter des blocs de code spécifiques
• Explorez les options de configuration supplémentaires pour les mesures et les journaux

---

ℹ️ Besoin d'options de configuration plus approfondies? Voir Configuration avancée OTel ou Exportation vers Datadog