了解 Apigee 可观测性

本页面适用于 ApigeeApigee Hybrid

查看 Apigee Edge 文档。

Apigee API 监控、Apigee API Analytics 和 Apigee 访问日志是三个功能强大的工具,可用于收集、观察和了解 API 使用情况数据。这些工具各有不同,提供的分析洞见也各不相同,建议您根据不同的用例选择合适的工具。本文档简要介绍了每种工具的用途及其推荐的使用方式,如以下部分所述:

API 监控

API Monitoring 的目标是提供实时的 API 性能数据洞见,以便您快速诊断和修复问题,确保 API 按预期正常运行。

API 监控会每分钟为您提供来自 API 代理的汇总数据,以便您密切监控 API 的运行状况和性能。您可以使用 API 监控功能针对指定参数配置近乎实时的提醒,并在排查问题时利用汇总数据。

借助 API Monitoring,您可以:

  • 维护 API 的可用性。
  • 在使用方受到影响之前采取行动。
  • 使用 Apigee 故障代码加快问题诊断。
  • 快速找出问题区域,以诊断性能和延迟时间问题的来源。

Apigee 客户还可以使用 Cloud Monitoring 工具支持 API Monitoring。如果您想与其他监控系统集成,我们建议您使用 Monitoring API 拉取指标。

使用 API 监控时的延迟时间数据

由于 API 监控是专为扩容而设计的,因此不会记录每笔交易中的每个个别延迟时间测量结果。而是使用分布分桶来衡量延迟时间。延迟时间分桶使用预定义的范围对观察到的延迟时间值进行分组。

如需详细了解如何为 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 监控中使用的分桶逻辑相比,这样可以使与延迟时间相关的最终数据更精确。API 监控和 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 的数据保留期限如下:

  • 分析

    • 标准版:60 天
    • 企业版:90 天
    • 企业增强版:14 个月
  • API Monitoring:1 个月