App Optimize API 概览

借助 App Optimize API，您可以了解自己的 Google Cloud 支出和资源用量。 对于开发者和管理员，此 API 提供了一种程序化方式来提取详细的费用和利用率数据，以便他们将此信息纳入团队的信息中心、工具和日常工作流程中。

此 API 以结构化表格格式返回数据，类似于 SQL 查询的结果，因此可以轻松解析并注入到其他系统中。

为什么要使用 App Optimize API？

您可以导出项目和 App Hub 应用的报告，以进行趋势分析或与其他商家数据合并。您还可以使用此 API 为内部信息中心提供支持、驱动自定义提醒系统，或在部署流水线中构建费用和利用率检查。

这些集成有助于管理员和应用开发者在整个软件生命周期中做出以数据为依据的决策，并了解费用情况。

与分析工具集成

一个主要用例是自动将费用和利用率数据定期导出到分析工具。通过使用 Cloud Run 和 Cloud Scheduler 设置预定作业，您可以每天调用该 API 来提取最新数据。

为自定义信息中心提供支持

此 API 还可以为自定义内部信息中心提供支持。您的团队可以构建 Web 应用，以便按需延迟加载特定的费用和利用率指标，而无需局限于预构建的控制台视图。借助 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 进程报告用量和费用数据。您在使用 Google Cloud 服务后，可能需要等待一段时间 ，才能在 App Optimize API 报告中看到其用量和费用 。通常一天之内即可获得费用信息，但有时可能需要 24 小时以上。
  • 总费用： 显示的费用通常是 总费用 ，反映的是按合同价格计算的用量， 未 应用任何赠金（例如承诺使用折扣、持续使用折扣或促销赠金）。
  • 币种： 按 App Hub 应用确定范围时，该应用中的所有底层资源必须使用相同的币种，才能汇总费用。如果资源与使用不同币种的结算账号相关联，则该应用的费用数据可能不完整或不会返回。
  • 单独报告的费用： 对于产生数据传输或 Persistent Disk 费用的产品，数据传输和 Persistent Disk 费用与资源级费用分开报告。
  • 可用性： 报告过滤条件的最长时间范围为当前日期的 90 天前。开始时间必须在 90 天的时间窗口内。
  • 产品类别： App Optimize API 报告中使用的产品名称旨在逻辑清晰且方便用户使用。这些名称可能会以不同于 Cloud Billing 报告中使用的服务类别的方式对费用进行分组。例如，从 Cloud Billing 的角度来看，App Optimize API 报告中的“Compute Engine”费用可能包含多个底层服务。

利用率数据

  • 来源： 利用率指标来自 Cloud Monitoring。
  • 可用性：
    • 报告过滤条件的最长 时间范围 为当前日期的 90 天前。开始时间必须在 90 天的时间窗口内。Cloud Run 指标仅适用于当前日期的 6 周前。
    • 可用性取决于资源类型以及是否配置了相应的代理（例如 Ops Agent）来收集详细指标。

App Optimize API 的工作原理

生成费用和用量报告的过程主要分为三个阶段：

  1. 请求报告。 您需要指定感兴趣的数据，包括时间范围、要涵盖的资源或应用、数据的分组方式以及所需的具体费用和用量详细信息。创建报告后，无法修改其定义。如果您需要更改参数，则必须创建新报告。
  2. 等待数据准备就绪。 由于收集和整理数据可能需要一些时间，因此此步骤以异步方式运行。此 API 提供了一种检查报告何时准备就绪的方法。
  3. 检索报告数据。 处理完毕后，您可以下载报告，该报告会根据您的请求以行和列的形式呈现。

生成的报告会在 24 小时后自动从 API 中删除。

价格

在预览版期间，使用 App Optimize API 不会产生额外费用，包括创建报告、读取报告和读取报告元数据。

如需了解与向 App Optimize API 提供数据的服务相关的费用，请参阅以下信息： Google Cloud

后续步骤