控選型與自建實踐：從探測到告警的完整指南)
簡介API Monitor是一款功能強(qiáng)大的API監(jiān)視工具面向Windows平臺下的軟件開發(fā)者和系統(tǒng)管理員用于實時跟蹤和調(diào)試應(yīng)用程序與系統(tǒng)級接口之間的交互兼容x86與x64架構(gòu)。資源包共含1406個文件壓縮后僅7.25MB主程序負(fù)責(zé)界面與監(jiān)視邏輯sys驅(qū)動和DLL用于底層注入與數(shù)據(jù)捕獲ini配置及txt說明文檔提供服務(wù)設(shè)置與使用指引而1397個xml文件內(nèi)置了大量系統(tǒng)API的函數(shù)原型、參數(shù)定義與結(jié)構(gòu)體信息便于快速檢索。目前已有931人學(xué)習(xí)下載。工具通過DLL注入技術(shù)捕獲目標(biāo)進(jìn)程的API調(diào)用可記錄函數(shù)名稱、參數(shù)值、返回值與調(diào)用時間還支持調(diào)用堆棧查看、日志導(dǎo)出、條件過濾和模擬調(diào)用它不僅能在調(diào)用前后查看和修改參數(shù)還能在無實際環(huán)境時模擬API行為。整個監(jiān)視過程無需修改源代碼或重新編譯可快速定位軟件故障、分析程序與操作系統(tǒng)的交互方式。日志導(dǎo)出功能便于后期分析與分享過濾和搜索則能幫助開發(fā)者聚焦關(guān)鍵API。無論是日常開發(fā)調(diào)試、系統(tǒng)逆向還是性能優(yōu)化這份資源都能提供扎實的工具支撐適合需要深入了解Windows API調(diào)用機(jī)制的工程師。 凌晨三點(diǎn)被電話吵醒說線上某個核心接口開始大批量超時。我爬起來打開監(jiān)控面板首頁、登錄頁全綠負(fù)責(zé)核心接口的機(jī)器CPU占用只有30%。最后靠翻網(wǎng)關(guān)日志才定位到是下游服務(wù)夜里做了配置變更我們這邊所有請求都在等它超時返回。那次之后我把API監(jiān)控從“配個關(guān)鍵字探測”升級成了一整套體系。這事說起來簡單做起來坑不少。尤其是這兩年大模型API普及后很多人寫代碼依賴外部API上游一抖動自己跟著遭殃對API監(jiān)控的需求越來越具體。這篇就把我選型和使用API監(jiān)控工具的經(jīng)驗一次講清楚。1. 先想明白API監(jiān)控和網(wǎng)站監(jiān)控根本不是一回事1.1 網(wǎng)站監(jiān)控只能告訴你“有沒有掛”告訴你不了“為什么慢”很多團(tuán)隊的第一反應(yīng)是把網(wǎng)站監(jiān)控里那套探活配置拿過來用——定時GET一下URL看返回狀態(tài)碼200就是正常。這套做法對付官網(wǎng)、落地頁夠用但拿來監(jiān)控API基本等于盲人摸象。原因在于API的狀態(tài)碼和網(wǎng)頁的狀態(tài)碼含義完全不一樣。網(wǎng)頁掛了大概率是服務(wù)器宕機(jī)、數(shù)據(jù)庫連不上API卻可能在你服務(wù)器一切正常的時候返回4xx、5xx而且API出問題的方式往往是“部分請求失敗、部分成功”延遲從100毫秒突然飆到3秒此時狀態(tài)碼可能還是200面板依然是綠色。我之前遇到的那次凌晨故障就是典型的慢故障——請求全部200但p99延遲從80ms漲到了4.8s用戶體驗已經(jīng)完全不可用了。1.2 API監(jiān)控真正該盯的四個層面做API監(jiān)控我建議至少同時盯住四類指標(biāo)可用性健康檢查端點(diǎn)能否返回預(yù)期狀態(tài)碼。這是最基礎(chǔ)的一層只能發(fā)現(xiàn)“完全掛掉”的問題。正確性響應(yīng)體里的業(yè)務(wù)字段是否符合約定。比如你調(diào)了一個查詢接口期望返回{count: 10}結(jié)果count字段沒返回這比狀態(tài)碼非200更隱蔽也更容易破壞下游邏輯。性能響應(yīng)時間、連接建立時間、首字節(jié)時間重點(diǎn)看p95、p99而不是平均值。平均值會被少數(shù)慢請求掩蓋。錯誤分布4xx、5xx、429、529這類狀態(tài)碼的數(shù)量和占比。429和529這類錯誤有臨時性往往過幾秒就恢復(fù)但積累到一定量說明容量或限流策略有問題。一個合格的工具應(yīng)該能把這四類信息同時采集并關(guān)聯(lián)起來。只給你一個“在線/離線”二選一的工具趁早別用。2. 挑工具前先把這三組概念分清否則你不知道自己要什么2.1 主動探測 VS 被動觀測主動探測是模擬真實用戶去請求API像體檢一樣按固定頻率“敲門”。UptimeRobot、Site24x7、云廠商的撥測都屬這類。被動觀測則是從真實流量里撈數(shù)據(jù)APM工具、網(wǎng)關(guān)日志分析都屬這類。兩者不是替代關(guān)系而是互補(bǔ)主動探測能發(fā)現(xiàn)“外部視角下API斷了”被動觀測能發(fā)現(xiàn)“局部區(qū)域、特定用戶群在變慢”。我見過不少團(tuán)隊只部署了被動觀測結(jié)果外部撥測發(fā)現(xiàn)API超時的時候自己日志里全是200因為流量打到的實例和故障實例不是同一臺。2.2 黑盒監(jiān)控 VS 白盒監(jiān)控黑盒監(jiān)控看不到API內(nèi)部實現(xiàn)只關(guān)心返回結(jié)果白盒監(jiān)控則是在代碼里埋點(diǎn)把函數(shù)執(zhí)行時間、數(shù)據(jù)庫查詢耗時、緩存命中率這些內(nèi)部指標(biāo)暴露出來。選擇的原則其實很直白如果你的API是你自己開發(fā)的白盒必須做因為黑盒只能告訴你“壞了”白盒才能告訴你“為什么壞”如果你的API是第三方提供的你只能做黑盒那就更要把探活頻率和告警鏈路調(diào)好。2.3 一組容易忽略的隱形成本事務(wù)編排大多數(shù)工具都支持“單請求”監(jiān)控但現(xiàn)實中API調(diào)用經(jīng)常是鏈?zhǔn)降摹Ｅe個例子你要監(jiān)控的其實是“登錄拿token → 用token查訂單 → 拿訂單詳情”這條鏈路而不僅僅是其中某一個端點(diǎn)。這類多步驟事務(wù)監(jiān)控很多輕量工具不支持選型時一定要把自己真實的業(yè)務(wù)鏈路列出來對比工具是否支持。3. 值得用的API監(jiān)控工具按場景分成三類來講3.1 自建陣營數(shù)據(jù)自主靈活度高如果你的服務(wù)已經(jīng)跑在Kubernetes或者Docker上第一推薦是Prometheus配合Blackbox Exporter再在Grafana里做可視化。這個組合的優(yōu)勢是數(shù)據(jù)完全在自己手里探針的探測頻率、指標(biāo)定義、告警閾值都可以按需定制。Blackbox Exporter配置起來不復(fù)雜核心是一個模塊定義modules: http_2xx: prober: http timeout: 5s http: valid_status_codes: [200] method: GET follow_redirects: true然后在Prometheus的抓取配置里把需要監(jiān)控的API地址作為Target傳進(jìn)去scrape_configs: - job_name: api_monitor metrics_path: /probe params: module: [http_2xx] static_configs: - targets: - https://api.example.com/health - https://api.example.com/v1/orders relabel_configs: - source_labels: [__address__] target_label: __param_target - source_labels: [__param_target] target_label: instance這套方案的學(xué)習(xí)曲線主要花在PromQL語法上但一旦建好能覆蓋從API可用性到業(yè)務(wù)指標(biāo)的全部監(jiān)控需求。缺點(diǎn)是如果你只是監(jiān)控一個單機(jī)小服務(wù)有點(diǎn)殺雞用牛刀。3.2 SaaS探活陣營幾分鐘搞定外部視角不想自己折騰基礎(chǔ)設(shè)施的話市面上幾款老牌SaaS探活工具都比較成熟工具免費(fèi)額度探測頻率特色UptimeRobot50個監(jiān)控點(diǎn)5分鐘間隔最低1分鐘付費(fèi)配置極簡能查關(guān)鍵字和狀態(tài)碼Pingdom無免費(fèi)試用30天可選1/5/15分鐘全球探測節(jié)點(diǎn)多報表專業(yè)適合對外展示SLABetter Uptime免費(fèi)10個監(jiān)控點(diǎn)1分鐘/5分鐘付費(fèi)狀態(tài)頁和告警分派做得好適合對外客戶可見的服務(wù)國內(nèi)云廠商撥測部分免費(fèi)額度分鐘級和自家云產(chǎn)品集成方便適合服務(wù)已部署在其上的場景這類工具最大的價值是提供了一個獨(dú)立的第三方視角不受你自身網(wǎng)絡(luò)環(huán)境影響。我習(xí)慣的做法是自建監(jiān)控為主再挑一個SaaS做交叉驗證真出了故障兩者同時告警確認(rèn)度會高很多。3.3 全鏈路可觀測性平臺監(jiān)控只是其中一項能力Datadog、New Relic這類平臺API監(jiān)控只是它們龐大能力圖譜里的一小部分。它們能把前端用戶體驗、后端請求、數(shù)據(jù)庫慢查詢、日志、鏈路追蹤全部串聯(lián)起來。如果公司預(yù)算充足且技術(shù)棧相對統(tǒng)一這類一體化平臺能省掉大量內(nèi)部工具集成的時間。但說實話這類平臺用在“純API外部監(jiān)控”上有點(diǎn)浪費(fèi)。它們更適合已經(jīng)有APM、日志、鏈路追蹤需求的團(tuán)隊監(jiān)控API順手一起做了。如果你只是缺一個簡單的外部探活不用上這種重武器。4. 自建一套最小可用API監(jiān)控的完整過程既然說到了自建方案我把落地過程中每個關(guān)鍵步驟和踩坑點(diǎn)都過一遍照著抄可以直接用。4.1 寫一個能“帶校驗”的探測腳本只檢查HTTP狀態(tài)碼遠(yuǎn)遠(yuǎn)不夠我把腳本寫成可以校驗響應(yīng)體關(guān)鍵字。比如監(jiān)控一個訂單查詢接口我們希望它返回的JSON里含orderId和status兩個字段import json import time import urllib.request import urllib.error def check_api(url, expect_keys): start time.time() req urllib.request.Request(url, headers{User-Agent: api-monitor/1.0}) try: with urllib.request.urlopen(req, timeout5) as resp: body resp.read().decode(utf-8) latency (time.time() - start) * 1000 if resp.status ! 200: return {ok: False, reason: fhttp_{resp.status}, latency: latency} data json.loads(body) for key in expect_keys: if key not in data: return {ok: False, reason: fmissing_key_{key}, latency: latency} return {ok: True, latency: latency} except urllib.error.HTTPError as e: return {ok: False, reason: fhttp_{e.code}, latency: -1} except Exception as e: return {ok: False, reason: type(e).__name__, latency: -1}腳本里面有兩個細(xì)節(jié)值得注意超時時間設(shè)為5秒。如果API的SLA本來就是1秒探活腳本的超時最好設(shè)成SLA的3-5倍而不是無限等。異常里面捕獲了HTTPError之外的通用異常這是為了防止DNS解析失敗、TLS握手失敗、連接被拒絕這類“非HTTP但就是不可用”的情況它們往往不在狀態(tài)碼里體現(xiàn)。4.2 把腳本接進(jìn)Prometheus形成長期趨勢有了腳本還不夠需要讓它按固定頻率執(zhí)行并把結(jié)果暴露為Prometheus指標(biāo)。最省事的做法是寫一個HTTP接口內(nèi)部執(zhí)行上述檢查返回probe_success、probe_duration_ms這些值。我更推薦的做法是直接把探針邏輯交給Blackbox Exporter它天生支持probe_success、probe_duration_seconds、probe_http_status_code等指標(biāo)Prometheus一拉就齊了。無論用哪種方案最終你要能在Grafana上看到三個面板成功率時間序列、延遲p95/p99、錯誤狀態(tài)碼分布。這三個面板就能覆蓋我前面說的四類監(jiān)控指標(biāo)中的三席剩下的“正確性”靠腳本里的字段校驗來兜底。4.3 告警規(guī)則這么配才不容易誤報告警規(guī)則是整個監(jiān)控體系里最容易翻車的地方。我給自己的生產(chǎn)環(huán)境配置的規(guī)則很簡單groups: - name: api_alert rules: - alert: APIProbeDown expr: probe_success{jobapi_monitor} 0 for: 3m labels: severity: critical annotations: summary: {{ $labels.instance }} 探活失敗持續(xù)3分鐘 - alert: APIHighLatency expr: probe_duration_seconds{jobapi_monitor} 2 for: 5m labels: severity: warning annotations: summary: {{ $labels.instance }} 響應(yīng)時間超過2秒這里有個關(guān)鍵配置for: 3m。意思是“持續(xù)3分鐘都失敗才觸發(fā)告警”。別小看這個字段很多剛上手的人不寫它導(dǎo)致API抖動幾百毫秒就瘋狂收到告警三天下來沒人愿意再看告警等于整個監(jiān)控體系白做了。告警是要讓人看并且相信的寧可延遲幾分鐘確認(rèn)也不要狼來了。4.4 通知頻道怎么接Prometheus自帶Alertmanager支持郵件、Webhook、釘釘、企業(yè)微信、Slack這些。我個人的經(jīng)驗是告警信息里必須帶這兩樣?xùn)|西一個是具體的實例地址一個是當(dāng)前值。否則每個人都得點(diǎn)進(jìn)Grafana查一遍效率極低。如果是用SaaS探活工具它們大多內(nèi)置了狀態(tài)頁和通知分組按嚴(yán)重級別把告警發(fā)給不同的人。這里提醒一句不要所有告警都發(fā)給同一個群核心接口的故障和某個邊緣接口的降級處理優(yōu)先級完全不一樣。5. 把閾值調(diào)穩(wěn)的幾個技巧都是拿事故換來的5.1 區(qū)分“偶發(fā)失敗”和“持續(xù)故障”API監(jiān)控里最讓人頭疼的是偶發(fā)失敗。比如第三方API偶爾返回529 Overloaded、超時、或者連接被重置這類錯誤通常是暫時的你還沒定位完原因它就恢復(fù)了。如果每出現(xiàn)一次就告警你的手機(jī)一夜之間能收到上百條消息。我的處理方式是對偶發(fā)錯誤不告警只記錄當(dāng)同一實例或同一錯誤類型在10分鐘內(nèi)出現(xiàn)次數(shù)超過閾值比如5次才觸發(fā)告警。在Prometheus里可以用increase()或count_over_time()函數(shù)實現(xiàn)。在SaaS工具里通常有“連續(xù)失敗N次才告警”的選項一定要打開。5.2 證書、DNS和過期域名這些不算業(yè)務(wù)故障但最容易誤報我自己踩過最冤枉的一次域名證書到期沒及時續(xù)探活腳本持續(xù)報錯業(yè)務(wù)側(cè)其實一切正常。從那次之后我在探活腳本里單獨(dú)加了證書剩余天數(shù)檢查并和業(yè)務(wù)可用性告警分開管理。證書問題是提前可預(yù)見的應(yīng)該在到期前30天、7天分別給運(yùn)維發(fā)提醒而不是等到探活失敗才慌慌張張去處理。同樣DNS解析失敗和API服務(wù)器本身的問題也要能在告警信息里區(qū)分出來。否則排查人員對著一條“API不可用”的告警得先分辨是DNS掛還是服務(wù)掛白白浪費(fèi)黃金恢復(fù)時間。5.3 把探針部署到和用戶相同的位置這個原則看似簡單執(zhí)行起來容易偷懶。如果App用戶都在國內(nèi)探針節(jié)點(diǎn)放在海外探測結(jié)果完全不代表用戶體驗如果用戶分散在不同地區(qū)應(yīng)該在多個地域部署探針收集到各地區(qū)差異化的延遲數(shù)據(jù)。SaaS撥測工具的優(yōu)勢就在這里選擇離你用戶群體最近的地域節(jié)點(diǎn)能更早發(fā)現(xiàn)地域性的網(wǎng)絡(luò)問題。5.4 定期做一次“監(jiān)控演練”最后一條建議看上去和選型無關(guān)但非常值回票價。每季度挑一個工作日低峰期在灰度環(huán)境故意制造一次故障——比如把核心接口的響應(yīng)時間人為加慢3秒、或者停掉某個下游依賴——看看監(jiān)控能不能準(zhǔn)確發(fā)現(xiàn)、告警能不能準(zhǔn)時觸達(dá)、值班的人能不能按應(yīng)急預(yù)案定位問題。我參與過的團(tuán)隊里做過演練和沒做過演練的真實故障時的平均恢復(fù)時間差了一倍都不止。工具配得再好人不熟悉流程一切等于零。我現(xiàn)在各個項目的標(biāo)配是自建Prometheus加Blackbox探針做主監(jiān)控配一個SaaS探活做獨(dú)立視角告警按嚴(yán)重級別分開再加上定期的故障演練。這套組合不是最省事的但扛過幾輪真實故障之后你會發(fā)現(xiàn)在API監(jiān)控上投入的時間每一分鐘都值了。本文還有配套的精品資源點(diǎn)擊獲取 API監(jiān)控選型與自建實踐：從探測到告警的完整指南
簡介API Monitor是一款功能強(qiáng)大的API監(jiān)視工具面向Windows平臺下的軟件開發(fā)者和系統(tǒng)管理員用于實時跟蹤和調(diào)試應(yīng)用程序與系統(tǒng)級接口之間的交互兼容x86與x64架構(gòu)。資源包共含1406個文件壓縮后僅7.25MB主程序負(fù)責(zé)界面與監(jiān)視邏輯sys驅(qū)動和DLL用于底層注入與數(shù)據(jù)捕獲ini配置及txt說明文檔提供服務(wù)設(shè)置與使用指引而1397個xml文件內(nèi)置了大量系統(tǒng)API的函數(shù)原型、參數(shù)定義與結(jié)構(gòu)體信息便于快速檢索。目前已有931人學(xué)習(xí)下載。工具通過DLL注入技術(shù)捕獲目標(biāo)進(jìn)程的API調(diào)用可記錄函數(shù)名稱、參數(shù)值、返回值與調(diào)用時間還支持調(diào)用堆棧查看、日志導(dǎo)出、條件過濾和模擬調(diào)用它不僅能在調(diào)用前后查看和修改參數(shù)還能在無實際環(huán)境時模擬API行為。整個監(jiān)視過程無需修改源代碼或重新編譯可快速定位軟件故障、分析程序與操作系統(tǒng)的交互方式。日志導(dǎo)出功能便于后期分析與分享過濾和搜索則能幫助開發(fā)者聚焦關(guān)鍵API。無論是日常開發(fā)調(diào)試、系統(tǒng)逆向還是性能優(yōu)化這份資源都能提供扎實的工具支撐適合需要深入了解Windows API調(diào)用機(jī)制的工程師。 凌晨三點(diǎn)被電話吵醒說線上某個核心接口開始大批量超時。我爬起來打開監(jiān)控面板首頁、登錄頁全綠負(fù)責(zé)核心接口的機(jī)器CPU占用只有30%。最后靠翻網(wǎng)關(guān)日志才定位到是下游服務(wù)夜里做了配置變更我們這邊所有請求都在等它超時返回。那次之后我把API監(jiān)控從“配個關(guān)鍵字探測”升級成了一整套體系。這事說起來簡單做起來坑不少。尤其是這兩年大模型API普及后很多人寫代碼依賴外部API上游一抖動自己跟著遭殃對API監(jiān)控的需求越來越具體。這篇就把我選型和使用API監(jiān)控工具的經(jīng)驗一次講清楚。1. 先想明白API監(jiān)控和網(wǎng)站監(jiān)控根本不是一回事1.1 網(wǎng)站監(jiān)控只能告訴你“有沒有掛”告訴你不了“為什么慢”很多團(tuán)隊的第一反應(yīng)是把網(wǎng)站監(jiān)控里那套探活配置拿過來用——定時GET一下URL看返回狀態(tài)碼200就是正常。這套做法對付官網(wǎng)、落地頁夠用但拿來監(jiān)控API基本等于盲人摸象。原因在于API的狀態(tài)碼和網(wǎng)頁的狀態(tài)碼含義完全不一樣。網(wǎng)頁掛了大概率是服務(wù)器宕機(jī)、數(shù)據(jù)庫連不上API卻可能在你服務(wù)器一切正常的時候返回4xx、5xx而且API出問題的方式往往是“部分請求失敗、部分成功”延遲從100毫秒突然飆到3秒此時狀態(tài)碼可能還是200面板依然是綠色。我之前遇到的那次凌晨故障就是典型的慢故障——請求全部200但p99延遲從80ms漲到了4.8s用戶體驗已經(jīng)完全不可用了。1.2 API監(jiān)控真正該盯的四個層面做API監(jiān)控我建議至少同時盯住四類指標(biāo)可用性健康檢查端點(diǎn)能否返回預(yù)期狀態(tài)碼。這是最基礎(chǔ)的一層只能發(fā)現(xiàn)“完全掛掉”的問題。正確性響應(yīng)體里的業(yè)務(wù)字段是否符合約定。比如你調(diào)了一個查詢接口期望返回{count: 10}結(jié)果count字段沒返回這比狀態(tài)碼非200更隱蔽也更容易破壞下游邏輯。性能響應(yīng)時間、連接建立時間、首字節(jié)時間重點(diǎn)看p95、p99而不是平均值。平均值會被少數(shù)慢請求掩蓋。錯誤分布4xx、5xx、429、529這類狀態(tài)碼的數(shù)量和占比。429和529這類錯誤有臨時性往往過幾秒就恢復(fù)但積累到一定量說明容量或限流策略有問題。一個合格的工具應(yīng)該能把這四類信息同時采集并關(guān)聯(lián)起來。只給你一個“在線/離線”二選一的工具趁早別用。2. 挑工具前先把這三組概念分清否則你不知道自己要什么2.1 主動探測 VS 被動觀測主動探測是模擬真實用戶去請求API像體檢一樣按固定頻率“敲門”。UptimeRobot、Site24x7、云廠商的撥測都屬這類。被動觀測則是從真實流量里撈數(shù)據(jù)APM工具、網(wǎng)關(guān)日志分析都屬這類。兩者不是替代關(guān)系而是互補(bǔ)主動探測能發(fā)現(xiàn)“外部視角下API斷了”被動觀測能發(fā)現(xiàn)“局部區(qū)域、特定用戶群在變慢”。我見過不少團(tuán)隊只部署了被動觀測結(jié)果外部撥測發(fā)現(xiàn)API超時的時候自己日志里全是200因為流量打到的實例和故障實例不是同一臺。2.2 黑盒監(jiān)控 VS 白盒監(jiān)控黑盒監(jiān)控看不到API內(nèi)部實現(xiàn)只關(guān)心返回結(jié)果白盒監(jiān)控則是在代碼里埋點(diǎn)把函數(shù)執(zhí)行時間、數(shù)據(jù)庫查詢耗時、緩存命中率這些內(nèi)部指標(biāo)暴露出來。選擇的原則其實很直白如果你的API是你自己開發(fā)的白盒必須做因為黑盒只能告訴你“壞了”白盒才能告訴你“為什么壞”如果你的API是第三方提供的你只能做黑盒那就更要把探活頻率和告警鏈路調(diào)好。2.3 一組容易忽略的隱形成本事務(wù)編排大多數(shù)工具都支持“單請求”監(jiān)控但現(xiàn)實中API調(diào)用經(jīng)常是鏈?zhǔn)降摹Ｅe個例子你要監(jiān)控的其實是“登錄拿token → 用token查訂單 → 拿訂單詳情”這條鏈路而不僅僅是其中某一個端點(diǎn)。這類多步驟事務(wù)監(jiān)控很多輕量工具不支持選型時一定要把自己真實的業(yè)務(wù)鏈路列出來對比工具是否支持。3. 值得用的API監(jiān)控工具按場景分成三類來講3.1 自建陣營數(shù)據(jù)自主靈活度高如果你的服務(wù)已經(jīng)跑在Kubernetes或者Docker上第一推薦是Prometheus配合Blackbox Exporter再在Grafana里做可視化。這個組合的優(yōu)勢是數(shù)據(jù)完全在自己手里探針的探測頻率、指標(biāo)定義、告警閾值都可以按需定制。Blackbox Exporter配置起來不復(fù)雜核心是一個模塊定義modules: http_2xx: prober: http timeout: 5s http: valid_status_codes: [200] method: GET follow_redirects: true然后在Prometheus的抓取配置里把需要監(jiān)控的API地址作為Target傳進(jìn)去scrape_configs: - job_name: api_monitor metrics_path: /probe params: module: [http_2xx] static_configs: - targets: - https://api.example.com/health - https://api.example.com/v1/orders relabel_configs: - source_labels: [__address__] target_label: __param_target - source_labels: [__param_target] target_label: instance這套方案的學(xué)習(xí)曲線主要花在PromQL語法上但一旦建好能覆蓋從API可用性到業(yè)務(wù)指標(biāo)的全部監(jiān)控需求。缺點(diǎn)是如果你只是監(jiān)控一個單機(jī)小服務(wù)有點(diǎn)殺雞用牛刀。3.2 SaaS探活陣營幾分鐘搞定外部視角不想自己折騰基礎(chǔ)設(shè)施的話市面上幾款老牌SaaS探活工具都比較成熟工具免費(fèi)額度探測頻率特色UptimeRobot50個監(jiān)控點(diǎn)5分鐘間隔最低1分鐘付費(fèi)配置極簡能查關(guān)鍵字和狀態(tài)碼Pingdom無免費(fèi)試用30天可選1/5/15分鐘全球探測節(jié)點(diǎn)多報表專業(yè)適合對外展示SLABetter Uptime免費(fèi)10個監(jiān)控點(diǎn)1分鐘/5分鐘付費(fèi)狀態(tài)頁和告警分派做得好適合對外客戶可見的服務(wù)國內(nèi)云廠商撥測部分免費(fèi)額度分鐘級和自家云產(chǎn)品集成方便適合服務(wù)已部署在其上的場景這類工具最大的價值是提供了一個獨(dú)立的第三方視角不受你自身網(wǎng)絡(luò)環(huán)境影響。我習(xí)慣的做法是自建監(jiān)控為主再挑一個SaaS做交叉驗證真出了故障兩者同時告警確認(rèn)度會高很多。3.3 全鏈路可觀測性平臺監(jiān)控只是其中一項能力Datadog、New Relic這類平臺API監(jiān)控只是它們龐大能力圖譜里的一小部分。它們能把前端用戶體驗、后端請求、數(shù)據(jù)庫慢查詢、日志、鏈路追蹤全部串聯(lián)起來。如果公司預(yù)算充足且技術(shù)棧相對統(tǒng)一這類一體化平臺能省掉大量內(nèi)部工具集成的時間。但說實話這類平臺用在“純API外部監(jiān)控”上有點(diǎn)浪費(fèi)。它們更適合已經(jīng)有APM、日志、鏈路追蹤需求的團(tuán)隊監(jiān)控API順手一起做了。如果你只是缺一個簡單的外部探活不用上這種重武器。4. 自建一套最小可用API監(jiān)控的完整過程既然說到了自建方案我把落地過程中每個關(guān)鍵步驟和踩坑點(diǎn)都過一遍照著抄可以直接用。4.1 寫一個能“帶校驗”的探測腳本只檢查HTTP狀態(tài)碼遠(yuǎn)遠(yuǎn)不夠我把腳本寫成可以校驗響應(yīng)體關(guān)鍵字。比如監(jiān)控一個訂單查詢接口我們希望它返回的JSON里含orderId和status兩個字段import json import time import urllib.request import urllib.error def check_api(url, expect_keys): start time.time() req urllib.request.Request(url, headers{User-Agent: api-monitor/1.0}) try: with urllib.request.urlopen(req, timeout5) as resp: body resp.read().decode(utf-8) latency (time.time() - start) * 1000 if resp.status ! 200: return {ok: False, reason: fhttp_{resp.status}, latency: latency} data json.loads(body) for key in expect_keys: if key not in data: return {ok: False, reason: fmissing_key_{key}, latency: latency} return {ok: True, latency: latency} except urllib.error.HTTPError as e: return {ok: False, reason: fhttp_{e.code}, latency: -1} except Exception as e: return {ok: False, reason: type(e).__name__, latency: -1}腳本里面有兩個細(xì)節(jié)值得注意超時時間設(shè)為5秒。如果API的SLA本來就是1秒探活腳本的超時最好設(shè)成SLA的3-5倍而不是無限等。異常里面捕獲了HTTPError之外的通用異常這是為了防止DNS解析失敗、TLS握手失敗、連接被拒絕這類“非HTTP但就是不可用”的情況它們往往不在狀態(tài)碼里體現(xiàn)。4.2 把腳本接進(jìn)Prometheus形成長期趨勢有了腳本還不夠需要讓它按固定頻率執(zhí)行并把結(jié)果暴露為Prometheus指標(biāo)。最省事的做法是寫一個HTTP接口內(nèi)部執(zhí)行上述檢查返回probe_success、probe_duration_ms這些值。我更推薦的做法是直接把探針邏輯交給Blackbox Exporter它天生支持probe_success、probe_duration_seconds、probe_http_status_code等指標(biāo)Prometheus一拉就齊了。無論用哪種方案最終你要能在Grafana上看到三個面板成功率時間序列、延遲p95/p99、錯誤狀態(tài)碼分布。這三個面板就能覆蓋我前面說的四類監(jiān)控指標(biāo)中的三席剩下的“正確性”靠腳本里的字段校驗來兜底。4.3 告警規(guī)則這么配才不容易誤報告警規(guī)則是整個監(jiān)控體系里最容易翻車的地方。我給自己的生產(chǎn)環(huán)境配置的規(guī)則很簡單groups: - name: api_alert rules: - alert: APIProbeDown expr: probe_success{jobapi_monitor} 0 for: 3m labels: severity: critical annotations: summary: {{ $labels.instance }} 探活失敗持續(xù)3分鐘 - alert: APIHighLatency expr: probe_duration_seconds{jobapi_monitor} 2 for: 5m labels: severity: warning annotations: summary: {{ $labels.instance }} 響應(yīng)時間超過2秒這里有個關(guān)鍵配置for: 3m。意思是“持續(xù)3分鐘都失敗才觸發(fā)告警”。別小看這個字段很多剛上手的人不寫它導(dǎo)致API抖動幾百毫秒就瘋狂收到告警三天下來沒人愿意再看告警等于整個監(jiān)控體系白做了。告警是要讓人看并且相信的寧可延遲幾分鐘確認(rèn)也不要狼來了。4.4 通知頻道怎么接Prometheus自帶Alertmanager支持郵件、Webhook、釘釘、企業(yè)微信、Slack這些。我個人的經(jīng)驗是告警信息里必須帶這兩樣?xùn)|西一個是具體的實例地址一個是當(dāng)前值。否則每個人都得點(diǎn)進(jìn)Grafana查一遍效率極低。如果是用SaaS探活工具它們大多內(nèi)置了狀態(tài)頁和通知分組按嚴(yán)重級別把告警發(fā)給不同的人。這里提醒一句不要所有告警都發(fā)給同一個群核心接口的故障和某個邊緣接口的降級處理優(yōu)先級完全不一樣。5. 把閾值調(diào)穩(wěn)的幾個技巧都是拿事故換來的5.1 區(qū)分“偶發(fā)失敗”和“持續(xù)故障”API監(jiān)控里最讓人頭疼的是偶發(fā)失敗。比如第三方API偶爾返回529 Overloaded、超時、或者連接被重置這類錯誤通常是暫時的你還沒定位完原因它就恢復(fù)了。如果每出現(xiàn)一次就告警你的手機(jī)一夜之間能收到上百條消息。我的處理方式是對偶發(fā)錯誤不告警只記錄當(dāng)同一實例或同一錯誤類型在10分鐘內(nèi)出現(xiàn)次數(shù)超過閾值比如5次才觸發(fā)告警。在Prometheus里可以用increase()或count_over_time()函數(shù)實現(xiàn)。在SaaS工具里通常有“連續(xù)失敗N次才告警”的選項一定要打開。5.2 證書、DNS和過期域名這些不算業(yè)務(wù)故障但最容易誤報我自己踩過最冤枉的一次域名證書到期沒及時續(xù)探活腳本持續(xù)報錯業(yè)務(wù)側(cè)其實一切正常。從那次之后我在探活腳本里單獨(dú)加了證書剩余天數(shù)檢查并和業(yè)務(wù)可用性告警分開管理。證書問題是提前可預(yù)見的應(yīng)該在到期前30天、7天分別給運(yùn)維發(fā)提醒而不是等到探活失敗才慌慌張張去處理。同樣DNS解析失敗和API服務(wù)器本身的問題也要能在告警信息里區(qū)分出來。否則排查人員對著一條“API不可用”的告警得先分辨是DNS掛還是服務(wù)掛白白浪費(fèi)黃金恢復(fù)時間。5.3 把探針部署到和用戶相同的位置這個原則看似簡單執(zhí)行起來容易偷懶。如果App用戶都在國內(nèi)探針節(jié)點(diǎn)放在海外探測結(jié)果完全不代表用戶體驗如果用戶分散在不同地區(qū)應(yīng)該在多個地域部署探針收集到各地區(qū)差異化的延遲數(shù)據(jù)。SaaS撥測工具的優(yōu)勢就在這里選擇離你用戶群體最近的地域節(jié)點(diǎn)能更早發(fā)現(xiàn)地域性的網(wǎng)絡(luò)問題。5.4 定期做一次“監(jiān)控演練”最后一條建議看上去和選型無關(guān)但非常值回票價。每季度挑一個工作日低峰期在灰度環(huán)境故意制造一次故障——比如把核心接口的響應(yīng)時間人為加慢3秒、或者停掉某個下游依賴——看看監(jiān)控能不能準(zhǔn)確發(fā)現(xiàn)、告警能不能準(zhǔn)時觸達(dá)、值班的人能不能按應(yīng)急預(yù)案定位問題。我參與過的團(tuán)隊里做過演練和沒做過演練的真實故障時的平均恢復(fù)時間差了一倍都不止。工具配得再好人不熟悉流程一切等于零。我現(xiàn)在各個項目的標(biāo)配是自建Prometheus加Blackbox探針做主監(jiān)控配一個SaaS探活做獨(dú)立視角告警按嚴(yán)重級別分開再加上定期的故障演練。這套組合不是最省事的但扛過幾輪真實故障之后你會發(fā)現(xiàn)在API監(jiān)控上投入的時間每一分鐘都值了。本文還有配套的精品資源點(diǎn)擊獲取