本頁說明如何使用 API 指標追蹤及瞭解 Google API 和 Google Cloud API 的用量。
Google API 會產生詳細的使用情況指標,可協助您:
- 追蹤及瞭解 Google API 的用量。
- 監控應用程式和 Google API 的效能。
- 找出應用程式與 Google API 之間的問題。
在您排解問題或需要 Google 技術支援時,這項功能可大幅加快解決問題的速度。
Google API 產生的指標是標準信號,Google 自家的網站穩定性工程師會使用這些信號評估服務的健康狀態。這些指標涵蓋要求計數、錯誤率、總延遲時間、後端延遲時間、要求大小和回應大小。如需 API 指標定義,請參閱 Cloud Monitoring 說明文件。
您可以在兩個地方查看 API 指標:API 資訊主頁和 Cloud Monitoring。您看到的指標是專屬於您專案的資料,不代表整體服務狀態。
使用 API 資訊主頁
如要查看 API 指標,最簡單的方式是使用 Google Cloud 主控台的 API 資訊主頁。您可以查看所有 API 使用情況的總覽,或深入瞭解特定 API 的使用情況。
如要查看 API 使用情況總覽,請按照下列步驟操作:
前往 Cloud Console 的「API 和服務」部分。系統預設會顯示主要 API 資訊主頁。在這個頁面中,您可以查看目前為專案啟用的所有 API,以及下列指標的總覽圖表:
- 流量:專案每秒向已啟用 API 發出的要求數量
- 錯誤:向已啟用 API 發出的要求中,產生錯誤的要求所佔的百分比
- 延遲時間中位數:已啟用 API 的要求延遲時間中位數 (如有)。
如要查看特定 API 的使用情況詳細資料,請按照下列步驟操作:
- 在主要 API 資訊主頁的 API 清單中,選取您要查看的 API。API 的「總覽」頁面會顯示更詳盡的流量圖表,其中包含各個回應碼的細分資料。
如需更詳細的使用情況資訊,請選取「查看指標」。 根據預設,系統會顯示下列預先建立的圖表,不過您也可查看其他圖表:
- 各回應代碼的流量
- 依 API 方法顯示錯誤
- 整體延遲時間的第 50、第 95、和第 99 百分位數
- 依 API 方法顯示延遲時間 (中位數)
如要新增更多圖表,可以從「選取圖形」下拉式選單中選取其他預先建立的圖表。
使用 Cloud Monitoring
如果您使用 Cloud Monitoring,即可透過 Metrics Explorer 深入探索系統提供的指標資料,進一步瞭解您的 API 使用情況。Cloud Monitoring 支援多種指標,您可以搭配篩選器和匯總功能使用,以全新的角度深入瞭解應用程式的效能。例如,您可以搭配篩選器對 HTTP 回應碼類別使用要求數量指標,以建立會顯示錯誤率變化的資訊主頁,或是針對向 Cloud Pub/Sub API 發出的要求查看其延遲時間的第 95 百分位數。