0%

Apollo入门引导(五):连接Apollo Studio

接上篇 —— Apollo 入门引导(四):编写变更解析器 —— 继续翻译 Apollo 的官网入门引导

了解基础的开发工具。

Apollo 入门引导 - 目录:

  1. 介绍
  2. 构建 schema
  3. 连接数据源
  4. 编写查询解析器
  5. 编写变更解析器
  6. 连接 Apollo Studio
  7. 创建 Apollo 客户端
  8. 通过查询获取数据
  9. 通过变更修改数据
  10. 管理本地状态

完成时间:10 分钟

做得好!我们有一个正在运行的 GraphQL 服务,它能与多个源进行数据交互。在转到客户端之前,先学习一些功能强大的工具。

Apollo Studio 是一个云平台,可以对原型设计、部署到监控的 GraphQL 开发的每个阶段提供帮助。

Studio 的核心功能是完全免费的。本教程中的所有功能都是免费功能。

创建一个 Apollo 帐户

如果已经创建了 Apollo Studio Explorer 的帐户,请跳过此步骤。

访问studio.apollographql.com,然后点击 创建账户(Create an account)。可以使用你的 GitHub 帐户关联注册,也可以自行设置用户名和密码。

注册后,将被重定向到 Apollo Studio 主页。

创建第一个图

在 Apollo Studio 中,每个图(graph)都是具有对应 GraphQL schema 的不同数据图。对于你的第一张图,将使用刚刚完成构建的服务的 schema。

  1. Studio 主页中,单击右上角的 新建图(New Graph)
  2. 为你的 graph 提供名称,然后单击下一步(Next)
  3. 出现一个对话框,提示你注册 schema。将在下一步中进行操作。

连接服务

Apollo 服务可以直接与 Apollo Studio 通信,以注册其 schema 并推送有用的性能指标。此通信需要 graph API key。让我们为 graph 获得一个。

Studio 主页中,单击刚创建的 graph。将显示与创建时相同的对话框:

复制你的 graph API 密钥,就是在第一个代码块中 APOLLO_KEY= 之后出现的值(以service:开头)。

可以通过将 API 密钥设置为 APOLLO_KEY 环境变量值来向 Apollo 服务提供 API 密钥。示例应用程序已经使用 dotenv 包非常方便地从 .env 文件中读取环境变量。

通过复制 start/server/.env.example,在 start/server 中创建 .env 文件。然后如下将你的 API 密钥粘贴到其中,并添加一行 APOLLO_SCHEMA_REPORTING=true

1
2
APOLLO_KEY=PASTE_YOUR_KEY_HERE
APOLLO_SCHEMA_REPORTING=true

Graph API 密钥是私有凭证。切勿在组织外部共享或将其提交到版本控制中。及时的删除并替换可能遭到破坏的 API 密钥。

使用 npm start 启动服务,然后返回 Studio 主页。几秒钟后,单击 graph 即可打开其完整详细信息。

试用免费的 Studio 功能

将服务连接到 Apollo Studio 会开启各种强大的功能:

Explorer

如前几节所示,Apollo Studio 资源管理器提供了对 schema 的全面视图,包括其中包含的所有文档字符串。使用它来构建查询并在服务上执行。

schema 历史

打开历史记录(History)选项卡,可以查看随时间推移,服务推送的 schema 版本的完整修订记录:

历史记录可帮助你准确定位何时添加或删除的某个类型或字段,这在诊断问题时至关重要。

操作指标

Apollo Server 将其执行的每个 GraphQL 操作的指标数据推送到 Studio。此数据包括操作中解决每个字段的时间和详细错误信息。

Apollo Server 不会将 GraphQL 操作结果推送到 Studio。有关更多信息,请参阅数据隐私和合规性

打开操作(Operations)标签,查看最近 24 小时跟踪服务操作的性能数据:

拥有付费 Studio 的组织可以查看最近 90 天或更长时间的指标,具体时长取决于组织的方案。有关付费 Studio 功能的更多信息,请参见Studio 文档

现在我们的服务已连接到 Studio,下面开始构建执行查询的客户端!


前端记事本,不定期更新,欢迎关注!


👆 全文结束,棒槌时间到 👇