概述
气闸团队成功实现了其最新特性(银河坐标项目),它发展并扩展了气闸的功能图。他们还确保通过添加新的参数并移除未使用的字段来维护图。让我们探寻我们如何能持续追踪图的稳定性和性能。
在本课程中,我们将
- 利用超级图见解通过操作和字段由GraphOS提供的指标
- 学习如何解读字段执行指标和引用操作的指标
GraphOS 中的指标
GraphOS提供的可观测性工具可帮助我们跟踪图表的运行状况和性能。这些工具有助于揭示图表的使用方式中的模式,从而帮助我们确定继续改进图表的方法。
我们可以在 Studio 中的洞察页面下找到这些指标。
运行指标
在洞察页面中,操作选项卡默认被选中。它可以帮助我们概览操作请求率、服务时间和错误百分比,包括针对值得深入研究的每个操作的具体操作。
我们建议客户端清楚地命名发送到图表中的每个GraphQL 操作,因为这些操作名称就是您将在指标中看到的名称。
我们还可以筛选以选择特定操作以查看有关其用法的更多特定详细信息及签名(即查询的形状)。我们可以看到已发出的请求数量以及随着时间的推移每个请求用了多长时间。
看起来 Airlock 中请求次数最多的操作之一是GetListing
。我们可以点击操作来查看更详细的见解。
字段使用情况
GraphOS还为我们提供了图表字段的使用情况指标。我们可以通过在洞察页面中单击字段选项卡来导航至该页面。
我们可以使用页面右上角的下拉菜单根据自定义时间范围筛选指标。
让我们仔细看一下 Listing.overallRating
字段作为示例。在 用法 部分中,我们可以确切地看到哪些 操作包括 Listing.overallRating
字段:
使用较大的时间段筛选器,我们可以看到两列新数据:请求和执行。
字段使用量指标分为两类:字段请求和 字段执行。
- 字段请求代表 操作在给定时间段内由客户端发送的数量,该时间段包含 字段。
- 字段执行代表服务器在给定时间段内为 字段执行 解析器的次数。
注意: 字段执行和引用 操作的值差异很大。你可以通过阅读 Apollo 关于字段使用量指标的文档。
使用见解
我们可以使用这些指标来监控 图形类型和 字段的使用情况和健康状况。这有助于我们回答以下问题:
- 有一些字段根本没有使用吗?是否有长时间未使用且仍在架构中的弃用字段?也许现在该从图中删除这些,以保持我们的架构简洁且有用。
- 我们是否计划对字段进行重大更改?哪些客户端和操作将受到影响?我们需要确保在我们进行的任何更改中它们都能被纳入循环。
随着我们的图不断发展,这些都是需要牢记的良好问题,而GraphOS将始终存在以帮助回答这些问题!
实践
关键要点
- 操作度量标准概述了在特定时间段或针对具体操作内的操作请求率、服务时间和错误百分比。
- 字段指标包括字段请求(发送了多少操作其中包含该字段)以及字段执行(解析器已执行该字段的次数)。
🎉恭喜
做得好,你已经学完了!在本课程中,我们学习了如何使用一个现有的超图在生产中。我们看到了如何合并模式检查和图形变体进入 CI/CD 工作流中,以便我们可以满怀信心地交付新功能。我们还探讨了我们可能从构建检查和操作检查中遇到的不同类型的错误。最后,我们研究了如何使用GraphOS来发现我们客户端操作的指标和字段使用情况。
下个系列见!
分享你对这堂课的问题和评论
您的反馈有助于我们改进!如果您遇到困难或困惑,请告诉我们,我们会帮助您解决。所有评论都是公开的,并且必须遵循 Apollo 行为准则。请注意,已解决或已解决的评论可能会被删除。
您需要一个 GitHub 帐户才能在下面发帖。没有吗? 改为发布在我们的 Odyssey 论坛中。