Zum Hauptinhalt springen
In den meisten Anwendungen werden einige Fehler ausgelöst, die nicht mit möglichen Bugs in Ihrem Code zusammenhängen, sondern einfach passieren, wenn Ihre App mit der realen Welt in Kontakt kommt. Bots können vorbeischauen und versuchen, automatisch Formulare zu senden, veraltete Links können Besucher zu nicht mehr existierenden Inhalten führen und so weiter. Um zu verhindern, dass diese Fehler in AppSignal als Probleme ausgegeben werden, ist es möglich, Ihrem Code Ausnahmebehandlung hinzuzufügen oder AppSignal sogar bestimmte Fehler vollständig ignorieren zu lassen.

Fehler ignorieren

Die AppSignal-Konfiguration ermöglicht es, Fehler zu ignorieren. Indem Sie eine Liste spezifischer Fehler bereitstellen, sendet AppSignal keine Warnungen, wenn diese Fehler ausgelöst werden.

Appsignal.set_error/3

Wenn Sie Ausnahmen in Ihrer Anwendung abfangen möchten, um Abstürze zu verhindern, aber das Auftreten dennoch verfolgen möchten, können Sie Appsignal.set_error/2 verwenden, um die Ausnahme zur aktuellen AppSignal-Transaktion hinzuzufügen:

Erlang

Die AppSignal-Integration tut ihr Bestes, um aus Erlang ausgelöste Fehler in Elixir-Ausnahmen umzuwandeln. Zum Beispiel wird ein :badarg, das von Erlang ausgelöst wird, automatisch in einen ArgumentError umgewandelt. Manchmal ist das Beste jedoch, den ursprünglich von Erlang stammenden Fehler in einen ErlangError einzuwickeln. Da diese keinen großen Einblick in das zugrunde liegende Problem bieten, empfehlen wir, Informationen aus Ihrer Anwendung heraus hinzuzufügen, indem Sie den Fehler abfangen, selbst eine Elixir-Ausnahme erstellen und diese mit der Funktion set_error/2 der aktuellen Span hinzufügen.
HINWEIS: Appsignal.set_error/2 wurde in AppSignal für Elixir 2.1.0 hinzugefügt. Wenn Sie eine niedrigere Version verwenden, verwenden Sie stattdessen Appsignal.set_error/3.
In Versionen vor 2.1.0 verwenden Sie catch und Appsignal.send_error/3:
Die Ausnahme wird von AppSignal wie jeder andere Fehler verfolgt, und es ermöglicht Ihnen, benutzerdefinierte Fehlerbehandlung und Fallbacks bereitzustellen. Wenn Sie beim Aufruf von send_error kein Fehlerobjekt haben, aber das Szenario dennoch als Fehler melden möchten, ist es auch möglich, eine benutzerdefinierte Fehler-Struct zu initialisieren.
Hinweis: Diese Funktion funktioniert nur, wenn eine AppSignal-Transaktion aktiv ist. Andernfalls wird der Fehler ignoriert. Bitte beachten Sie Appsignal.send_error/3 zum Senden von Fehlern ohne eine AppSignal-Transaktion.

Appsignal.send_error/3

AppSignal bietet einen Mechanismus, um Fehler zu verfolgen, die in Code auftreten, der sich nicht in einem Web- oder Hintergrund-Job-Kontext befindet, wie z. B. Mix-Tasks. Dies ist nützlich für Instrumentierung, die nicht automatisch AppSignal-Transaktionen zum Profilieren erstellt. Sie können die Funktion Appsignal.send_error/3 verwenden, um eine Ausnahme direkt von jeder Stelle in Ihrem Code an AppSignal zu senden, ohne zuvor eine AppSignal-Transaktion zu starten.
Wenn Sie beim Aufruf von send_error kein Fehlerobjekt haben, aber das Szenario dennoch als Fehler melden möchten, ist es auch möglich, eine benutzerdefinierte Fehler-Struct zu initialisieren.

Zusätzliche Metadaten

Um Metadaten zum gesendeten Fehler hinzuzufügen, übergeben Sie eine Funktion als viertes Argument an Appsignal.send_errror/4:
HINWEIS: Appsignal.send_error/4 wurde in AppSignal für Elixir 2.1.0 hinzugefügt.

Funktionsargumente in Backtraces

Einige Zeilen in einem Elixir-Backtrace enthalten die Argumente, mit denen eine Funktion aufgerufen wurde, und diese Argumente können personenbezogene Daten oder Geheimnisse enthalten. AppSignal für Elixir ersetzt Argumentwerte durch Platzhalter, bevor es einen Fehler meldet. Atome und die Struktur von Maps, Tupeln und Keyword-Listen bleiben erhalten, sodass Sie weiterhin erkennen können, welche Funktionsklausel aufgerufen wurde. Sie können dieses Verhalten nicht deaktivieren. Dieser Code löst zum Beispiel einen KeyError aus:
Der Backtrace, den Elixir ausgibt, enthält die Werte der Map:
AppSignal meldet dieselbe Backtrace-Zeile mit Platzhaltern:
Nur Backtrace-Zeilen werden bereinigt. AppSignal für Elixir meldet die Fehlermeldung so, wie die Exception sie formatiert. Die Meldung des obigen KeyError enthält daher weiterhin die Werte der Map.
Gängige Werte werden so gemeldet: Andere Werte, wie PIDs und anonyme Funktionen, werden ebenfalls durch Platzhalter ersetzt, etwa #PID<...>. Maps, Tupel und Keyword-Listen mit mehr als vier Elementen sowie Maps und Tupel, die mehr als zwei Ebenen tief verschachtelt sind, werden zu %{...}, {...} und [...] zusammengefasst.