App Optimize API 總覽

使用 App Optimize API 瞭解 Google Cloud 支出和資源用量。 開發人員和管理員可透過這個 API，以程式輔助方式擷取詳細的費用和用量資料，並將這些資訊納入團隊的資訊主頁、工具和日常工作流程。

API 會以結構化表格格式傳回資料，類似於 SQL 查詢的結果，因此可輕鬆剖析並擷取至其他系統。

為什麼要使用 App Optimize API？

您可以匯出專案和 App Hub 應用程式的報表，進行趨勢分析或與其他業務資料合併。您也可以使用這項 API 支援內部資訊主頁、驅動自訂快訊系統，或在部署管道中建立費用和使用量檢查。

這些整合功能可協助管理員和應用程式開發人員，在整個軟體生命週期中，根據資料做出考量成本的決策。

與分析工具整合

主要用途是自動將費用和用量資料定期匯出至分析工具。使用 Cloud Run 和 Cloud Scheduler 設定已排定的工作後，您就能每天呼叫 API 來擷取最新資料。

強化自訂資訊主頁的功能

API 也可支援自訂內部資訊主頁。團隊不再只能使用預先建構的控制台檢視畫面，而是可以建構網頁應用程式，根據需求延遲載入特定費用和用量指標。使用 JavaScript 時，資訊主頁可以呼叫 API，並在背景擷取資料時保持回應。這項功能可直接在團隊的工作流程中嵌入成本和效率資料，提供量身打造的檢視畫面。

根據資料做出決策

將 App Optimize API 整合到系統後，您就能彈性且自動存取所需資料，有效管理雲端財務和最佳化資源。這些程式輔助存取模式可協助您回答重要的成本效益問題。您可以找出近期費用暴增的服務、找出未充分利用的資源、計算特定時間範圍內特定應用程式的確切費用，或是監控不同產品和區域的支出趨勢。

主要功能與特色

App Optimize API 包含下列主要功能：

  • 詳細報表。產生報表，匯總各種維度的資料，包括專案、個別資源、SKU、時間範圍，以及 App Hub 應用程式、服務和工作負載。
  • 費用和使用率資料。存取各種資訊，例如金錢成本、CPU 使用率 (平均值和第 95 個百分位數)、CPU 核心用量和分配、記憶體使用率 (平均值和第 95 個百分位數)，以及記憶體用量和分配。
  • 彈性篩選。使用一般運算語言 (CEL) 精確篩選報表中的資料。您可以根據時間範圍、資源類型、特定 App Hub 應用程式和其他可用屬性進行篩選，專注分析特定項目。

瞭解資料

App Optimize API 產生的報表可提供寶貴的洞察資料，但請務必瞭解資料的性質和限制：

費用資料

  • 來源：費用資料的依據與 Cloud Billing 報表和匯出資料相同。
  • 延遲： Google Cloud 產品會按照不同間隔，將用量和費用資料回報給 Cloud Billing 程序。您可能需要等待一段時間，才能在 App Optimize API 報表中查看 Google Cloud 服務的用量和費用。費用通常會在一天內提供，不過有時可能會超過 24 小時。
  • 總費用：顯示的費用通常是總費用，反映以合約價格計算的用量，未套用任何抵免額，例如承諾使用折扣、續用折扣或促銷抵免額。
  • 幣別：如果依應用程式中心應用程式設定範圍，該應用程式內的所有基礎資源必須使用相同幣別，才能匯總費用。如果資源連結至使用不同貨幣的帳單帳戶，該應用程式的費用資料可能不完整或不會傳回。
  • 分開列出的費用：如果產品有資料移轉或永久磁碟費用，系統會分開列出這些費用和資源層級費用。
  • 適用情形：報表篩選器的時間範圍上限為目前日期前 90 天。開始時間必須在 90 天的時間範圍內。
  • 產品類別：App Optimize API 報表中的產品名稱設計邏輯清晰，方便使用者辨識。這些類別的費用分組方式，可能與 Cloud Billing 報表使用的服務類別不同。舉例來說，從 Cloud Billing 的角度來看，App Optimize API 報表中的「Compute Engine」費用可能包含多項基礎服務。

使用率資料

  • 來源：使用率指標來自 Cloud Monitoring。
  • 適用情形：
    • 報表篩選條件的時間範圍上限為目前日期前 90 天。開始時間必須在 90 天的時間範圍內。Cloud Run 指標僅適用於目前日期前六週。
    • 這項功能是否可用取決於資源類型，以及是否已設定適當的代理程式 (例如 Ops Agent) 來收集詳細指標。

App Optimize API 的運作方式

產生費用和用量報表的程序主要有三個階段：

  1. 索取報告。您可以指定感興趣的資料，包括日期範圍、涵蓋的資源或應用程式、資料分組方式，以及所需的特定費用和用量詳細資料。報表建立後，定義就無法修改。如需變更參數，請建立新報表。
  2. 等待資料準備完成。由於收集及整理資料可能需要時間，因此這項步驟會以非同步方式執行。API 可用於檢查報表是否已準備就緒。
  3. 擷取報表資料。處理完成後，您即可下載報表。報表會根據您的要求，以列和欄的格式呈現。

產生的報表會在 24 小時後自動從 API 刪除。

定價

在預先發布期間，使用 App Optimize API (包括建立報表、讀取報表和讀取報表的中繼資料) 不會產生額外費用。

如要瞭解與提供資料給 App Optimize API 的 Google Cloud 服務相關聯的費用，請參閱下列資訊：

後續步驟