服務狀態與可用率¶
FinMind 提供對外即時狀態頁:
該頁顯示 API 目前狀態、過去 24 小時與 90 天的可用率(uptime),以及歷史事件紀錄。
此可用率即 FinMind 企業方案 SLA 的衡量基準——企業客戶的服務水準以同一套逐分鐘演算法衡量,與狀態頁所呈現者一致透明。
可用率怎麼計算¶
可用率以真實 API 流量、逐分鐘衡量。完整公式鏈如下:
1. 有效請求
- server-side error 指 HTTP 5xx 回應,以及因伺服器端逾時而中斷的連線(HTTP 499;多半是伺服器忙碌/變慢造成連線被中斷,視為伺服器端問題)。
- 一般 client error(例如
400/403/404/429等請求端錯誤,不含 499)不計入有效請求,也不影響可用率。
2. 逐分鐘錯誤率
- 某分鐘有流量且錯誤率 > 5%,該分鐘即記為 down(中斷)。
- 沒有流量的分鐘不計入可用率。
3. 可用率
- 24 小時與 90 天數字由上述逐分鐘結果彙總;90 天與當月數字以有流量分鐘加權。
- 計畫性維護時段可排除,不計入中斷。
狀態分級¶
某時間窗有流量時,依該窗的可用率分為四級:
| 狀態 | 可用率門檻 |
|---|---|
| Operational | 100%(有流量且無任何中斷分鐘) |
| Degraded Performance | ≥ 99%(有中斷分鐘,但可用率仍 ≥ 99%) |
| Partial Outage | 95% ~ 99%(95% ≤ 可用率 < 99%) |
| Major Outage | < 95% |
| No data | 該區間沒有流量 |
Tip
狀態頁底部也內含同樣的「How uptime is calculated」說明,可隨時查閱。