10. 借助 GraphOS 工作室进行可观察性
8m

概述

气闸团队成功实现了其最新特性(银河坐标项目),它发展并扩展了气闸的功能。他们还确保通过添加新的并移除未使用的来维护图。让我们探寻我们如何能持续追踪图的稳定性和性能。

在本课程中,我们将

  • 利用见解通过提供的指标
  • 学习如何解读执行指标和引用的指标

GraphOS 中的指标

提供的可观测性工具可帮助我们跟踪图表的运行状况和性能。这些工具有助于揭示图表的使用方式中的模式,从而帮助我们确定继续改进图表的方法。

我们可以在 Studio 中的洞察页面下找到这些指标。

运行指标

洞察页面中,操作选项卡默认被选中。它可以帮助我们概览请求率、服务时间和错误百分比,包括针对值得深入研究的每个操作的具体操作。

https://studio.apollographql.com

Insights page in Studio, showing Operations tab

我们建议客户端清楚地命名发送到图表中的每个 ,因为这些就是您将在指标中看到的名称。

我们还可以筛选以选择特定以查看有关其用法的更多特定详细信息及签名(即的形状)。我们可以看到已发出的请求数量以及随着时间的推移每个请求用了多长时间。

看起来 Airlock 中请求次数最多的GetListing。我们可以点击来查看更详细的见解。

https://studio.apollographql.com

Operations page filter for a specific operation in Studio

字段使用情况

还为我们提供了图表的使用情况指标。我们可以通过在洞察页面中单击字段选项卡来导航至该页面。

https://studio.apollographql.com

Fields page in Studio

我们可以使用页面右上角的下拉菜单根据自定义时间范围筛选指标。

让我们仔细看一下 Listing.overallRating 作为示例。在 用法 部分中,我们可以确切地看到哪些 包括 Listing.overallRating :

https://studio.apollographql.com

Fields page details for a specific field in Studio

https://studio.apollographql.com

Fields page details for a specific field in Studio

使用较大的时间段筛选器,我们可以看到两列新数据:请求和执行。

https://studio.apollographql.com

Fields page details for a specific field in Studio

使用量指标分为两类:字段请求字段执行

  • 字段请求代表 在给定时间段内由客户端发送的数量,该时间段包含
  • 字段执行代表服务器在给定时间段内为 执行 的次数。

注意: 执行和引用 的值差异很大。你可以通过阅读 Apollo 关于字段使用量指标的文档

使用见解

我们可以使用这些指标来监控 类型和 的使用情况和健康状况。这有助于我们回答以下问题:

  • 有一些根本没有使用吗?是否有长时间未使用且仍在架构中的弃用字段?也许现在该从中删除这些,以保持我们的架构简洁且有用。
  • 我们是否计划对进行重大更改?哪些客户端和将受到影响?我们需要确保在我们进行的任何更改中它们都能被纳入循环。

随着我们的不断发展,这些都是需要牢记的良好问题,而将始终存在以帮助回答这些问题!

实践

如果你需要了解一个字段已被解析的次数,你将使用哪个度量标准?
如果你需要了解包含字段的操作有多少,你将使用哪个度量标准?
GraphOS 提供以下哪些操作度量标准?

关键要点

  • 度量标准概述了在特定时间段或针对具体操作内的操作请求率、服务时间和错误百分比。
  • 指标包括字段请求(发送了多少其中包含该字段)以及字段执行(已执行该字段的次数)。

🎉恭喜

做得好,你已经学完了!在本课程中,我们学习了如何使用一个现有的在生产中。我们看到了如何合并和图形进入 CI/CD 工作流中,以便我们可以满怀信心地交付新功能。我们还探讨了我们可能从构建检查和检查中遇到的不同类型的错误。最后,我们研究了如何使用来发现我们客户端操作的指标和使用情况。

下个系列见!

前一页

分享你对这堂课的问题和评论

您的反馈有助于我们改进!如果您遇到困难或困惑,请告诉我们,我们会帮助您解决。所有评论都是公开的,并且必须遵循 Apollo 行为准则。请注意,已解决或已解决的评论可能会被删除。

您需要一个 GitHub 帐户才能在下面发帖。没有吗? 改为发布在我们的 Odyssey 论坛中。