Aiforsite Alerts Käyttöopas

1. Aloitus

Aiforsite Alerts on monikanavainen hälytysjärjestelmä, joka auttaa valvomaan palveluitasi ja ilmoittaa kun jotain menee vikaan.

Keskeiset ominaisuudet

• Hälytysten vastaanotto - Vastaanota hälytyksiä webhookin kautta mistä tahansa järjestelmästä
• Terveysmonitorit - HTTP-päätepisteiden ja skriptien terveystarkistukset
• Heartbeat-valvonta - Cron-jobien ja varmuuskopioiden valvonta
• AI-vahdit - Verkkosivujen muutosten seuranta AI-analyysillä
• Status-sivu - Julkinen tilasivu palveluillesi
• Monikanavaiset ilmoitukset - Sähköposti, SMS, Slack, WhatsApp, Webhookit

2. API-avaimet

API-avaimia käytetään Aiforsite Alerts API:n tunnistautumiseen.

API-avaimen luominen

1. Mene Admin → API Keys
2. Klikkaa "Add API Key"
3. Syötä nimi ja valitse käyttöoikeus
4. Tärkeää: Kopioi avain heti - se näytetään vain kerran!

Käyttöoikeudet (Scope)

API-avaimen käyttö

# Header-tunnistautuminen (suositeltu)
curl -H "Authorization: ApiKey al_xxxx_xxxxxx" \
     https://alerts.aiforsite.io/api/v1/...

# Bearer-muoto toimii myös
curl -H "Authorization: Bearer al_xxxx_xxxxxx" \
     https://alerts.aiforsite.io/api/v1/...

3. Hälytysten lähetys

Lähetä hälytyksiä Aiforsite Alertsyn mistä tahansa järjestelmästä ingest-API:n kautta.

Perus hälytys

curl -X POST https://alerts.aiforsite.io/api/v1/ingest/ \
  -H "Authorization: ApiKey SINUN_API_AVAIN" \
  -H "Content-Type: application/json" \
  -d '{
    "alerts": [{
      "name": "Korkea CPU-käyttö",
      "message": "Serverin CPU on 95%",
      "level": "warning"
    }]
  }'

Hälytystasot

Täysi esimerkki

{
  "project": {
    "id": "proj-123",
    "name": "Tuotantoserveri"
  },
  "alerts": [{
    "name": "Tietokantayhteys epäonnistui",
    "message": "Ei yhteyttä PostgreSQL:ään",
    "level": "critical"
  }],
  "device": {
    "name": "web-server-01",
    "serial": "ABC123"
  }
}

4. Terveysmonitorit

Tarkista automaattisesti ovatko palvelusi kunnossa.

HTTP-monitorit

Tarkista vastaako HTTP-päätepiste oikein.

• Tarkistettava URL
• Odotettu statuskoodi (oletus: 200)
• Vastauksen tulee sisältää tietty teksti
• Maksimi vasteaika
• Tarkistusväli (5 min - 24 tuntia)

Skriptimonitorit

Aja mukautettuja Python- tai Bash-skriptejä minkä tahansa tarkistamiseen.

#!/bin/bash
# Tarkista levytila
KAYTTO=$(df / | tail -1 | awk '{print $5}' | sed 's/%//')
if [ $KAYTTO -gt 90 ]; then
    echo "Levytila kriittinen: ${KAYTTO}%"
    exit 1
fi
echo "Levy OK: ${KAYTTO}%"
exit 0

Exit code 0 = OK, muu = VIRHE

Hälytysasetukset

• Hälytä N virheen jälkeen - Hälytä vasta peräkkäisten virheiden jälkeen (oletus: 2)
• Palautumishälytykset - Ilmoitus kun palvelu palautuu

5. Heartbeat-valvonta

Valvo cron-jobeja, varmuuskopioita ja ajastettuja tehtäviä. Hälytä jos ne eivät suoriudu ajallaan.

Miten se toimii

1. Luo heartbeat odotetulla intervallilla
2. Saat uniikin ping-URL:n
3. Lisää ping skriptiisi/cron-jobiisi
4. Saat hälytyksen jos ping puuttuu

Esimerkki: Varmuuskopioskripti

#!/bin/bash
# backup.sh

# Aja varmuuskopio
pg_dump mydb > backup.sql

# Pingaa heartbeat onnistumisen jälkeen
curl -s https://alerts.aiforsite.io/api/v1/heartbeat/SINUN_TOKEN/

Crontab-esimerkki

# Aja varmuuskopio päivittäin klo 2, pingaa heartbeat onnistumisen jälkeen
0 2 * * * /opt/scripts/backup.sh && curl -s https://alerts.aiforsite.io/api/v1/heartbeat/SINUN_TOKEN/

Asetukset

• Intervalli - Kuinka usein ping odotetaan
• Grace-aika - Lisäaika ennen hälytystä

6. AI-vahdit

Seuraa verkkosivuja ja saa hälytys kun tietty ehto täyttyy AI-analyysin avulla.

Käyttötapauksia

• Konserttiliput tulevat myyntiin
• Tuote palaa varastoon
• Hinta laskee alle kynnysarvon
• Työpaikkailmoitus ilmestyy
• Uutisartikkeli julkaistaan

Vahdin luominen

1. Mene Admin → Watchers
2. Syötä seurattava URL
3. Kirjoita ehto selkokielellä:
   "Ilmoita kun konserttilippuja tulee myyntiin"
   "Ilmoita jos hinta laskee alle 100€"
4. Aseta tarkistusväli
5. Valitse ilmoituskanavat

Miten se toimii

1. Aiforsite Alerts hakee sivun säännöllisesti
2. Vertaa sisältöä edelliseen versioon
3. AI analysoi täyttyykö ehtosi
4. Lähettää ilmoituksen jos ehto on tosi

Huom: Vaatii OPENAI_API_KEY ympäristömuuttujan.

7. Status-sivu

Julkinen tilasivu joka näyttää palveluidesi terveyden.

Ominaisuudet

• Monitorien ja heartbeatien reaaliaikainen tila
• Uptime-prosentit
• Vasteaikamittarit
• Häiriöhistoria
• Mukautettu brändäys (logo, värit)
• Automaattinen päivitys 60 sekunnin välein

Käyttöönotto

1. Mene Admin → Status Pages
2. Luo uusi status-sivu
3. Valitse URL-slug (esim. status)
4. Valitse näytettävät monitorit ja heartbeatit
5. Jaa URL: https://alerts.aiforsite.io/status/sinun-slug/

JSON API

GET /api/v1/status/sinun-slug/

{
  "title": "Yrityksen Status",
  "overall_status": "operational",
  "monitors": [
    {"name": "API", "status": "ok"},
    {"name": "Verkkosivut", "status": "ok"}
  ],
  "heartbeats": [
    {"name": "Päivittäinen varmuuskopio", "status": "healthy"}
  ]
}

8. Ilmoituskanavat

Määritä minne ja miten saat hälytykset.

Tuetut kanavat

Sähköpostin käyttöönotto (Gmail)

1. Mene Admin → Email Settings
2. Valitse "Gmail SMTP" provider
3. Syötä Gmail-osoitteesi
4. Luo App Password osoitteessa Google-tili
5. Syötä App Password

Slackin käyttöönotto

1. Luo Incoming Webhook Slackissa
2. Mene Admin → Notification Channels
3. Lisää uusi kanava, valitse "Slack"
4. Liitä webhook URL

Tarvitsetko apua?

Ota yhteyttä tukeen tai tarkista GitHub-repositoriomme ongelmien ja päivitysten varalta.