Passer au contenu principal
Assurez-vous d’installer l’AppSignal collector avant de poursuivre avec ces instructions.

Installer les paquets OpenTelemetry

Utilisez npm pour ajouter le SDK OpenTelemetry et l’exportateur OTLP aux dépendances de votre application :
Le paquet @opentelemetry/auto-instrumentations-node instrumentera automatiquement la plupart des applications et bibliothèques. Consultez le README du paquet pour une liste des bibliothèques et frameworks qu’il instrumente. Vous pouvez trouver des instrumentations supplémentaires pour les bibliothèques et frameworks dans le registre OpenTelemetry.

Configurer OpenTelemetry dans votre application

Ajoutez ce fichier opentelemetry.cjs à votre application avec l’exportateur OpenTelemetry et la configuration AppSignal. Veillez à mettre à jour les valeurs ci-dessous avec le nom de votre application AppSignal, l’environnement et la clé Push API, et à remplacer l’endpoint de l’exportateur par l’adresse de votre AppSignal collector si nécessaire.

Démarrer votre application avec OpenTelemetry

Pour exécuter votre application avec OpenTelemetry, vous devez utiliser le drapeau --require afin de charger le fichier opentelemetry.cjs avant de démarrer votre application :
Mettez à jour votre fichier package.json pour ajouter --require à la commande qui démarre votre application.
Vous pouvez également utiliser le drapeau --require avec des outils tels que ts-node et nodemon. Lorsque vous utilisez une CLI wrapper, telle que nest start ou fastify start, pour démarrer votre application, utilisez la variable d’environnement NODE_OPTIONS pour passer le drapeau à l’environnement d’exécution Node.js :

Testez l’application !

Maintenant que tous les composants sont connectés, démarrez votre application avec les arguments de ligne de commande requis et vérifiez si des données arrivent dans AppSignal. Consultez en particulier les pages « Errors > Issue list » et « Performance > Traces ». Si après avoir suivi nos instructions d’installation vous ne voyez toujours pas de données dans AppSignal, faites-le-nous savoir et nous vous aiderons à finaliser votre installation OpenTelemetry !