如何使用 Traceye 运行托管 subgraph

本文介绍了如何使用 QuickNode 上的 Traceye 插件来创建、部署和管理 subgraph。Traceye 是 Zeeve 开发的企业级索引工具,旨在简化 The Graph 协议的 subgraph 索引和查询过程,提供了快速索引、零维护、高可靠性等关键优势,并详细说明了如何在 QuickNode 上启用 Traceye 插件以及如何使用该插件部署 subgraph。

概述

在快速发展但又常常不可预测的 Web3 工程领域,团队在运行托管 subgraph 时始终面临着相当大的挑战,例如停机、数据滞后、缓慢的重新索引、慢查询以及缺乏直接支持。

不妨试试 Traceye,这是一款由 Zeeve 为 The Graph 协议开发的企业级索引工具,可以轻松、可预测且顺畅地索引和查询 subgraph。在本指南中,我们将介绍如何将 Traceye add-on 添加到你的 QuickNode endpoint,然后向你展示如何使用 Traceye 创建和部署 subgraph。让我们开始吧!

你将要做什么

  • 了解 Traceye
  • 将 Traceye add-on 添加到你的 QuickNode endpoint
  • 使用 Traceye 创建、部署和管理 subgraph

你将需要什么

依赖项 版本
node.js 18.13.0
graph-cli 0.49.0

什么是 Traceye?

区块链基础设施即服务提供商 Zeeve 推出了 Traceye,这是一款用于索引区块链账本和智能合约数据的新工具。Traceye 是一款企业级就绪的托管 graph 解决方案,允许开发人员在托管服务上部署、索引和查询 subgraph。目前,如果 The Graph 的托管服务不支持某个网络,你需要运行自己的 graph 节点来索引它。但是,这可能需要额外的工程工作来设置,并且处理维护和问题可能会成为一种精神负担。Traceye 通过允许开发人员在不到 5 分钟的时间内快速部署 subgraph 来解决此问题。

Traceye 的主要优势

Traceye 的功能和主要优势包括:

  • 超快索引:通过我们快速的索引功能体验最小的数据延迟。
  • 零维护:告别节点维护的麻烦。
  • 可靠性:99.9% 的 API SLA 正常运行时间。
  • 增值服务:受益于 Webhook、指标等附加功能,从而增强了你的标准 subgraph 功能。
  • 灵活性:轻松地从其他平台迁移 subgraph。

其他功能包括高级指标和性能洞察,以及直接访问从 subgraph 发出的日志。

在下一节中,我们将介绍如何将 Traceye add-on 添加到你的 QuickNode 账户,并演练 Traceye 仪表板。

在 QuickNode Endpoint 上启用 Traceye

首先,登录 QuickNode(你可以在此处创建一个免费账户),然后导航到你的 endpoint。对于本教程,你需要在以太坊主网上有一个 endpoint。如果你还没有,请立即创建一个。

设置好以太坊主网 endpoint 后,请妥善保管上面的 HTTP Provider URL,因为稍后你将需要它。

然后,在你的 endpoint 页面上,单击 Add-ons 选项卡,然后单击 Traceye add-on 上的 Explore 按钮。你会看到一个弹出框,解释定价以及该 add-on 与哪些 endpoint 兼容。启用该 add-on 后,你将在 Installed Third-Party Add-Ons 列表中看到它。

安装该 add-on 后,单击 Dashboard 按钮以定向到 Zeeve 的 Traceye 仪表板:

QuickNode / Traceye Add-on Tab

Zeeve 的 Traceye 仪表板:

Traceye Dashboard

通过上面的 Traceye 仪表板,你可以快速监督已创建 subgraph 上的活动。在下一节中,我们将向你展示如何在 Traceye 上创建和部署 subgraph。

使用 Traceye 创建 Subgraph

现在,在你的 Traceye 仪表板中,单击 Add Subgraph 按钮,选择 Create New 选项,系统将提示你输入有关 subgraph 的名称、区块链网络、workspace 以及要与 subgraph 一起使用的 RPC endpoint 的详细信息。

Blockchain Network 下选择 Custom 选项,然后将你的 endpoint 的 HTTP provider URL 粘贴到 RPC Endpoints 中。

创建 subgraph 后,单击仪表板上新创建的 subgraph,你将在其中看到 subgraph 的统计信息和配置:

Traceye Subgraph Creation

在顶部,你将看到一个标志,指示你的 subgraph 是否已部署,以及一个 Sync Status 栏,显示 subgraph 是否已与链的最新主干同步。

在 subgraph 的 Details 部分中,你将看到有关 subgraph 创建时间、它引用的区块链网络以及你的 workspace(应该是默认 workspace)的信息。Deployment Command 按钮说明了托管 subgraph 的步骤(我们稍后会介绍)。

subgraph 的 Query URL 部分提供了用于查询托管 subgraph 的 URL,还可以通过交互式 playground (通过 Open 按钮) 与之交互。

该界面还提供了几个选项卡来增强你与 subgraph 的交互:

  • Logs Tab:在此处访问 subgraph 操作的详细日志。“Logs Tab”使你可以查看、筛选和分析 subgraph 发出的事件,这对于监视其性能和解决问题至关重要。

  • Webhooks Tab:Subgraph Webhook 功能允许你订阅 subgraph 中的特定实体。此功能可确保你在添加或修改与你订阅的实体相关的数据时,直接向你的系统接收实时更新。

  • Entities Tab:浏览 subgraph 中实体的简化概述。

  • Settings Tab:在此选项卡中根据你的运营需求管理各种配置。

使用 Traceye 部署 Subgraph

现在,在 Traceye 上创建 subgraph 后,让我们部署它。在继续之前,请确保已编译 subgraph。如果你还没有 subgraph 项目,或者不知道那是什么,请查看此 QuickNode 指南:如何使用 The Graph 创建和部署自定义 subgraph,以快速启动并运行。

在本教程中,我们将分析部署在以太坊主网上的 Elemental NFT 合约

在按照 如何使用 The Graph 创建和部署自定义 Subgraph 中的步骤 1-5 操作后,按照以下步骤使用 Traceye 部署 subgraph。

步骤 1:在 Traceye 仪表板上的 subgraph 的 Details 部分中,单击 Deployment Command 按钮,并使用 Traceye 仪表板上的 Step 1 中提供的名称更新 subgraph.yaml(一个包含 subgraph 项目中 subgraph 清单的 YAML 文件)中的 network 字段。

Traceye Deployment Command

subgraph.yaml 更新为包含 Step 1 中显示的网络名称后,你可以继续。

步骤 2:在 subgraph 的根目录中,在终端中运行 Step 2 中的命令,你将看到类似于以下的输出:

Traceye Subgraph Deployment

同步过程可能会持续更长时间,具体取决于需要同步的区块编号。

部署 subgraph 并确认其同步状态与链同步更新后,你可以通过 Query 部分中的 Open 按钮与之交互:

Subgraph Synced and Open Preview

然后通过 GraphQL 语言查询 subgraph 的指定模式:

Subgraph Interaction

随意使用此示例查询作为起点,以探索和提取区块链上精确区块范围内的详细传输数据。

query MyQuery {
  transfers(where: {blockNumber_gt: 19783200, blockNumber_lt: 19783210}) {
    Elemental_id
    from
    to
    transactionHash
    blockNumber
  }
}

注意:如果你查询的区块编号大于 subgraph 已索引和同步的区块编号,则可能会看到空响应。

最后的想法

就这样!你现在知道如何使用 Traceye 创建的 QuickNode Marketplace 上的 Hosted Subgraphs add-on 创建、部署和管理你自己的 subgraph。你无需维护 subgraph,并且可以立即开始以 99.9% 的正常运行时间从中进行查询!

如果你想了解更多信息,请查看以下资源列表:

我们很乐意听到更多关于你正在构建的内容。在 Discord 中给我们留言,或者在 Twitter 上关注我们,以随时了解所有最新信息!

我们 ❤️ 反馈!

如果你对新主题有任何反馈或要求,请 告诉我们。我们很乐意听取你的意见。

  • 原文链接: quicknode.com/guides/mar...
  • 登链社区 AI 助手,为大家转译优秀英文文章,如有翻译不通的地方,还请包涵~
点赞 0
收藏 0
分享
本文参与登链社区写作激励计划 ,好文好收益,欢迎正在阅读的你也加入。

0 条评论

请先 登录 后评论
QuickNode
QuickNode
江湖只有他的大名,没有他的介绍。