KEPLIN Docs

Warnungen per E-Mail

Was eine Warnung auslöst, was die E-Mail sagt, wer sie erhält und wie Sie die Warnungen einschalten und die Grenzwerte einstellen.

Der Radar erzählt, was los ist — dem, der den Bildschirm öffnet. Die Warnungen machen das Gegenteil: Sie melden, ohne dass jemand hinsehen muss. Es ist der Unterschied zwischen zu wissen, dass eine App unten war, und zu wissen, dass sie es ist.

Eine Warnung kommt nur, wenn jemand handeln muss, und sie sagt, was kaputtgegangen ist, wo, wie oft, bei wie vielen Personen und seit wann, mit einem Link, um es im Radar zu sehen.

Sie werden in den Einstellungen der Plattform eingeschaltet und eingestellt, unten in der Seitenleiste.

Hinweis

Diese Einstellungen gehören denen, die die Installation administrieren. Mit Developer-Profil erscheint das Menü Einstellungen nicht.

Was eine Warnung auslöst

Situation Wann gewarnt wird
Neues Problem In einer veröffentlichten App tritt ein Problem auf: ein Fehler in einem Bildschirm, einem Workflow oder einer Serverroute, eine API, die auf dem Server fehlschlägt, oder ein Test, der in einem geplanten Lauf fehlschlägt (siehe Ausführen und Ergebnisse lesen).
Zurückgekehrtes Problem Ein als behoben markiertes Problem tritt erneut auf.
Zurückgekehrtes offenes Problem Ein offenes Problem, über das niemand gewarnt worden war, tritt erneut auf.
Flächendeckender Ausfall Der Anteil der Anfragen, die auf dem Server fehlschlagen, überschreitet den Grenzwert, mit mindestens 5 Fehlern und der Mindestzahl an Anfragen.
Fehlgeschlagene Skripte Die fehlgeschlagenen Skriptausführungen überschreiten den Grenzwert.
Indexwarteschlange und Datenträger Die Indexwarteschlange gerät in Verzug oder auf dem Datenträger wird der freie Platz knapp.
Virenschutz Der Virenschutz lehnt eine hochgeladene Datei ab oder stellt eine bereits gespeicherte Datei unter Quarantäne (siehe Virenschutz).
Geheimnis eines Anbieters läuft ab Das Geheimnis eines Anbieters Microsoft Entra ID läuft in weniger als 30 Tagen ab oder ist bereits abgelaufen (siehe Mit Authentifizierungsanbietern anmelden).

Probleme folgen ihrem Status im Radar (siehe Ein Problem untersuchen):

  • Solange ein Problem offen ist, kommen keine weiteren E-Mails dazu.
  • Beheben schließt die Warnung ohne E-Mail: Wer das Problem behoben hat, weiß es bereits. Tritt das Problem erneut auf, sagt eine neue E-Mail, dass es zurück ist.
  • Ignorieren bringt ein Problem zum Schweigen: Es löst nie Warnungen aus.
  • Was im Studio passiert, während jemand die App baut oder testet, warnt niemanden.

Für den flächendeckenden Ausfall zählen nur Serverfehler (Status 500 oder höher). Abgelehnte Berechtigungen, von den Aufrufenden abgebrochene Anfragen und Validierungsfehler bei Eingaben zählen nicht. Hat eine App nicht genug Verkehr, um zu entscheiden, bleibt die Warnung, wie sie war: Sie schließt sich nicht nur deshalb, weil niemand mehr die App benutzt.

Was eine E-Mail sagt

Jede Person erhält eine E-Mail mit den Warnungen, die sie betreffen, in der Sprache, in der sie die Plattform benutzt. Bei einem Problem sagt die E-Mail:

  • Den Namen der App und die Fehlermeldung, im Betreff.
  • Wo: die API, der Bildschirm, der Workflow oder die Serverroute.
  • Wie viele Vorkommen es im Zeitfenster gab, und wie viele insgesamt.
  • Wie viele Benutzer betroffen waren.
  • Wann das Problem zuerst gesehen wurde und, bei einem zurückgekehrten Problem, wann es als behoben markiert worden war.
  • Im Radar öffnen: der Link, der das Problem im Radar der App öffnet.

Warnungen zu flächendeckenden Ausfällen und zu Skripten nennen die APIs oder Skripte, die fehlgeschlagen sind, wie oft, und jeweils die letzte Fehlermeldung.

Die Warnungen einschalten

  1. Öffnen Sie Einstellungen in der Seitenleiste.
  2. Wählen Sie Alarme in der Gruppe Warnungen.
  3. Schalten Sie Warnungen per E-Mail ein. Die Hilfe sagt, was auf dem Spiel steht: „Warnt, wenn in einer App ein neues Problem auftritt, wenn ein behobenes Problem erneut auftritt und wenn etwas die Grenzwerte unten überschreitet. Ohne das erfahren Sie es erst, wenn Sie den Bildschirm öffnen.“
  4. Klicken Sie im Kopfbereich auf Speichern. Die Bestätigung sagt „Einstellungen gespeichert.“

Der Abschnitt Alarme, mit dem Schalter Warnungen per E-Mail
Der Abschnitt Alarme, mit dem Schalter Warnungen per E-Mail

Der Abschnitt Prozesse in der Gruppe Plattform enthält drei weitere Schalter, die man kennen sollte, denn die Hälfte der „Warnungen, die nicht ankommen“ kommt daher, dass einer von ihnen ausgeschaltet ist:

Schalter Was er tut
Scheduler Führt die Zeitpläne, die geplanten Berichte und die Timer der Workflows aus.
Index der Observability Bringt das, was die Apps aufzeichnen, in den zentralen Index und wendet die Aufbewahrungsfristen jeder App an. Ausgeschaltet zeigen die Bildschirme alte Daten.
Benachrichtigungen in Echtzeit Echtzeit-Server der Benachrichtigungen. Ohne ihn werden Benachrichtigungen erst beim nächsten Besuch zugestellt.

Wohin die Warnungen gehen

Der Abschnitt E-Mail in der Gruppe Warnungen enthält den Ausgangsserver und die Empfänger: „Der Server, über den die Warnungen der Plattform hinausgehen. Er ist von der E-Mail jeder App getrennt.“

Der Abschnitt E-Mail, mit dem Ausgangsserver und den Empfängern
Der Abschnitt E-Mail, mit dem Ausgangsserver und den Empfängern

Feld Was es ist
Server Die Adresse des ausgehenden E-Mail-Servers.
Port Sein Port.
Sicherheit SSL/TLS (Port 465), STARTTLS, wenn der Server es anbietet (Port 587), oder Keine (Port 25).
Benutzer Das Konto für die Authentifizierung am Server.
Passwort „Wird verschlüsselt gespeichert und erscheint nie wieder auf diesem Bildschirm. Leer lassen behält das vorhandene.“
Absender Die Adresse dessen, der sendet. Sie ist Pflicht.
Empfänger Wer alle Warnungen erhält, anstelle der automatischen Auswahl.

Bleibt Empfänger leer, wählt die Plattform, wen sie warnt:

  • Die Warnungen einer App gehen an die Personen, die dieser App zugewiesen sind.
  • Die Warnungen einer App ohne zugewiesene Personen und die Warnungen der Plattform (Indexwarteschlange und Datenträger) gehen an die aktiven Administratoren.

Tipp

Lassen Sie Empfänger leer. Jede App warnt die Personen, die an ihr arbeiten, und die Liste aktualisiert sich selbst, wenn jemand ins Team kommt oder es verlässt. Eine von Hand geschriebene Liste erhält alles von allen Apps und ist an dem Tag veraltet, an dem jemand die Stelle wechselt.

Der Zustand des Passworts erscheint unter dem Feld: Festgelegt — zum Ersetzen tippen oder Noch nicht festgelegt.

Ab wann gewarnt wird

Die Schwellenwerte stehen im Abschnitt Alarme, unter dem Schalter: „Neue Probleme lösen immer eine Warnung aus. Die Werte unten legen fest, wann ein flächendeckender Ausfall, Skripte, die Indexwarteschlange oder der Datenträger eine E-Mail senden.“

Die Schwellenwerte des Abschnitts Alarme, mit dem Zeitfenster
Die Schwellenwerte des Abschnitts Alarme, mit dem Zeitfenster

Grenzwert Was er misst Anmerkung
Serverfehler der APIs (%) „Anteil der Anfragen, die auf dem Server fehlschlagen (5xx), pro App, mit mindestens 5 Fehlern im Zeitfenster.“ Gezählt wird App für App, nicht über die Summe aller.
Mindestanzahl Anfragen Wie viele Aufrufe nötig sind, damit der Prozentsatz zählt „Darunter sagt der Prozentsatz nichts aus: 1 Fehler von 3 sind 33 %.“
Fehlgeschlagene Skripte Wie viele Skriptausführungen fehlschlagen dürfen, bevor gewarnt wird
Verzögerung der Warteschlange (s) Wie weit die Warteschlange des Index zurückliegen darf „Solange die Warteschlange hinterherhinkt, zeigen die Bildschirme alte Daten.“
Freier Speicherplatz (%) Unterhalb welches Prozentsatzes freien Speicherplatzes gewarnt wird
Fenster (Min.) Der Zeitraum, in dem all das gezählt wird „Zeitraum, über den die Werte oben gezählt werden.“

Die Mindestanzahl Anfragen verhindert, dass eine App mit wenig Verkehr Warnungen zu flächendeckenden Ausfällen auslöst: Bei drei Anfragen und einem Fehler liegt der Anteil bei 33 % und sagt nichts aus. Jeder Serverfehler löst bereits seine eigene Problemwarnung aus; der Anteil ist für den Tag gedacht, an dem vieles gleichzeitig ausfällt.

Wie man die Werte wählt

Es gibt keine universellen Zahlen, aber eine Methode, die funktioniert:

  1. Lassen Sie die Plattform eine Woche mit den Standardwerten laufen.
  2. Öffnen Sie Observability → Übersicht mit dem Zeitraum auf 7d und sehen Sie sich die tatsächliche Fehlerrate und die Antwort (p95) an.
  3. Setzen Sie den Grenzwert der Serverfehler der APIs (%) etwas über das, was in dieser Installation normal ist — das Ziel ist, das Anormale zu fangen, nicht das Normale zu bestätigen.
  4. Passen Sie die Mindestanzahl Anfragen an den Verkehr der ruhigsten App an.

Achtung

Ein zu enger Grenzwert ist schlimmer als keiner. Warnungen, die jeden Tag auslösen, werden nach einer Woche nicht mehr gelesen — und an dem Tag, an dem die wichtige eintrifft, trifft sie mitten unter den anderen ein.

Bestätigen, dass die Warnungen wirklich funktionieren

Der Abschnitt Zustand der Observability trägt ganz oben einen Satz, der die Wahrheit über die Warnungen in dieser Installation sagt. Dort prüft man nach, nachdem man an den Einstellungen gedreht hat.

Der Hinweis zum Zustand der Warnungen, oben im Abschnitt Zustand der Observability
Der Hinweis zum Zustand der Warnungen, oben im Abschnitt Zustand der Observability

Drei Sätze sind möglich:

Was dort steht Was es bedeutet
„Warnmeldungen aktiv: benachrichtigt die Personen, die an jeder App arbeiten, wenn ein neues Problem auftritt und wenn ein behobenes Problem erneut auftritt, und außerdem, wenn mehr als 5% der Anfragen auf dem Server fehlschlagen, ab 20 Anfragen.“ Alles funktioniert — und mit Ihren Grenzwerten in Sichtweite.
„Die Warnmeldungen sind ausgeschaltet. Niemand wird benachrichtigt, wenn etwas schiefgeht — diese Seite erzählt nur dem, der sie öffnet, was los ist.“ Es fehlt, Warnungen per E-Mail einzuschalten.
„Warnmeldungen aktiv, aber ohne E-Mail-Versand: … Die Alarme werden aufgezeichnet und niemand wird benachrichtigt.“ Die Warnung löst aus, geht aber nicht hinaus — es fehlt die Konfiguration des E-Mail-Servers.

Der dritte ist der tückischste, weil alles konfiguriert scheint. Wenn Sie ihn sehen, gehen Sie zurück zum Abschnitt E-Mail und vervollständigen Sie, was fehlt.

Sitzungen und Grenzwerte

Ebenfalls in den Einstellungen enthält der Abschnitt Grenzwerte in der Gruppe Plattform zwei Werte, die keine Warnungen sind, aber meist zur selben Zeit gesucht werden:

  • Dauer der Sitzung (h) — „Eine aktive Sitzung verlängert sich von selbst; dies ist die Leerlaufzeit, nach der sie abläuft.“
  • Maximale Datei (MB) — die maximale Größe einer hochgeladenen Datei.

Warum sehe ich nicht…?

  • …Warnungen eintreffen, obwohl alles eingeschaltet ist? Prüfen Sie das Panel Zustand: Steht dort „ohne E-Mail-Versand“, fehlt der Ausgangsserver. Steht dort „ausgeschaltet“, fehlt das Speichern.
  • …den Abschnitt Alarme? Sie sind in den Einstellungen einer App, nicht in denen der Plattform. Die der Plattform öffnen sich über das Menü Einstellungen der Seitenleiste.
  • …meine Grenzwerte in Kraft? Ohne Speichern im Kopfbereich wird nichts gespeichert. Die Bestätigung ist „Einstellungen gespeichert.“
  • …die Warnungen einer App? Die Warnungen einer App gehen an die ihr zugewiesenen Personen. Prüfen Sie unter Benutzer, ob Sie der App zugewiesen sind.
  • …eine weitere E-Mail zum selben Problem? Ein offenes Problem warnt nur einmal. Es warnt erneut, wenn es als behoben markiert wird und wieder auftritt.
  • …die Warnung zu einem Fehler, den ich im Studio gesehen habe? Was im Studio passiert, während jemand die App baut, warnt niemanden. Nur die veröffentlichte App löst Warnungen aus.