标签为“health check”的页面如下
Post
Ch5 - APISIX 健康檢查:告別「白跑一趟」,讓你的服務聰明運作!
本系列文章於2025年,已在iT邦幫忙:【與雲原生精靈共舞:APISIX使用者的兩年旅程】發布過。
就像是出去玩要先查店家有沒有開,可以透過直接打電話給店家、請朋友先協助確認等成本比較低的方式。在服務檢查部分,通常使用「Health Check」。

APISIX提供「主動」和「被動」的檢查機制。
- 主動:就是定期檢查上游服務節點是否健康。
- 被動:只有有請求要轉發時,才檢查並記錄。
建立健康檢查端點
爲了提供APISIX健康檢查端點,我們在「新竹百貨公司」服務節點下,再添加一個檔案充當健康檢查結果,那麼就直接取名這個檔案叫做health.json:
{"status": "health"}
接著可以透過檢查 http://新竹百貨公司.com:9080/health.json 來檢查健康狀態。(可將端口改成特定節點監聽端口,以檢查特定節點的健康狀態)
示範上設計簡單一點:只要有回傳檔案,HTTP回應狀態碼是200或201就是健康;反之找不到檔案,回應狀態碼是404就是不健康。
設定主動檢查
| 欄位 | 值 | 備註 |
|---|---|---|
| HTTP Path | /health.json | 健康檢查端點 |
| Interval | 1 | 檢查間格(秒) |
| Successes | 2 | 連續成功2次數健康後,視爲節點健康。恢復轉發請求。 |
| HTTP Status | 200 | 回應狀態爲200視爲健康 |