v0.1.0

告警規則

最後更新


本頁說明 go-web-monitor 何時寄出離線告警、失敗計數如何累積與歸零,以及告警信的內容。

失敗計數


每個網站在 .webMonitor.json 有一個 count 欄位,記錄連續離線次數。每輪檢查後依下表更新(internal/service/monitor.go:159):
本輪結果原計數動作新計數
上線任意無0
離線0–3無原計數 + 1
離線4寄出告警0

條件寫法是 (count+1)%5 == 0;由於計數在第 5 次時歸零,實際效果是「每累積 5 次連續離線寄一次」。
stateDiagram-v2
    [*] --> Healthy
    Healthy: 上線(count = 0)
    Failing: 離線(count 1–4)
    Healthy --> Failing: 離線
    Failing --> Failing: 離線且 count < 4
    Failing --> Healthy: 上線
    Failing --> Alerted: 第 5 次離線
    Alerted: 寄出告警,count 歸零
    Alerted --> Failing: 仍離線
    Alerted --> Healthy: 上線
  1. stateDiagram-v2
  2. [*] --> Healthy
  3. Healthy: 上線(count = 0)
  4. Failing: 離線(count 1–4)
  5. Healthy --> Failing: 離線
  6. Failing --> Failing: 離線且 count < 4
  7. Failing --> Healthy: 上線
  8. Failing --> Alerted: 第 5 次離線
  9. Alerted: 寄出告警,count 歸零
  10. Alerted --> Failing: 仍離線
  11. Alerted --> Healthy: 上線

告警頻率


情境結果
網站短暫離線 1–4 分鐘後恢復不寄信
網站持續離線約第 5、10、15... 分鐘各寄一次
手動 refresh也算一輪,會加速累積

告警不會在網站恢復上線時寄出「恢復通知」。

告警信內容


欄位值
主旨Website Offline Alert: <url>
格式HTML(Content-Type: text/html; charset=UTF-8)
內文網址、Status: Offline、Reason: HTTP <code>、檢查時間

Reason 中的狀態碼在連線失敗時為 HTTP 0。

寄送條件


告警以背景 goroutine 呼叫 SMTP.SendEmail(),下列任一不成立時不會寄出,錯誤只寫到 stderr(slog):
  • enabled 為 true
  • host 已設定
  • to 至少一個收件者

SMTP 的設定方式見 設定 Email 告警,連線細節見 SMTP 連線。
EN