> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thunderphone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Hälytykset

> Puhelumittareidesi kynnössäännöt — toimitetaan sähköpostiin, Slackiin tai webhookeihisi heti, kun jokin menee pieleen.

Hälytyssäännöt seuraavat organisaatiosi puhelumittareita ja ilmoittavat sinulle, kun
raja-arvo ylittyy tai alittuu — onnistumisaste on alle 80 % viimeisen vuorokauden aikana,
puheluita on yli 500 tunnissa tai testipaketissa tapahtuu regressio. Hallitse niitä kohdassa
**Asetukset → Organisaatio → Hälytykset**
(`/dashboard/organization?tab=alerts`). Hälytyssääntöjen hallinta edellyttää
**ylläpitäjän** tai **omistajan** roolia.

## Luo sääntö

Napsauta **Luo sääntö** ja täytä seuraavat tiedot:

| Kenttä                             | Vaihtoehdot                                                                                            |
| ---------------------------------- | ------------------------------------------------------------------------------------------------------ |
| **Mittari**                        | Onnistumisaste · Epäonnistumisaste · Keskimääräinen pistemäärä · Puhelumäärä · Testipaketin regressiot |
| **Ehto**                           | on alle · on enintään · on yli · on vähintään                                                          |
| **Kynnysarvo**                     | Luku, johon verrataan                                                                                  |
| **Ikkuna (tuntia)**                | Kuinka pitkältä ajalta mittari lasketaan — 1–720 tuntia                                                |
| **Sähköpostin vastaanottajat**     | Pilkuilla eroteltu, enintään 10 osoitetta                                                              |
| **Slackin saapuvan webhookin URL** | Valinnainen — lähettää hälytysviestin kanavalle                                                        |
| **Jäähdytysaika (minuutteja)**     | Laukeamisten välinen vähimmäishiljainen aika (oletus 60)                                               |
| **Toimita kehittäjäwebhookeihin**  | Lähetä myös `alert.triggered`-tapahtuma webhook-päätepisteisiisi                                       |
| **Ota hälytyssääntö käyttöön**     | Säännöt voidaan tallentaa poissa käytöstä ja ottaa käyttöön myöhemmin                                  |

Esimerkki: *"Onnistumisaste **on alle** 80 viimeisten 24 tunnin aikana"*
laukeaa, kun arvioitujen puheluiden onnistumisaste laskee alle 80 %:n
viimeisten 24 tunnin ikkunassa.

<Note>
  **Epäonnistumisaste sisältää muutakin kuin "Epäonnistuneet"-puhelut.** Hälytysmetrinen
  käsittelee epäonnistumisena jokaisen puhelun, joka ei saavuttanut onnistunutta lopputulosta —
  mukaan lukien puhelut, joissa ei ollut lainkaan keskustelua (välittömät katkaisut, epäonnistuneet
  yhteydet). Hallintapaneelin **Epäonnistuneet**-ruutu laskee vain puhelut, joiden arvosana on
  `unsuccessful`. Epäonnistumisasteen hälytys voi siis laueta, vaikka hallintapaneelin ruudussa
  näkyy pieni luku; tämä on odotettua, ei ristiriita.
</Note>

## Miten laukeaminen toimii

Säännöt arvioidaan määrittämääsi viimeisintä aikaikkunaa vasten. Kun
ehto täyttyy, sääntö laukeaa **kerran** ja pysyy sitten hiljaisena
jäähdytysajan ajan, vaikka mittari pysyisi rajan ulkopuolella — joten huono
tunti tuottaa yhden hälytyksen, ei hälytystä jokaista arviointia kohden. Jokaisesta laukeamisesta
tallennetaan mittarin arvo, kynnysarvo ja aika.

## Toimituskanavat

Yksi sääntö voi ilmoittaa kaikilla kolmella kanavalla samanaikaisesti:

* **Sähköposti** — viesti jokaiselle luetellulle vastaanottajalle, jossa kerrotaan säännön
  nimi, mittari, arvo, kynnysarvo ja aikaikkuna.
* **Slack** — sama viesti lähetetään Slackin saapuvan webhookin
  URL-osoitteen kautta.
* **Kehittäjäwebhookit** — `alert.triggered`-tapahtuma toimitetaan organisaatiosi
  [webhook-päätepisteisiin](/fi/webhooks/overview), jotta voit yhdistää
  hälytykset PagerDutyyn, päivystystyökaluihin tai omiin järjestelmiisi.

Yhden kanavan epäonnistuminen ei koskaan estä muita kanavia.

## Hallitse sääntöjä

Hälytykset-välilehti listaa jokaisen säännön sekä sen käytössä/poissa käytöstä -tilan ja
viimeisimmän laukeamisajan. Ota säännöt käyttöön tai poista ne käytöstä suoraan luettelossa, valitse **Muokkaa**
muuttaaksesi mitä tahansa kenttää tai poista säännöt, joita et enää tarvitse. Viimeaikainen
hälytystoiminta näytetään vieressä, jotta voit varmistaa, että sääntö todella laukeaa
odottamallasi tavalla.

## Seuraavat vaiheet

<CardGroup cols={2}>
  <Card title="Havainnoitavuus" icon="chart-line" href="/fi/guides/observability">
    Samojen mittareiden hallintapaneelit.
  </Card>

  <Card title="Webhookit" icon="webhook" href="/fi/webhooks/overview">
    Vastaanota alert.triggered (ja kaikki muut tapahtumat) omiin järjestelmiisi.
  </Card>
</CardGroup>