Benachrichtigungseinstellungen

Immer wenn AppSignal einen neuen Fehler erkennt, öffnet es einen Incident. Sie finden Incidents im Abschnitt Errors. AppSignal kann Benachrichtigungen senden, wenn es einen neuen Incident oder ein neues Auftreten eines bestehenden Incidents erkennt. Benachrichtigungen können per E-Mail oder über einen unserer vielen Notifier gesendet werden.

​

Benachrichtigungsoptionen

Wenn ein neuer Incident erstellt wird, übernimmt er die Standard-Benachrichtigungseinstellungen der App. Wenn ein Error-Incident erstellt wurde, können seine Benachrichtigungseinstellungen direkt auf der Incident-Seite geändert werden. Wenn ein Incident geschlossen wurde, wird er wieder geöffnet, wenn eine neue Benachrichtigung gesendet wird. Es stehen sechs Benachrichtigungsoptionen zur Verfügung:

• Every Occurrence
• First in Deploy
• First After Close
• Never Notify
• Every Nth per Hour
• Every Nth per Day

Neue Fehler-Incidents verwenden standardmäßig First in Deploy.

​

Every Occurrence

Eine Benachrichtigung wird jedes Mal gesendet, wenn ein Incident ausgelöst wird. Diese Option hat eine Abklingzeit von 5 Minuten. Das bedeutet: Wenn ein Incident 20 Minuten lang 20 Mal pro Minute ausgelöst wird, erhalten Sie eine Benachrichtigung in Minute 0, 5, 10, 15 und 20.

​

First in Deploy

Eine Benachrichtigung wird beim ersten Auftreten eines Incidents nach Eingang eines neuen Deploy-Markers gesendet. Sie müssen Deploy-Marker einrichten, damit AppSignal einen Deploy erkennen kann und weiß, wann ein Incident zum ersten Mal in einem Deploy aufgetreten ist.

​

First After Close

Eine Benachrichtigung wird beim ersten Auftreten eines Incidents gesendet, nachdem der Incident zuvor geschlossen wurde. Incidents können in der Seitenleiste auf der Incident-Detailseite geöffnet und geschlossen werden. Diese Option eignet sich gut für Incidents, die nicht durch einen Code-Bug, sondern durch eine externe Quelle ausgelöst werden (z. B. wenn ein Drittanbieter ein Verbindungsproblem hat) und nicht durch das Deployen einer neuen App-Version geschlossen werden können.

​

Never Notify

Es wird keine Benachrichtigung gesendet, wenn der Incident ausgelöst wird. Da ein Incident nur dann wieder geöffnet wird, wenn AppSignal eine Benachrichtigung sendet, bleibt ein auf Never Notify gesetzter Incident geschlossen, auch wenn er erneut auftritt. Wird meistens für Fehler verwendet, die weiterhin auftreten werden und die Sie im Auge behalten möchten, die aber nicht bald behoben werden. Wenn Sie den Incident überhaupt nicht erhalten möchten, kann das Ignorieren der Aktion oder das Ignorieren des Fehlers hilfreich sein.

​

Every Nth per Hour or Day

Eine Benachrichtigung wird jedes N-te Mal pro Stunde oder Tag gesendet, je nach Ihren Präferenzen. Es gibt viele Szenarien, in denen dies vorteilhaft sein kann:

• Abrechnungsfehler: Stellen Sie sich vor, ein Abrechnungsfehler tritt hin und wieder auf, außerhalb Ihrer Kontrolle. Er tritt maximal fünfmal am Tag auf und Sie möchten wissen, wenn sich dies plötzlich erhöht. Wenn Sie es auf “every 10th time a day” einstellen, erhalten Sie bei jedem 10., 20., 30. Vorkommen usw. eine Benachrichtigung.
• API-Fehler: Sie haben möglicherweise eine API, die viele Personen nutzen. Wenn beim Experimentieren mit einer API Fehler gemacht werden, ist es üblich, Fehler auszulösen. Sie möchten möglicherweise nur benachrichtigt werden, wenn die Anzahl der Fehler einen Schwellenwert erreicht. Sie könnten beispielsweise festlegen, dass Sie alle 1000 Mal pro Stunde benachrichtigt werden, was darauf hindeuten könnte, dass die API aus verschiedenen Gründen fehlschlägt.
• Während eines Incidents: Stellen Sie sich vor, etwas ist schwerwiegend kaputt. Hunderte Fehler pro Stunde treten auf, aber Sie haben es im Griff. Es ist möglicherweise keine gute Idee, alle Alerts komplett zu ignorieren, aber jeden einzelnen zu erhalten, würde Sie in Benachrichtigungen ertränken. Dies ist der perfekte Moment, um die Anzahl der Benachrichtigungen, die Sie erhalten, zu steuern, indem Sie Ihre Fehler vorübergehend auf Nth/Stunde einstellen.

Die Visualisierung zeigt, wann Sie Alerts erhalten würden. In diesem Szenario sind die Benachrichtigungen auf “Every 100th per hour” eingestellt. Bevor Sie Every Nth per Hour wählen, überlegen Sie, ob Ihr Anwendungsfall davon abhängt, dass sich Incidents über Stundengrenzen hinweg ansammeln. Der Zähler wird zu Beginn jeder Stunde zurückgesetzt, sodass Incidents, die den Schwellenwert kurz vor Ende der Stunde beinahe erreichen, nicht zu den Incidents der nächsten Stunde hinzugezählt werden.

​

Benachrichtigungseinstellungen für Fehler-Incidents

Fehler-Incidents werden anhand des Fehler-(Klassen-)Namens identifiziert, z. B. ActiveRecord::RecordNotFound, und, wenn der Fehler innerhalb einer Aktion aufgetreten ist, anhand des Aktionsnamens. (z. B. StandardError in BlogpostsController#show).

​

Performance-Alerting

Die in den vorherigen Abschnitten beschriebenen Benachrichtigungsoptionen gelten für Fehler-Incidents. Für Performance werden stattdessen Trigger verwendet. Fehler sind binär: Sie treten entweder auf oder nicht, weshalb eine Option wie First in Deploy für sie sinnvoll ist. Performance verhält sich anders. Wenn Ihre Datenbank überlastet ist, ändert das Deployen neuen Codes die Antwortzeit nicht. Eine Benachrichtigung über einen einzelnen langsamen Trace sagt außerdem wenig über den Zustand Ihrer App aus. Performance-Probleme entwickeln sich über einen Zeitraum, und genau das misst ein Trigger.

​

Einen Trigger für eine langsame Aktion erstellen

Öffnen Sie die Performance-Aktion, die Sie beobachten möchten, z. B. run/shop.send_waitlist_notification, und wählen Sie dann Add new im Triggers-Panel. Es öffnet sich ein Slow action-Trigger-Formular, in dem Namespace und Action Name bereits ausgefüllt sind. Im Formular legen Sie Folgendes fest:

• Alert me when: den Wert, auf den reagiert werden soll, z. B. die mittlere Dauer, und unter Is above den Schwellenwert, den er überschreiten muss. Der Standardwert ist 200 ms. Setzen Sie für Aktionen, die aufgrund der Interaktion mit Drittanbietern voraussichtlich langsam sind, einen höheren Schwellenwert als für Ihre Homepage.
• Alert warm-up und Alert cooldown: wie lange die Bedingung bestehen bleiben muss, bevor ein Alert geöffnet wird, und wie lange gewartet wird, bevor er geschlossen wird. Siehe warm-up und cooldown.
• Description und Notify me through: eine Notiz, die erklärt, was der Trigger überwacht, und die Notifier, über die benachrichtigt wird.

Eine Diagrammvorschau neben dem Formular zeigt aktuelle Werte für die Aktion, was Ihnen hilft, einen Schwellenwert zu wählen, der zu ihrem normalen Verhalten passt. Wählen Sie Save trigger, um ihn zu erstellen. Auf diese Weise erstellte Trigger werden zusammen mit Ihren anderen Triggern im Abschnitt Anomaly detection aufgeführt, wo Sie sie auch später bearbeiten können.

​

Standardwerte für Organisation und App-Namespace

Benachrichtigungseinstellungen für einen Incident können erst geändert werden, nachdem er mindestens einmal aufgetreten ist. Dies kann ein Problem sein, wenn Sie nie benachrichtigt werden möchten. Es ist möglich, Benachrichtigungsstandardwerte pro App-Namespace oder sogar für die gesamte Organisation zu konfigurieren. Dies erleichtert es, die gewünschten Benachrichtigungseinstellungen auf alle neuen Incidents und alle bestehenden Incidents anzuwenden, deren Benachrichtigungseinstellungen nicht angepasst wurden.

​

App-Benachrichtigungsstandardwerte

Jede Anwendung hat ihre eigenen Namespace-Standardwerte für Benachrichtigungseinstellungen. Ein neuer Incident im angegebenen Namespace übernimmt die auf dieser Seite festgelegten Standardeinstellungen. Weitere Informationen finden Sie im Abschnitt Vererbung der Benachrichtigungsstandardwerte. Es wird empfohlen, die Anwendung in Namespaces aufzuteilen, die potenzielle Incidents nach Schweregrad gruppieren. So können Sie die Benachrichtigungseinstellungen für eine Gruppe von Incidents konfigurieren, ohne jeden Incident einzeln konfigurieren zu müssen. Für ein Admin-Panel einer App könnten Sie beispielsweise einen Namespace namens admin mit einer Standard-Benachrichtigungseinstellung “Never notify” erstellen, da Fehler, die in diesem Namespace auftreten, weniger Priorität haben.

​

Organisations-Benachrichtigungsstandardwerte

Es ist auch möglich, Benachrichtigungsstandardwerte auf Ihrer Organisation einzurichten. Diese Standardwerte werden verwendet, wenn AppSignal eine neue Anwendung erkennt und erstellt. Wenn es die neue App erstellt, wendet es die Benachrichtigungsstandardwerte der Organisation als App-Benachrichtigungsstandardwerte an. Änderungen an den Benachrichtigungsstandardwerten der Organisation gelten nicht für bereits bestehende Apps. Weitere Informationen finden Sie im Abschnitt Vererbung der Benachrichtigungsstandardwerte. Diese Benachrichtigungsstandardwerte auf Organisationsebene können im Admin-Panel der Organisation eingerichtet werden. Es ist möglich, Standardwerte für jeden in einer der aktuellen Anwendungen Ihrer Organisation erkannten Namespace zu konfigurieren.

​

Vererbung der Benachrichtigungsstandardwerte

Die Benachrichtigungseinstellungen werden von den Incident-Einstellungen zu den Namespace-Einstellungen der App aufsteigend übernommen. Wenn die Benachrichtigungseinstellungen für einen Incident nicht geändert werden, werden die Namespace-Standardwerte der App verwendet. Das bedeutet, dass Sie auch alle Incident-Benachrichtigungseinstellungen für Incidents, deren Benachrichtigungseinstellungen nicht angepasst wurden, ändern können, indem Sie die App-Standardwerte ändern.

• Wenn eine neue App von AppSignal erkannt wird, werden die Namespace-Standardwerte der Organisation angewendet.
  • Wenn die Benachrichtigungsstandardwerte des Organisations-Namespaces geändert werden, gelten sie nur für neue Apps.
• Wenn die Namespace-Benachrichtigungsstandardwerte einer App geändert werden, gelten sie für alle neuen Incidents und bestehenden Incidents ohne angepasste Benachrichtigungseinstellungen.
• Wenn ein neuer Incident von AppSignal erkannt wird, werden die Namespace-Standardwerte der App verwendet.
• Wenn die Benachrichtigungseinstellungen eines Incidents angepasst werden, werden ab diesem Zeitpunkt die angepassten Benachrichtigungseinstellungen des Incidents verwendet.