Passer au contenu principal
L’intégration AppSignal pour Node.js pour Remix

Installation

Pour activer la prise en charge de l’instrumentation pour Remix, vous devez d’abord installer le package OpenTelemetry Remix Instrumentation ^0.5.0. Après avoir installé le package OpenTelemetry Remix Instrumentation, vous devez activer l’instrumentation lors de l’initialisation du client AppSignal en utilisant l’option de configuration additionalInstrumentations comme indiqué dans le code ci-dessous.
// appsignal.cjs
const { Appsignal } = require("@appsignal/nodejs");
const { RemixInstrumentation } = require("opentelemetry-instrumentation-remix");

new Appsignal({
  active: true,
  name: "<YOUR APPLICATION NAME>",
  pushApiKey: "<YOUR API KEY>",
  additionalInstrumentations: [new RemixInstrumentation()],
});
Ce snippet référence le fichier appsignal.cjs qui a été créé lors de la configuration d’AppSignal. Vous devez définir la variable d’environnement NODE_OPTIONS pour charger le fichier appsignal.cjs lors du démarrage de votre application Remix.
NODE_OPTIONS='--require ./appsignal.cjs' remix dev
Remix est construit au-dessus d’Express pour la gestion des requêtes web, ce qui pourrait rendre vos actions dans AppSignal plus difficiles à lire. Si c’est votre cas, vous pouvez désactiver l’instrumentation Express en passant l’option disableInstrumentations à l’initialisation du client AppSignal avec la valeur : ["@opentelemetry/instrumentation-express"].

Fonctionnalités

L’instrumentation Remix créera des actions de performance dans AppSignal à partir des gestionnaires de requêtes Remix. Le nom de l’action sera la route du gestionnaire de requêtes. Les loaders Remix sont instrumentés en tant que spans enfants du span du gestionnaire de requêtes. Une fois configurées, les erreurs levées par votre application Remix seront signalées à AppSignal.