12個監控指標確保API策略成功

發布日期：2024/06/24

隨著公司採用API 優先的設計實踐來建立現代應用，衡量這些API 的運作效能和價值成為當務之急。建立一個可明確定義API 指標並將其與關鍵績效指標(KPI) 掛鉤的框架是確保API 策略成功的最重要步驟之一。

通常情況下，KPI 與具體目標緊密相關。它們有著明確的時間框架，並與API 策略需要交付的成果相符。相較之下，API 指標是重要的數據點。並非所有指標都是KPI，但每個KPI 都基於指標。

那麼您該如何著手呢？首先，您需要從一開始就明確API 策略的目標，然後再選擇與該目標相符的指標。切記每個團隊需要根據對自身的重要性和對業務的必要性來衡量並追蹤不同的指標。

總體來說，公司可追蹤三大類API 指標，並且不同類別的指標反映不同的問題：

  • 維運指標－API 是否提供您所需的穩定性、可靠性和效能？
  • 採納指標－開發人員是否採納使用您的API？
  • 產品指標－API 正如何支援您的業務目標？

您可以把這三大類指標想像成金字塔。底端的運維指標衡量各 API 及其支援性基礎架構的戰術性能。頂端的產品指標衡量 API 創造的業務價值。兩者透過採用指標連結在一起，採用指標追蹤 API 程式在最終用戶（開發人員）中的成長。一般來說，產品指標和採用指標與您需要衡量的業務成效相關，而維運指標則與您需要維護的技術標準相關。

本文詳解了12 個必須衡量的具體指標，介紹了它們如何支援基礎架構和應用團隊，並解釋了這些指標與KPI 的關係。

維運指標

在初始階段，維運指標通常是第一個需要衡量的指標。它們是戰術性指標，可提供有關 API 運作的洞察。維運指標通常不是 KPI。但它們可幫助您衡量團隊所建立軟體的品質和效能，並針對新問題提供早期指標，或幫助您深挖並發現可能影響關鍵 KPI 的問題。

您可以根據團隊和職責追蹤不同的運行指標。

基礎架構團隊

平台維運團隊負責維護、連結並保護不同團隊用於交付應用的基礎架構和技術組合。就 API 程式而言，這通常包括 API 閘道和 API 開發人員入口網站。

平台維運等基礎架構團隊的關鍵指標包括：

  1. 正常運作時間－即使是最基本的指標之一，正常運作時間也是衡量服務可用性的黃金標準。它通常與服務等級協定(SLA) 相關。
  2. CPU 和記憶體使用率－追蹤 API 閘道的資源使用率對於確定何時可能需要擴充執行個體至關重要。它也可作為早期預警指標提示即將發生故障或因錯誤導致使用量激增。
  3. 總通過率和錯誤率－衡量 API 觸發 HTTP 錯誤狀態碼（非200）的頻率可協助您了解 API 的易錯率。這項綜合指標所提供的資訊可協助您判斷您的團隊投入生產的 API 的整體品質。

應用程式團隊

應用團隊由API 開發人員和服務擁有者組成，負責建置和維運各個服務或應用。這些服務或應用程式可用作大型產品的一部分，與合作夥伴產品相集成，或用於給開發人員提供API 即服務。

應用團隊需要衡量以下指標：

  1. 每分鐘請求數－此效能指標衡量您的API 每分鐘處理的請求數。雖然它隨時間變化，但您通常希望限制每分鐘請求數，以確保為API 用戶提供最佳體驗。
  2. 平均和最大延遲—追蹤您的API 接收請求和回傳回應所需的平均時間至關重要。緩慢的API 會對使用者體驗產生不良影響，進而對業務造成不利影響。
  3. 每分鐘錯誤數－真理往往相通，沒有完美的API。出錯無可避免，遲早會發生。您需要監控錯誤，並實施規劃週詳的行動方案將其盡快修復，以免錯誤突然加劇。

請參閱由 NGINX 提供的 O’Reilly 電子書《掌握API 架構》的第3-5 章，深入了解API 操作以及對業務至關重要的KPI 和指標。

採納指標

API 優先的企業不能只著眼於工程指標，還應了解開發人員如何與您的API 互動。您還需要衡量並監控API 開發人員體驗，以確保開發人員採用您的API 並從中獲得價值。

以下列舉幾個採用指標的範例：

  1. 唯一API 消費者－該指標通常透過每月活用戶數量來衡量有多少開發人員正在使用您的API。理想情況下，隨著越來越多的開發人員將您的API 整合到其應用中，這個指標會持續成長。
  2. API 使用量成長－此指標也衡量API 採用率，而且通常是衡量API 採用率的首選指標。理想情況下，隨著更多應用程式和開發人員使用API​​，API 流量會逐月成長。
  3. 首次呼叫時間－此指標衡量開發人員建立帳戶、產生API 憑證和執行首次API 呼叫所需的時間。讓開發人員盡快開啟工作局面是高度優先事項，因此這個指標是衡量整體API 開發人員體驗的最重要指標。

註：我們建議至少有一個KPI 衡量API 採納率。這可協助您推算API 程式的整體成長。例如，您可以設定KPI，追蹤使用您的API 建立持續整合或應用程式的開發人員數量的成長情況。

產品指標

API 產品指標在幫助了解API 的價值方面發揮著重要作用。雖然只有一小部分API 可以帶來直接的營收貢獻，但每個API 都需為企業創造價值。

需要衡量的關鍵產品指標包含：

  1. 直接和間接收入－這些指標衡量API 不同的收入貢獻方式。其中一些 API 可直接變現，另一些支援與業務合作夥伴產品的集成，或對客戶至關重要的第三方集成。與追蹤 API 採用率一樣，追蹤間接收入可協助開發人員為合作夥伴建立創收型應用。
  2. 每個API 的應用數－API 需要可重複使用。這個指標衡量有多少應用程式與API 整合，以了解哪些API 創造的價值最大。
  3. 合作夥伴數量－API 通常支援建立業務關係。追蹤合作夥伴的API 整合數量有助於推動採用，並向其他業務部門展現價值。

注意：這些產品指標與業務影響密切相關，您可以根據自己的業務目標選擇將一些產品指標轉化為KPI。舉例來說，如果您的API 策略的業務目標是透過第三方提供者觸達更多客戶，則可追蹤使用您的API 的合作夥伴數量以及透過這些整合產生的間接收入。

請參閱《掌握API 架構》的第3-5 章，更深入了解API 產品的生命週期，包括業務和維運KPI。

結語

將API 指標和業務KPI 相關聯是企業制定資料驅動型決策並確保API 策略提供所需價值的主要方法之一。此外，實現API 視覺化有助於基礎架構和應用團隊衡量對各自最重要的維運指標。

NGINX 實現了數十個重要API 指標的視覺化。您可以查看即時和歷史指標，並輕鬆地將其匯出至您首選的應用程式效能監控(application performance monitoring, or APM) 或資料分析解決方案。

 

資料來源：F5官網

返回上一頁