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.