KEPLIN Docs

Sähköpostihälytykset

Mikä laukaisee hälytyksen, mitä sähköposti kertoo, kuka sen saa, ja miten varoitukset kytketään päälle ja rajat säädetään.

Radar kertoo tapahtumista sille, joka avaa näytön. Hälytykset tekevät päinvastoin: ne varoittavat ilman, että kenenkään tarvitsee katsoa. Se on ero sen välillä, tietääkö että sovellus oli alhaalla vai tietääkö, että se on.

Hälytys tulee vain, kun jonkun täytyy toimia, ja se kertoo, mikä hajosi, missä, kuinka monta kertaa, kuinka monelle ja mistä lähtien, sekä linkin, jolla sen näkee Radarissa.

Ne kytketään päälle ja säädetään alustan Asetuksissa sivupalkin alaosassa.

Huomio

Nämä asetukset kuuluvat asennuksen ylläpitäjälle. Developer-profiililla valikkoa Asetukset ei näy.

Mikä laukaisee hälytyksen

Tilanne Milloin varoitetaan
Uusi ongelma Julkaistussa sovelluksessa ilmenee ongelma: virhe näkymässä, työnkulussa tai palvelimen reitissä, API, joka epäonnistuu palvelimella, tai testi, joka epäonnistuu ajastetussa ajossa (katso Ajaminen ja tulosten lukeminen).
Palannut ongelma Ratkaistuksi merkitty ongelma toistuu.
Palannut avoin ongelma Avoin ongelma, josta ketään ei ollut varoitettu, toistuu.
Laaja häiriö Palvelimella epäonnistuvien pyyntöjen osuus ylittää rajan, kun virheitä on vähintään 5 ja pyyntöjä vähimmäismäärä.
Epäonnistuneet skriptit Epäonnistuneet skriptien suoritukset ylittävät rajan.
Indeksin jono ja Levy Indeksin jono jää jälkeen tai levyllä on vähän vapaata tilaa.
Virustorjunta Virustorjunta hylkää lähetetyn tiedoston tai siirtää jo tallennetun tiedoston karanteeniin (katso Virustorjunta).
Palvelun salaisuus vanhenemassa Microsoft Entra ID -palvelun salaisuus vanhenee 30 päivän kuluessa tai on jo vanhentunut (katso Kirjautuminen tunnistautumispalveluilla).

Ongelmat seuraavat tilaa, joka niillä on Radarissa (katso Ongelman tutkiminen):

  • Niin kauan kuin ongelma on avoin, siitä ei tule lisää sähköposteja.
  • Ongelman Ratkaise sulkee hälytyksen ilman sähköpostia: ongelman ratkaissut tietää sen jo. Jos ongelma toistuu, uusi sähköposti kertoo, että se palasi.
  • Ongelman Ohita vaientaa sen: se ei koskaan laukaise hälytyksiä.
  • Studiossa tapahtuva, kun joku rakentaa tai testaa sovellusta, ei varoita ketään.

Laajassa häiriössä lasketaan vain palvelinvirheet (tila 500 tai suurempi). Hylätyt käyttöoikeudet, tekijänsä perumat pyynnöt ja validointivirheet syötteissä eivät ole mukana. Kun sovelluksella ei ole tarpeeksi liikennettä päätöksen tekemiseen, hälytys pysyy ennallaan: se ei sulkeudu vain siksi, että ihmiset lopettivat sovelluksen käytön.

Mitä sähköposti kertoo

Jokainen saa yhden sähköpostin häntä koskevista hälytyksistä sillä kielellä, jolla hän käyttää alustaa. Ongelmasta sähköposti kertoo:

  • Sovelluksen nimen ja virheilmoituksen aiherivillä.
  • Missä: API, näkymä, työnkulku tai palvelimen reitti.
  • Montako esiintymää ikkunassa oli ja montako yhteensä.
  • Montako käyttäjää asia koski.
  • Milloin ongelma nähtiin ensimmäisen kerran ja palanneen ongelman kohdalla, milloin se oli merkitty ratkaistuksi.
  • Avaa Radarissa: linkki, joka avaa ongelman sovelluksen Radarissa.

Laajan häiriön ja skriptien hälytykset kertovat, mitkä API:t tai skriptit epäonnistuivat, kuinka monta kertaa ja kunkin viimeisimmän virheilmoituksen.

Varoitusten kytkeminen päälle

  1. Avaa sivupalkista Asetukset.
  2. Valitse ryhmästä Varoitukset kohta Hälytykset.
  3. Kytke Sähköpostivaroitukset päälle. Ohje kertoo, mistä on kyse: ”Varoittaa, kun sovelluksessa ilmenee uusi ongelma, kun ratkaistu ongelma toistuu ja kun jokin ylittää alla olevat rajat. Ilman tätä saat tietää vasta avatessasi näytön.”
  4. Napsauta otsakkeen Tallenna-painiketta. Vahvistus sanoo ”Asetukset tallennettu.”

Osio Hälytykset ja valitsin Sähköpostivaroitukset
Osio Hälytykset ja valitsin Sähköpostivaroitukset

Ryhmän Alusta osiossa Prosessit on kolme muuta valitsinta, jotka kannattaa tuntea, sillä puolet tapauksista ”hälytykset eivät tule perille” johtuu siitä, että jokin niistä on pois päältä:

Valitsin Mitä se tekee
Ajastin Suorittaa ajastukset, ajastetut raportit ja työnkulkujen ajastimet.
Havainnoinnin indeksi Siirtää sovellusten kirjaamat tiedot keskusindeksiin ja soveltaa kunkin sovelluksen säilytysaikoja. Pois päältä näytöt näyttävät vanhaa dataa.
Reaaliaikaiset ilmoitukset Ilmoitusten reaaliaikapalvelin. Ilman sitä ilmoitukset toimitetaan seuraavalla käynnillä.

Minne varoitukset menevät

Ryhmän Varoitukset osiossa Sähköposti ovat lähtevän postin palvelin ja vastaanottajat: ”Palvelin, jonka kautta alustan varoitukset lähtevät. Eri asia kuin kunkin sovelluksen sähköposti.”

Osio Sähköposti: lähtevän postin palvelin ja vastaanottajat
Osio Sähköposti: lähtevän postin palvelin ja vastaanottajat

Kenttä Mikä se on
Palvelin Lähtevän sähköpostipalvelimen osoite.
Portti Sen portti.
Suojaus SSL/TLS (portti 465), STARTTLS, jos palvelin tarjoaa sen (portti 587), tai Ei mitään (portti 25).
Käyttäjä Tunnistautumistili palvelimella.
Salasana ”Tallennetaan salattuna eikä näytetä enää uudelleen. Jätä tyhjäksi säilyttääksesi nykyisen.”
Lähettäjä Lähettäjän osoite. Se on pakollinen.
Vastaanottajat Kuka saa kaikki varoitukset automaattisen valinnan sijaan.

Kun kenttä Vastaanottajat on tyhjä, alusta valitsee, ketä se varoittaa:

  • Sovelluksen hälytykset menevät sovellukseen määritetyille henkilöille.
  • Sovelluksen, johon ei ole määritetty ketään, hälytykset sekä alustan omat hälytykset (indeksin jono ja levy) menevät aktiivisille ylläpitäjille.

Vinkki

Jätä kenttä Vastaanottajat tyhjäksi. Kukin sovellus varoittaa sen parissa työskenteleviä, ja lista päivittyy itsestään, kun joku tulee tiimiin tai lähtee siitä. Käsin kirjoitettu lista saa kaiken kaikista sovelluksista ja vanhenee sinä päivänä, kun joku vaihtaa työpaikkaa.

Salasanan tila näkyy kentän alla: Asetettu — kirjoita vaihtaaksesi tai Asettamatta.

Milloin varoitetaan

Kynnysarvot ovat osiossa Hälytykset, valitsimen alla: ”Uudet ongelmat varoittavat aina. Alla olevat arvot ratkaisevat, milloin laaja häiriö, skriptit, indeksin jono tai levy lähettävät sähköpostin.”

Osion Hälytykset kynnysarvot ja ikkuna
Osion Hälytykset kynnysarvot ja ikkuna

Raja-arvo Mitä se mittaa Huomioita
API-palvelinvirheet (%) ”Palvelimella epäonnistuvien pyyntöjen (5xx) osuus sovelluksittain, kun ikkunassa on vähintään 5 virhettä.” Lasketaan sovellus sovellukselta, ei kaikkien summasta.
Pyyntöjen vähimmäismäärä Montako kutsua tarvitaan, jotta prosentti lasketaan ”Tämän alle prosentti ei kerro mitään: 1 virhe kolmesta on 33 %.”
Epäonnistuneet skriptit Montako skriptisuoritusta saa epäonnistua ennen varoitusta
Jonon viive (s) Kuinka paljon indeksin jono saa jäädä jälkeen ”Niin kauan kuin jono on jäljessä, näytöt näyttävät vanhaa dataa.”
Vapaa levytila (%) Minkä vapaan levytilan prosentin alittuessa varoitetaan
Ikkuna (min) Jakso, jonka sisällä tämä kaikki lasketaan ”Jakso, jolta yllä olevat luvut lasketaan.”

Pyyntöjen vähimmäismäärä estää vähäliikenteistä sovellusta laukaisemasta laajan häiriön hälytyksiä: kolmella pyynnöllä ja yhdellä virheellä osuus on 33 %, eikä se kerro mitään. Jokainen palvelinvirhe laukaisee jo oman ongelmahälytyksensä; osuus on sitä päivää varten, jolloin moni asia epäonnistuu yhtä aikaa.

Miten arvot valitaan

Yleispäteviä lukuja ei ole, mutta on menetelmä, joka toimii:

  1. Anna alustan käydä viikko oletusarvoilla.
  2. Avaa Havainnointi → Yleiskatsaus jaksolla 7d ja katso todellista Virheprosenttia ja Vastausta (p95).
  3. Aseta API-palvelinvirheet (%) -raja hieman sen yläpuolelle, mikä on tässä asennuksessa normaalia — tavoite on napata epänormaali, ei vahvistaa normaalia.
  4. Sovita Pyyntöjen vähimmäismäärä rauhallisimman sovelluksen liikenteeseen.

Varoitus

Liian tiukka raja on pahempi kuin ei rajaa lainkaan. Hälytykset, jotka laukeavat joka päivä, lakkaavat tulemasta luetuiksi viikossa — ja sinä päivänä, kun se tärkeä saapuu, se saapuu muiden keskelle.

Varmista, että hälytykset todella toimivat

Havainnoinnin osiossa Tila on ylhäällä lause, joka kertoo totuuden tämän asennuksen hälytyksistä. Se on paikka, josta asia varmistetaan asetusten muuttamisen jälkeen.

Hälytysten tilailmoitus Havainnoinnin Tila-osion ylälaidassa
Hälytysten tilailmoitus Havainnoinnin Tila-osion ylälaidassa

Mahdollisia lauseita on kolme:

Mitä siellä lukee Mitä se tarkoittaa
”Hälytykset päällä: ilmoittaa kunkin sovelluksen parissa työskenteleville, kun uusi ongelma ilmenee ja kun ratkaistu ongelma toistuu, sekä silloin, kun yli 5 % pyynnöistä epäonnistuu palvelimella ja pyyntöjä on vähintään 20.” Kaikki toimii — ja omat raja-arvosi ovat näkyvillä.
”Hälytykset ovat pois päältä. Kukaan ei saa tietoa, kun jokin menee pieleen — tämä sivu kertoo tilanteen vain sen avaajalle.” Sähköpostivaroitukset on vielä kytkemättä päälle.
”Hälytykset ovat päällä, mutta sähköpostia ei voi lähettää: … Hälytykset kirjataan, eikä kukaan saa niistä tietoa.” Varoitus laukeaa mutta ei lähde — sähköpostipalvelin on määrittämättä.

Kolmas on salakavalin, koska kaikki näyttää määritetyltä. Jos näet sen, palaa osioon Sähköposti ja täydennä puuttuva.

Istunnot ja rajat

Yhä Asetuksissa, ryhmän Alusta osiossa Rajat, on kaksi arvoa, jotka eivät ole hälytyksiä mutta joita etsitään usein samalla:

  • Istunnon kesto (h) — ”Aktiivinen istunto uusiutuu itsestään; tämä on se joutoaika, joka päättää sen.”
  • Tiedoston enimmäiskoko (MB) — ladatun tiedoston enimmäiskoko.

Miksi en näe…?

  • Miksi hälytyksiä ei tule, vaikka kaikki on päällä? Tarkista paneeli Tila: jos siellä lukee ”sähköpostia ei voi lähettää”, lähtevän postin palvelin puuttuu. Jos siellä lukee ”pois päältä”, tallennus puuttuu.
  • Miksi en näe osiota Hälytykset? Olet sovelluksen asetuksissa, et alustan. Alustan asetukset avataan sivupalkin valikosta Asetukset.
  • Miksi raja-arvoni eivät päde? Ilman otsakkeen Tallenna-painiketta mitään ei tallenneta. Vahvistus on ”Asetukset tallennettu.”
  • Miksi en saa sovelluksen hälytyksiä? Sovelluksen hälytykset menevät siihen määritetyille henkilöille. Tarkista kohdasta Käyttäjät, että sinut on määritetty sovellukseen.
  • Miksi en saa toista sähköpostia samasta ongelmasta? Avoin ongelma varoittaa vain kerran. Se varoittaa uudelleen, jos se merkitään ratkaistuksi ja toistuu.
  • Miksi en saa hälytystä virheestä, jonka näin studiossa? Studiossa tapahtuva, sovellusta rakentavalle, ei varoita ketään. Vain julkaistu sovellus laukaisee hälytyksiä.