随着公司采用API 优先设计实践来构建现代应用,衡量这些 API 的运行性能和价值成为首要任务。 建立一个明确定义并将 API 指标与关键绩效指标 (KPI) 相连接起来的框架是确保 API 策略成功的最重要步骤之一。
通常,KPI 与特定目标相关。 它们具有明确的时间框架,并与您的 API 策略需要提供的结果保持一致。 相比之下,API 指标是重要的数据点。 并非每个指标都是 KPI,但每个 KPI 都是以指标开始的。
那么,如何开始呢? 首先,您需要从一开始就明确您的 API 策略的目标,然后选择与该目标相符的指标。 请记住,每个团队都需要根据其重要性和对业务至关重要性来衡量和跟踪不同的指标。
广义上讲,公司可以跟踪三种类型的 API 指标,每种类型回答不同的问题:
想象一下这些总体指标就像一个金字塔。 在底部,操作指标衡量各个 API 及其支持基础设施的战术性能。 最顶层的产品指标衡量的是您的 API 所创造的商业价值。 两者通过采用指标联系起来,该指标跟踪 API 程序与最终用户(开发人员)的增长情况。 通常,产品指标和采用指标与您需要衡量的业务成果相一致,而运营指标与您需要维护的技术标准相一致。
在这篇文章中,我们分解了 12 个需要衡量的关键具体指标,讨论了它们如何支持基础设施和应用团队,并解释了这些指标与 KPI 的关系。
当您刚刚开始时,运营指标通常是首先要衡量的事情。 它们非常具有策略性,并能提供有关 API 如何运作的见解。 运营指标本身通常不是 KPI。 相反,它们可以帮助您衡量团队正在构建的软件的质量和性能。 它们可以提供新出现的问题的早期指标,或者帮助您深入研究并发现可能影响关键 KPI 的问题。
您跟踪的运营指标将因团队和职责而异。
Platform Ops是负责维护、连接和保护不同团队用于交付应用的基础设施和技术集合的团队。 对于 API 程序,这通常包括 API 网关和 API 开发人员门户。
Platform Ops 等基础设施团队的关键指标包括:
200
) 状态代码可帮助您了解 API 的错误发生概率。 此总体衡量指标提供的信息可帮助您判断团队投入生产的 API 的整体质量。应用团队由 API 开发人员和服务所有者组成,负责构建和运营单个服务或应用。 它们可以用作更大产品的一部分,与合作伙伴集成,或者将 API 作为服务提供给开发人员。
对于应用团队来说,以下指标非常重要:
在电子书《掌握 API 架构》(由 O'Reilly 编写,由 NGINX 提供)第 3-5 章中,深入研究 API 操作并了解从业务角度来看哪些 KPI 和指标至关重要。
对于 API 优先的业务,必须超越工程指标并了解开发人员如何与您的 API 进行交互。 您还需要衡量和监控API 开发人员的体验,以确保开发人员采用您的 API 并从中获取价值。
采用指标的一些示例包括:
笔记: 我们建议至少有一个 KPI 旨在衡量 API 的采用情况。 这有助于计算 API 程序的整体增长。 例如,您可以设置一个 KPI 来增加使用您的 API 创建持续集成或应用程序的开发人员的数量。
API 产品指标在理解 API 的价值方面发挥着重要作用。虽然只有一小部分 API 可以直接带来收入,但每个 API 都需要为企业提供价值。
要衡量的关键产品指标包括:
笔记: 这些产品指标与业务影响密切相关,您可以根据业务目标选择将其中一些指标转化为 KPI。 例如,如果您的 API 策略的业务目标是通过第三方提供商接触更多客户,那么您需要跟踪使用 API 的合作伙伴数量以及通过这些集成产生的间接收入。
在《掌握 API 架构》的第 3-5 章中更深入地探索 API 产品生命周期 - 包括业务和运营 KPI。
协调 API 指标和业务 KPI 是做出数据驱动决策并确保 API 策略能够提供组织所需价值的主要方法之一。 不仅如此,获得对 API 的可见性还可以使基础设施和应用团队能够衡量对他们来说最重要的运营指标。
在 NGINX,我们提供数十个重要 API 指标的可见性。 您可以查看实时和历史指标,并轻松将其导出到您首选的应用性能监控 (APM) 或数据分析解决方案。
立即开始使用NGINX 管理套件的 30 天免费试用版,其中包括访问API 连接管理器、 NGINX Plus作为 API 网关,以及NGINX App Protect以保护您的 API。
“这篇博文可能引用了不再可用和/或不再支持的产品。 有关 F5 NGINX 产品和解决方案的最新信息,请探索我们的NGINX 产品系列。 NGINX 现在是 F5 的一部分。 所有之前的 NGINX.com 链接都将重定向至 F5.com 上的类似 NGINX 内容。”