---
title: "Hälytykset"
description: "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>