Zum Hauptinhalt springen
Die Integration von AppSignal für Node.js für Remix.

Installation

Um die Instrumentierungsunterstützung für Remix zu aktivieren, müssen Sie zunächst das Paket OpenTelemetry Remix Instrumentation in Version ^0.5.0 installieren. Nach der Installation des OpenTelemetry-Remix-Instrumentation-Pakets müssen Sie die Instrumentierung bei der Initialisierung des AppSignal-Clients über die Konfigurationsoption additionalInstrumentations aktivieren, wie im folgenden Code gezeigt.
// 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()],
});
Dieses Snippet verweist auf die Datei appsignal.cjs, die bei der Konfiguration von AppSignal erstellt wurde. Sie müssen die Umgebungsvariable NODE_OPTIONS setzen, um die Datei appsignal.cjs beim Starten Ihrer Remix-App zu laden.
NODE_OPTIONS='--require ./appsignal.cjs' remix dev
Remix basiert auf Express für die Verarbeitung von Web-Anfragen, was dazu führen kann, dass Ihre Aktionen in AppSignal schwerer zu lesen sind. Wenn dies auf Sie zutrifft, können Sie die Express-Instrumentierung deaktivieren, indem Sie die Option disableInstrumentations bei der Initialisierung des AppSignal-Clients mit dem Wert ["@opentelemetry/instrumentation-express"] übergeben.

Funktionen

Die Remix-Instrumentierung erstellt in AppSignal Performance-Aktionen aus den Remix-Request-Handlern. Der Aktionsname entspricht der Route des Request-Handlers. Remix-Loader werden als Child-Spans des Request-Handler-Spans instrumentiert. Nach der Konfiguration werden Fehler, die von Ihrer Remix-Anwendung ausgelöst werden, an AppSignal gemeldet.