您正在查看的是 Apigee Edge 文档。
转到 Apigee X 文档。 信息
本部分比较了 API 监控与 Edge Analytics。虽然 API Monitoring 和 Edge Analytics 都可以让您收集和查看 API 数据,但它们有不同的目标:
- API 监控的目标是确保您的 API 按预期启动和运行。为此,您需要查看最新可用数据。API Monitoring 可提供近乎实时的数据,并可让您创建提醒,以便在出现问题时向您发出通知。
- Edge Analytics 的目标是了解您的 API 的长期行为,以便您确保其支持您的业务需求,或在必要时进行更改。为了实现这些目的,查看实时数据并不重要。因此,Analytics 数据会略有延迟,但通常最多会延迟 10 分钟。
请注意,API 监控数据主要与错误代码和延迟时间相关,只是 Google Analytics(分析)数据的一小部分。
API 监控数据与 Google Analytics(分析)数据之间的差异
本部分介绍了 Edge Analytics 收集的数据与 API Monitoring 收集的数据之间的一些细微差异。 由于 API Monitoring 和 Analytics 使用不同的数据流水线,因此 Monitoring 生成的自定义报告与 Analytics 生成的报告之间可能存在细微差异。例如,您可能会看到超时错误的报告结果存在差异,其中包括后端超时(请求的 HTTP 状态代码 504)和客户端超时(HTTP 状态代码 499)。这些事件在 Google Analytics(分析)自定义报告中可能会显示状态代码 200,但在 Monitoring 自定义报告中会显示状态代码 504 或 499。API 监控
API 监控功能提供有关 API 性能的实时数据分析,可帮助您快速诊断和解决问题,确保 API 正常工作。
借助 API Monitoring,您可以执行以下操作:
- 提高 API 的可用性并缩短平均诊断时间 (MTTD)。
- 根据上下文提醒,在使用方受到影响之前采取相应措施。
- 利用 Apigee 故障代码加快诊断速度。
- 快速找出有问题的地方,以诊断错误、性能和延迟问题及其来源。
Edge API 分析
Edge API Analytics 会收集和分析通过 API 传输的信息。API Analytics 可捕获如下信息:
- 您的 API 流量随时间的变化趋势
- 哪些是你的热门应用
- 您的主要开发者有哪些
- 哪些 API 方法最常用
- API 响应时间何时最快/最慢
- 从地理位置上看,哪些位置的 API 流量最多
API Analytics 收集的数据
API Analytics 可收集和分析横跨 API 的广泛数据。例如,部署 API 后,Google Analytics(分析)会不断记录接收的消息数量、开发者数量、响应时间、错误、正在使用的应用数量、请求大小以及许多其他数据。
有关指标及其使用方法的详细介绍,请参阅使用 Metrics API 来衡量 API 计划的性能。如需查看指标的完整列表,请参阅 Google Analytics(分析)指标、维度和过滤器参考文档。
收集自定义指标
您还可以使用 StatisticsCollector 政策收集自定义指标。StatisticsCollector 政策可以将请求标头、XML/JSON 负载、查询参数、URI 和其他位置中的信息写入 Google Analytics(分析)服务器,以供分析和生成报告。
访问 Google Analytics(分析)数据
生成之后,您可以使用 API Analytics 可视化工具(包括信息中心、自定义报告和 GeoMap)访问预定义的指标和自定义指标。如需详细了解 API Analytics(分析)提供的可视化工具,请参阅 Google Analytics(分析)信息中心。如需详细了解自定义报告,请参阅创建自定义报告。
比较 API 监控和 API 分析
API 开发者会同时使用 API 监控和 API 分析。两者之间的主要区别之一是 API Monitoring 内置的提醒机制。借助提醒,您的运营团队可以实时响应您的 API 问题,确保您的 API 可用并按预期运行。
提醒条件定义了具体的状态代码 (2xx/4xx/5xx)、延迟时间和错误代码阈值,超出这些阈值时,会触发界面中的视觉提醒,并通过各种渠道(例如电子邮件、Slack、pagerduty 或 webhook)发送通知。您可以在环境、API 代理、目标服务或地区级别设置提醒。
触发提醒后,您的运营团队可以使用 API Monitoring 界面来调查问题并深入调查其根本原因。 然后,您可以生成一份自定义报告,其中包含有关提醒的预定义信息,例如:
- 总响应时间
- 目标响应时间
- 代理错误
- 目标错误
- 请求 UUID
- 其他更多
API Analytics(分析)旨在捕获大量数据,以供多个团队使用。例如:
- 运营团队可以使用 Analytics 数据确定流量高或低的时段,以便对服务进行扩缩,以满足不断变化的需求。
- 营销团队可以使用 Google Analytics(分析)数据来确定通过各个 API、应用、客户或其他数据确定的客户使用模式。
- 所有团队都可以访问通过请求收集的自定义数据,以跟踪特定信息,例如标头值、查询参数或请求载荷。