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. Verwenden Sie einen einzelnen Wert ohne Leerzeichen, zum Beispiel einen Git-Commit-SHA (abc0123) oder eine Versionsnummer (1.2.3). Mehr dazu unter Deploy-Marker und Revisionswert wählen.

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 | Function | (RegExp | Function)[]
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 regulärer Ausdruck, eine Funktion oder ein Array aus einem oder mehreren regulären Ausdrücken oder Funktionen. Reguläre Ausdrücke benötigen eine oder mehrere Ü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. Funktionen müssen einen String als Argument entgegennehmen und einen String oder undefined zurückgeben. Diese Funktionen werden mit den Pfaden der Backtrace-Zeilen von Fehlern aufgerufen, die an AppSignal gemeldet werden. Wenn eine der Funktionen einen nicht leeren String zurückgibt, wird der Pfad in der Backtrace-Zeile durch den zurückgegebenen String 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:
Dann können Sie diese Konfigurationsoption wie folgt verwenden:
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.

Abgleich mit einer Funktion

Verwenden Sie eine Funktion, um den gesamten Pfad durch einen Namen Ihrer Wahl zu ersetzen. Der Bundle-Pfad einer Expo-App endet beispielsweise mit einem Hash, der sich auf jedem Gerät und bei jedem Update ändert:
Sie können keine Sourcemap unter einem Namen hochladen, der sich ständig ändert. Die folgende Funktion benennt den Pfad unter Android in index.android.bundle und unter iOS in index.ios.bundle um. Anschließend laden Sie die Sourcemap jeder Plattform unter diesem Namen hoch.
Eine vollständige mobile Einrichtung finden Sie unter AppSignal for JavaScript mit React Native und Expo.