Monitoring uptime sterowany ze skryptu

Otwórz okno serwisowe z pipeline'u i zamknij je po zakończeniu deployu. Okno ma maksymalną długość, więc job, który padnie w połowie, nie wyciszy Twoich monitorów na zawsze.

# before the deploy: mute alerts for at most 15 minutes
START=$(date -u +%FT%TZ); END=$(date -u -d "+15 min" +%FT%TZ)
WINDOW_ID=$(curl -fsS -X POST https://api.alertsleep.com/public/v1/maintenance-windows \
  -H "AuthToken: $ALERTSLEEP_TOKEN" -H "Content-Type: application/json" \
  -d "{\"title\":\"Deploy $CI_COMMIT_SHORT_SHA\",\"starts_at\":\"$START\",
       \"ends_at\":\"$END\",\"monitor_ids\":[\"$MONITOR_ID\"]}" \
  | jq -r .maintenance_window.id)

./deploy.sh

# after it: end the window early
curl -fsS -X POST https://api.alertsleep.com/public/v1/maintenance-windows/$WINDOW_ID/end \
  -H "AuthToken: $ALERTSLEEP_TOKEN"

Wywołaj /start, gdy zadanie rusza, żeby wyłapać także przebieg, który się zawiesi, a sam adres URL, gdy zakończy się sukcesem. Przy błędzie wywołaj /fail z kodem wyjścia, a e-mail wyjdzie od razu, a nie dopiero po okresie karencji.

# crontab: alert me if the nightly backup fails or never runs
# (one line in crontab)
0 3 * * * curl -fsS https://api.alertsleep.com/v1/ping/YOUR-TOKEN/start; /usr/local/bin/backup.sh && curl -fsS https://api.alertsleep.com/v1/ping/YOUR-TOKEN || curl -fsS https://api.alertsleep.com/v1/ping/YOUR-TOKEN/fail -d exit_code=$?

Integracja webhook wysyła JSON przy monitor.down, monitor.up i zdarzeniach certyfikatu. Gdy ustawisz sekret, każde zapytanie niesie podpis HMAC-SHA256 obejmujący znacznik czasu i treść, więc możesz odrzucać podrobione i powtórzone wywołania.

// Node: verify an AlertSleep webhook
const ts = req.headers['x-alertsleep-timestamp'];
const expected = 'sha256=' + crypto
  .createHmac('sha256', process.env.ALERTSLEEP_SECRET)
  .update(ts + '.' + rawBody).digest('hex');
const ok = crypto.timingSafeEqual(
  Buffer.from(expected),
  Buffer.from(req.headers['x-alertsleep-signature']));

// body: {"version":1,"event":"monitor.down",
//   "sent_at":"…","resource":{…},
//   "data":{"status":"down","reason":"HTTP 503 …"}}

Każda publiczna strona statusu ma badge SVG z bieżącym stanem albo dostępnością z 30 dni, z linkiem do tej strony.

<!-- README.md -->
[![Status](https://status.alertsleep.com/your-page/badge.svg)](https://status.alertsleep.com/your-page)

<!-- 30-day uptime instead of the current state -->
![Uptime](https://status.alertsleep.com/your-page/badge.svg?type=uptime)