本页面适用于 Apigee 和 Apigee Hybrid。
查看 Apigee Edge 文档。
Apigee API Monitoring、Apigee API Analytics 和 Apigee 访问日志是三个功能强大的工具,可用于收集、观察和了解 API 使用情况数据。这些工具各自提供不同的数据洞见,建议您根据不同的用例来选择要使用的工具。本文档简要介绍了每种工具的用途及其推荐用法,如下文所述:
API 监控
API Monitoring 的目标是提供实时的 API 性能数据洞见,以便您快速诊断和修复问题,从而确保 API 按预期正常运行。
API Monitoring 会每分钟为您提供来自 API 代理的汇总数据,以便您密切监控 API 的健康状况和性能。您可以使用 API Monitoring 来针对指定参数配置近乎实时的提醒,并在问题排查时利用汇总数据。
借助 API Monitoring,您可以:
- 维护 API 的可用性。
- 根据提醒,在使用方受到影响之前采取相应措施。
- 使用 Apigee 故障代码加快问题诊断。
- 快速找出问题区域,以诊断性能和延迟时间问题的来源。
Apigee 客户还可以使用 Cloud Monitoring 工具支持 API Monitoring。如果您想与其他监控系统集成,我们建议您使用 Monitoring API 来拉取指标。
使用 API Monitoring 时的延迟数据
由于 API Monitoring 是专门设计为可扩展,因此它不会记录每项事务中的每个延迟时间测量值。相反,分布存储桶用于衡量延迟时间。延迟时间分组使用预定义的范围对观察到的延迟时间值进行分组。
如需详细了解如何为您的 API 使用 API Monitoring,请参阅 API Monitoring 概览。
如需详细了解如何将 Monitoring 与 Apigee 搭配使用来配置提醒,请参阅设置提醒和通知。
Apigee API Analytics
Apigee API Analytics 可针对 API 调用元数据提供历史趋势分析和详细报告。Apigee Analytics 的目标是帮助您了解 API 流量的长期趋势,以便确保您的 API 支持您的业务要求,或在必要时进行更改。
借助 Apigee API Analytics,您可以从大约 50 个可用的维度中进行选择,以指定您希望针对代理处理的每个 API 调用捕获的数据。然后,您可以创建自定义报告,以确定特定的 API 指标随时间的变化情况。
捕获的分析数据存储在 BigQuery 中。您可以使用 Apigee API Analytics 在 Looker Studio 中创建自定义报告、设置异步自定义报告作业或将分析数据导出到您自己的 Google Cloud 存储库,例如 BigQuery。如果您最初采用按用量付费定价,API Analytics 是一项可选的附加服务。
以下是您可以使用 Apigee Analytics 识别的一些趋势:
- 您的 API 流量随时间变化的趋势如何?
- 您的热门应用有哪些?
- 您的主要开发者有哪些?
- 什么时候 API 响应时间最快或最慢?
- 哪些地理区域的 API 流量最多?
使用 Apigee API Analytics 时的延迟数据
Apigee API Analytics 中观察到的延迟时间使用近似分位数聚合函数对存储在 BigQuery 中的各个记录进行分析。与 API Monitoring 中使用的分组逻辑相比,这样可以使围绕延迟时间生成的数据更精确。在 API Monitoring 和 Apigee API Analytics 中,延迟的测量均始于 Apigee 运行时环境,不包含任何先前网络跃点(包括 Istio)的延迟计算。
如需详细了解 Apigee API Analytics,请参阅 Apigee API Analytics 概览。
Apigee 访问日志
Apigee 访问日志可用于对 Apigee 的 API 调用进行问题排查,并确定哪些 API 返回了特定的 HTTP 响应代码。
Apigee 访问日志会在 Apigee 的入站流量网关中捕获每个事务的日志。这样,您就可以根据特定的 HTTP 代码过滤日志,并轻松排查边缘情况,例如 Istio 上的响应状态代码为 0
的情况。
如需详细了解如何使用 Apigee 访问日志来排查 API 问题,请参阅 Apigee 访问日志。
API Monitoring 数据与 Analytics 显示的数据之间的差异
API Monitoring 和 Apigee API Analytics 使用不同的流水线访问 API 数据。因此,您可能会发现 Apigee API Analytics 信息中心显示的数据与 API Monitoring 中提供的数据之间存在一些差异。
及时性和准确性
通常,Apigee API Analytics 显示的数据比 API Monitoring 显示的数据更准确,但延迟时间可能略短(不到一小时)。
数据保留
Apigee API Analytics 的数据保留时间比 API Monitoring 更长,因此它更适合分析长期趋势。
Analytics 和 API Monitoring 的数据保留期限如下:
Analytics
- 标准版:60 天
- 企业版:90 天
- 企业增强版:14 个月
API Monitoring:1 个月