Benachrichtigungsoptionen
Wenn ein neuer Incident erstellt wird, übernimmt er die Standard-Benachrichtigungseinstellungen der App. Wenn ein Error- oder Performance-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
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 nie eine Benachrichtigung gesendet, wenn der Incident ausgelöst wird. 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/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.
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).
Benachrichtigungseinstellungen für Performance-Incidents
Performance-Incidents werden anhand ihres “action”-Namens identifiziert, z. B.BlogpostsController#show.
Sobald wir eine neue Aktion erkennen, erstellen wir einen Incident dafür. An diesem Punkt können Sie die Standard-Benachrichtigungseinstellungen überschreiben und ändern, wann Sie benachrichtigt werden möchten und welchen Schwellenwert die Dauer des Performance-Incidents erreichen muss, bevor eine Benachrichtigung gesendet wird.
Z. B. können Sie für Aktionen, bei denen die Antwortzeiten langsam sein können, weil sie mit Drittanbietern interagieren, den Dauer-Schwellenwert auf 10 Sekunden setzen, während Sie für die Homepage einen Schwellenwert von 200 Millisekunden festlegen können.
Der Schwellenwertfilter wird in Kombination mit den Benachrichtigungseinstellungen verwendet. Wenn Sie z. B. First in deploy und 200ms als Benachrichtigungseinstellungen und Schwellenwert haben, muss ein Vorkommen eines Incidents beide Bedingungen erfüllen, damit eine Benachrichtigung gesendet wird.
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 oder einen anderen Schwellenwert für Performance-Incidents als die Standard-200-Millisekunden festlegen 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 namensadmin 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.