成功实施API策略需要监控的12项指标

NGINX | 2023年1月17日

随着企业采用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开发者门户。

Platform Ops等基础设施团队的关键指标包括：

正常运行时间，尽管正常运行时间是最基本的指标之一，但它仍是衡量服务可用性的公认基准。该指标通常与服务级别协议（SLA）相关联。
CPU和内存使用率：跟踪API网关的资源利用率，对于判断何时可能需要横向扩展实例至关重要。当系统开始出现故障，或因错误导致使用量激增时，这也能起到预警作用。
总体通过率和错误率：衡量API触发HTTP错误状态码（非200）的频率，有助于了解API可能出现错误的程度。这项汇总指标可为评估团队投入生产的API的整体质量提供参考。

应用团队

应用团队由API开发人员和服务负责人组成，负责构建和运营各项服务或应用。这些服务或应用可作为大型产品的一部分、用于与合作伙伴集成，或以服务形式向开发人员提供API。

应用团队需要重点衡量以下指标：

每分钟请求数：此性能指标用于衡量API正在处理的请求数量。虽然该数值会随时间变化，但通常需要设法降低，以确保API用户获得良好体验。
平均延迟和最大延迟：跟踪API从接收请求到返回响应所需的平均时间至关重要。即使只有一个API响应缓慢，也会对用户体验产生负面影响，进而影响业务。
每分钟错误数：与其他事物一样，API也难免出错。故障并非会不会发生，而是何时发生。需要监控错误，并提前制定修复方案，以便在错误数突然开始上升前及时处理。

深入了解API运营，并通过电子书第3至5章了解从业务角度看哪些KPI和指标至关重要：Mastering API Architecture。该书由O’Reilly出版，NGINX免费提供。

采用情况指标

对于以API为先的企业，除了关注工程指标，还必须了解开发者如何与API交互。此外，还需要衡量和监控API开发者体验，以确保开发者采用API并从中获得价值。

采用情况指标的示例包括：

独立API使用者，通常按月度用户统计。该指标衡量采用并使用API的开发者数量。随着更多开发者将API集成到应用程序中，该指标通常会逐步增长。
API使用量增长：该指标也用于衡量API采用情况，并且通常是衡量这一情况的首选指标。理想情况下，随着使用API的应用和开发者数量增加，API流量也会逐月增长。
首次调用所需时间：此指标衡量开发者创建账户、生成API凭据并执行首次API调用所需的时间。帮助开发者尽快开始使用API是优先事项，因此该指标对于衡量整体API开发者体验尤为重要。

注意：建议至少设置一项用于衡量API采用情况的KPI。这有助于计算API项目的整体增长情况。例如，可以设置一项KPI，以增加使用API创建持续集成或应用的开发者数量。

产品指标

API产品指标对于了解API的价值至关重要。虽然只有少部分API可能直接带来收入，但每个API都需要为业务创造价值。

需要衡量的关键产品指标包括：

直接和间接收入：这些指标衡量API以不同方式带来的收入。部分API可直接变现，其他API则支持与业务合作伙伴集成，或作为客户重视的第三方集成。与API采用率一样，跟踪间接收入有助于开发者为合作伙伴构建创收应用。
每个API对应的应用数量：API需要具备可复用性。此指标衡量与每个API集成的应用数量，以确定哪些API能够提供更大价值。
合作伙伴数量：API通常有助于建立业务关系。跟踪合作伙伴的API集成数量，有助于推动采用，并向其他业务部门展示其价值。

注意：这些产品指标与业务影响密切相关，您可以根据业务目标选择将其中一些指标设为KPI。例如，如果API策略的业务目标是通过第三方提供商触达更多客户，则需要同时跟踪使用API的合作伙伴数量，以及通过这些集成产生的间接收入。

如需深入了解API产品生命周期（包括业务和运营KPI），请参阅《Mastering API Architecture》第3至5章。