KEPLIN Docs

Waarschuwingen per e-mail

De waarschuwingen aanzetten, de ontvangers kiezen, en de drempels afstellen vanaf welke het platform meldt dat er iets misgegaan is.

De Radar vertelt wat er gebeurt aan wie het scherm opent. De waarschuwingen doen het omgekeerde: zij melden zonder dat iemand hoeft te kijken. Dat is het verschil tussen weten dat een app uit de lucht is geweest en weten dat zij dat is.

U stelt ze allemaal op dezelfde plek in — Instellingen, in de zijbalk, in de beheerzone — en ze gelden voor het hele platform, niet per app.

Nota

Deze instellingen zijn van wie de installatie beheert. Met een developerprofiel verschijnt het menu Instellingen niet.

De waarschuwingen aanzetten

  1. Open Instellingen in de zijbalk.
  2. Zoek in het paneel Achtergrondwerk — "Wat vanzelf draait terwijl niemand kijkt. Uitschakelen verwijdert niets — het stopt alleen." — de regel Waarschuwingen per e-mail.
  3. Zet de schakelaar aan. De hulp ernaast zegt waar het om gaat: "Waarschuwt wanneer iets de onderstaande grenzen overschrijdt. Zonder dit weet u het pas wanneer u het scherm opent."
  4. Ga naar het einde van de pagina en klik op Opslaan. De bevestiging zegt "Instellingen opgeslagen."

Het paneel Achtergrondwerk, met de schakelaar Waarschuwingen per e-mail
Het paneel Achtergrondwerk, met de schakelaar Waarschuwingen per e-mail

In hetzelfde paneel staan nog drie schakelaars die het waard zijn om te kennen, want de helft van de "waarschuwingen die niet aankomen" komt doordat een van deze uit staat:

Schakelaar Wat die doet
Planner Voert de planningen, de geplande rapporten en de tijdklokken van de workflows uit.
Index van Observability Brengt wat de apps vastleggen naar de centrale index en past de bewaartermijnen van elke app toe. Uitgeschakeld tonen de schermen oude gegevens.
Meldingen in real time Real-timeserver voor de meldingen. Zonder die server worden meldingen bij het volgende bezoek afgeleverd.

Waar de waarschuwingen heen gaan

Het paneel E-mail voor de waarschuwingen — "De server waarlangs de waarschuwingen van het platform uitgaan. Die staat los van de e-mail van elke app." — bevat de uitgaande server en de ontvangers.

Het paneel E-mail voor de waarschuwingen, met de uitgaande server en de ontvangers
Het paneel E-mail voor de waarschuwingen, met de uitgaande server en de ontvangers

Veld Wat het is
Server Het adres van de uitgaande e-mailserver.
Poort De poort ervan.
Impliciete TLS "Meestal aan op poort 465. Op de andere poorten wordt de verbinding na het openen opgewaardeerd."
Gebruiker Het account voor de authenticatie op de server.
Wachtwoord "Het wordt versleuteld opgeslagen en komt nooit terug op dit scherm. Leeg laten behoudt het huidige."
Afzender Het adres van wie verstuurt. Verplicht.
Ontvangers Wie het ontvangt.

Het veld Ontvangers heeft een notitie die een onderhoudsprobleem oplost: "Gescheiden door komma's. Leeg waarschuwt de actieve beheerders — een lijst die zichzelf bijhoudt."

Dica

Laat de Ontvangers leeg. De lijst met actieve beheerders werkt zichzelf bij wanneer er iemand bij het team komt of het verlaat; een met de hand geschreven lijst is verouderd op de dag dat iemand van baan wisselt — en niemand denkt er nog aan.

De staat van het wachtwoord verschijnt onder het veld: Ingesteld — typ om te vervangen of Nog niet ingesteld.

Vanaf wanneer waarschuwen

Het paneel Vanaf wanneer waarschuwen — "De onderstaande waarden zijn de standaardwaarden." — bevat de drempels. Een waarschuwing gaat af wanneer een van deze waarden binnen het tijdvenster wordt overschreden.

Het paneel Vanaf wanneer waarschuwen, met de drempels en het venster
Het paneel Vanaf wanneer waarschuwen, met de drempels en het venster

Drempel Wat die meet Opmerking
API-fouten (%) "Percentage mislukte aanroepen, per app." Er wordt app voor app geteld, niet over de som van alle apps.
Minimum aantal verzoeken Hoeveel aanroepen er nodig zijn voordat het percentage meetelt "Daaronder zegt het percentage niets: 1 fout op 3 is 33%."
Mislukte scripts Hoeveel uitvoeringen van scripts mogen mislukken voordat er wordt gewaarschuwd
Achterstand van de wachtrij (s) Hoeveel de wachtrij van de index mag achterlopen "Zolang de wachtrij achterloopt, tonen de schermen oude gegevens."
Vrije schijfruimte (%) Onder welk percentage vrije schijfruimte er wordt gewaarschuwd
Venster (min) De periode waarover dit alles wordt geteld "De periode waarover de bovenstaande getallen worden geteld."

Het Minimum aantal verzoeken is het belangrijkste veld en het meest vergeten. Zonder dat veld laat een app met weinig verkeer de hele dag waarschuwingen afgaan: drie aanroepen, één mislukt, 33% fouten. Met dat veld telt het percentage pas mee wanneer er genoeg aanroepen zijn om het iets te laten betekenen.

Hoe u de waarden kiest

Er zijn geen universele getallen, maar er is wel een werkwijze die werkt:

  1. Laat het platform een week draaien met de standaardwaarden.
  2. Open ObservabilityOverzicht met de periode op 7d en kijk naar het werkelijke Foutpercentage en de werkelijke Antwoordtijd (p95).
  3. Zet de drempel van API-fouten (%) iets boven wat op die installatie normaal is — het doel is het abnormale te vangen, niet het normale te bevestigen.
  4. Stem het Minimum aantal verzoeken af op het verkeer van de rustigste app.

Atenção

Een te strakke drempel is erger dan geen drempel. Waarschuwingen die elke dag afgaan, worden na een week niet meer gelezen — en op de dag dat de belangrijke waarschuwing komt, komt zij tussen de andere binnen.

Bevestigen dat de waarschuwingen ook echt werken

De sectie Status van de Observability heeft bovenaan een zin die de waarheid vertelt over de waarschuwingen op deze installatie. Dat is de plek om te controleren nadat u aan de instellingen hebt gezeten.

De melding over de status van de waarschuwingen, boven aan de sectie Status van de Observability
De melding over de status van de waarschuwingen, boven aan de sectie Status van de Observability

Er zijn drie mogelijke zinnen:

Wat daar staat Wat dat betekent
"Waarschuwingen aan: waarschuwt de beheerders boven 5% fouten, vanaf 20 verzoeken." Alles werkt — en met uw drempels in beeld.
"De waarschuwingen staan uit. Niemand wordt gewaarschuwd wanneer er iets misgaat — deze pagina vertelt alleen wat er gebeurt aan wie haar opent." Waarschuwingen per e-mail moet nog aan.
"Waarschuwingen staan aan, maar e-mail kan niet worden verstuurd: … De alarmen worden vastgelegd en niemand wordt gewaarschuwd." De waarschuwing gaat af, maar zij gaat niet de deur uit — de e-mailserver moet nog worden ingesteld.

De derde is de verraderlijkste, want alles lijkt ingesteld. Ziet u haar, ga dan terug naar het paneel E-mail voor de waarschuwingen en vul aan wat ontbreekt.

Sessies en limieten

Nog steeds in de Instellingen bevat het paneel Sessies en limieten — "Ze gelden voor het hele platform." — twee waarden die geen waarschuwingen zijn maar er meestal tegelijk mee worden gezocht:

  • Duur van de sessie (u) — "Een actieve sessie vernieuwt zichzelf; dit is de inactieve tijd waarna zij verloopt."
  • Maximaal bestand (MB) — de maximale omvang van een geüpload bestand.

Waarom zie ik niet…?

  • …waarschuwingen binnenkomen, terwijl alles aanstaat? Controleer het paneel Status: zegt het "e-mail kan niet worden verstuurd", dan ontbreekt de uitgaande server. Zegt het "staan uit", dan moet er nog worden opgeslagen.
  • …het paneel Achtergrondwerk? U bent in de instellingen van een app, niet in die van het platform. Die van het platform opent u via het menu Instellingen in de zijbalk.
  • …mijn drempels gelden? Zonder Opslaan onderaan de pagina wordt er niets bewaard. De bevestiging is "Instellingen opgeslagen."
  • …waarschuwingen per app? Die bestaan niet: de drempels zijn van het platform. Wat per app gaat, is de rotatie van registraties, in de instellingen van elke app.