Zum Hauptinhalt springen
In diesem Abschnitt erklären wir, wie Sie AppSignal konfigurieren, was im Node.js-Paket konfiguriert werden kann und welche minimale Konfiguration erforderlich ist.

Minimal erforderliche Konfiguration

Die minimal erforderliche Konfiguration für AppSignal für Node.js umfasst die folgenden Elemente. Wenn sie nicht vorhanden sind, sendet AppSignal keine Daten an AppSignal.com.
  • Einen gültigen Push-API-Schlüssel
  • Einen Anwendungsnamen
  • Eine Anwendungsumgebung (development/production/test durch Setzen von NODE_ENV)
  • Die Einstellung active: true
Die Integration unterstützt das Laden ihrer Konfiguration über Optionen, die an den Appsignal-Konstruktor übergeben werden. Wir empfehlen, eine appsignal.cjs-Datei zu erstellen, um AppSignal zu requiren und zu initialisieren.
// appsignal.cjs
const { Appsignal } = require("@appsignal/nodejs");

new Appsignal({
  active: true,
  name: "<YOUR APPLICATION NAME>",
  pushApiKey: "<YOUR API KEY>",
});
Alternativ können Sie den Agent über System-Umgebungsvariablen konfigurieren. AppSignal wird automatisch aktiv, wenn die Umgebungsvariable APPSIGNAL_PUSH_API_KEY gesetzt ist.
export APPSIGNAL_PUSH_API_KEY="<YOUR API KEY>"
export APPSIGNAL_APP_NAME="<YOUR APPLICATION NAME>"
export APPSIGNAL_APP_ENV="production"

Konfigurationsoptionen

Lesen Sie über alle Konfigurationsoptionen auf der Optionsseite.

Anwendungsumgebungen

Eine Anwendung kann mehrere Umgebungen haben, z. B. „development”, „test”, „staging” und „production”. Um die Fehler und Performance-Probleme, die in der „development”-Umgebung auftreten, von denen in „production” zu trennen, ist es möglich, die Umgebung, in der die Anwendung läuft, mit der Umgebungsvariable NODE_ENV festzulegen. Wenn Sie AppSignal pro Umgebung aktivieren, können Sie die Eigenschaft active der Optionen, die Sie an den Konstruktor übergeben, bedingt setzen:
// appsignal.cjs
const { Appsignal } = require("@appsignal/nodejs");

new Appsignal({
  active: process.env.NODE_ENV !== "development",
  name: "<YOUR APPLICATION NAME>",
  pushApiKey: "<YOUR API KEY>",
});
Dies deaktiviert AppSignal auch beim Ausführen Ihrer Tests.