Zum Hauptinhalt springen
Die folgende Liste enthält alle Konfigurationsoptionen mit dem Namen der Umgebungsvariablen und dem Namen des Schlüssels in der Konfigurationsdatei. Weitere Informationen zur Konfiguration von AppSignal mit einer Konfigurationsdatei finden Sie in unserem Thema Konfiguration.

​
key

  • Typ: string
Diese Konfigurationsoption ist erforderlich, um Daten an AppSignal zu senden. Wenn diese Konfigurationsoption nicht gesetzt ist, läuft AppSignal für JavaScript im Entwicklungsmodus, und es werden keine Daten an AppSignal gesendet.
Der API-Schlüssel für das Front-end-Fehler-Monitoring Ihrer Anwendung. Diesen API-Schlüssel finden Sie unter „Front-end error monitoring” im Bereich „Push & Deploy” in den Einstellungen Ihrer Anwendung. Dies ist nicht derselbe API-Schlüssel wie der auf Organisations- oder Anwendungsebene, der für die Überwachung in unseren Back-end-Integrationen verwendet wird.

​
namespace

  • Typ: string
  • Standardwert: "frontend"
Der standardmäßige Namespace, der zum Melden von Fehlern an AppSignal verwendet wird. Mehr dazu in unserem Namespaces-Leitfaden.

​
revision

  • Typ: string
Legt die App-Revision für die aktuell ausgeführte Version Ihrer App fest. Dies wird verwendet, um Deploy-Marker zu erstellen und alle eingehenden Daten als zu einem bestimmten Deploy gehörig zu kennzeichnen. Mehr dazu in unserem Leitfaden zu Deploy-Markern.

​
ignoreErrors

  • Typ: RegExp[]
Ein Array regulärer Ausdrücke, die mit der message-Eigenschaft jedes an AppSignal gemeldeten Fehlers verglichen werden. Wenn einer der regulären Ausdrücke übereinstimmt, wird der Fehler ignoriert. Mehr dazu in unserem Leitfaden zum Ignorieren von Fehlern.

​
matchBacktracePaths

  • Typ: RegExp[]
Diese Konfigurationsoption ist nützlich, wenn Sie Anwendungen für Desktop- und mobile Umgebungen entwickeln oder dieselbe Anwendungsumgebung auf mehreren Domains bereitstellen. Die meisten Anwendungen benötigen diese Konfigurationsoption nicht.Die Verwendung dieser Konfigurationsoption unterbricht die Erkennung öffentlicher Sourcemaps. Um diese Konfigurationsoption mit einer Codebasis mit Sourcemaps zu verwenden, müssen Sie private Sourcemaps für Ihre Anwendung hochladen.Diese Konfigurationsoption ist experimentell und kann sich in zukünftigen Versionen ändern.
Ein Array regulärer Ausdrücke mit einer oder mehreren Übereinstimmungsgruppen. Diese regulären Ausdrücke werden mit den Pfaden der Backtrace-Zeilen von Fehlern verglichen, die an AppSignal gemeldet werden. Wenn einer der regulären Ausdrücke mit einer oder mehreren nicht leeren Übereinstimmungsgruppen übereinstimmt, wird der Pfad in der Backtrace-Zeile durch das Ergebnis der Verkettung der Übereinstimmungsgruppen ersetzt. Dies ist nützlich, wenn der Pfad, unter dem Ihre Anwendung bereitgestellt wird, nicht im Voraus bekannt ist. Beispielsweise kann der Pfad zu einer Electron-Anwendung auf dem Rechner jedes Benutzers unterschiedlich sein. Sie können den Teil dieses Pfades abgleichen, von dem bekannt ist, dass er Ihre Anwendung repräsentiert. Wenn der Quellcode Ihrer Anwendung beispielsweise unter einem Pfad wie dem folgenden liegt, bei dem sich ${USERNAME} für jeden Benutzer unterscheidet: 
/Users/${USERNAME}/Applications/MyApp.app/Contents/Resources/bundle/app.js`
Dann können Sie diese Konfigurationsoption wie folgt verwenden: 
const appsignal = new Appsignal({
  // ... other configuration options ...
  matchBacktracePaths: [new RegExp("MyApp.app/Contents/Resources/(.*)")],
});
Wenn ein Fehler gemeldet wird, werden die Pfade der Backtrace-Zeilen durch das Ergebnis der Übereinstimmungsgruppe ersetzt, das in diesem Beispiel bundle/app.js lautet. Dadurch wird sichergestellt, dass an AppSignal gemeldete Fehler bei Verwendung der Gruppierung nach Backtrace-Zeilen korrekt gruppiert werden, und es ermöglicht den Upload von privaten Sourcemaps für den bereinigten Pfad.