🤖 新推出:《Quicknode 》AI 烹饪指南 10个经过验证的AI编程教程agents 。
查看食谱 什么是区块链可观测性:指标、日志与追踪 |Quicknode
我们的通讯中包含丰富的免费资源、Quicknode 动态、Web3行业洞察等内容。
CLI、Admin API 、MCP、SDK ,以及支持 75 多个区块链的原生 AI 工具。由开发者打造,专为开发者服务。
涵盖 Python、Ruby 和 JavaScript 的最新代码示例。关于智能合约、NFT 和去中心化应用(dApp)的深入指南。
通过 SOC 2 II 类认证 · ISO 27001
简而言之: 可观测性是指通过分析系统的外部输出,来理解系统内部运行状况的能力。 在区块链基础设施中,可观测性意味着拥有必要的指标、日志和追踪数据,以便解答诸如“为什么我的去中心化应用(dapp)运行缓慢?”、“为什么这笔交易失败了?”以及“我的 RPCendpoint 是否运行正常?”等问题。它超越了简单的监控(仅能告诉你出了问题),而是通过提供数据来帮助你理解问题产生的原因。 可观测性建立在三个支柱之上:指标(随时间变化的数值测量)、日志(带时间戳的事件记录)和追踪(分布式系统中的端到端请求路径)。
简明解释 监控功能会提示您汽车的发动机故障灯亮起。可观测性则会告诉您,发动机故障灯亮起是因为第3缸的氧传感器在2,500 RPM时检测到混合气过稀,这一情况始于上周更换fuel 滤清器之后,且该现象与副厂滤清器已知的问题特征相符。
在软件工程中,可观测性是指对系统进行如此全面的监控,以至于无需重现问题或事后添加新的监控手段,即可诊断任何问题。你无需预先预见所有可能的故障mode 。你需要收集足够的原始数据(指标、日志、追踪信息),以便当出现意外情况时,能够从症状逆向追溯至根本原因。
对于区块链应用而言,可观测性尤为关键,因为这些系统分布在多个层级:前端、后端、RPC 提供商、区块链节点、共识网络以及区块链本身。用户遇到余额更新缓慢的情况,可能是由于前端渲染速度慢、后端缓存问题、RPCendpoint 延迟、节点同步滞后或区块链拥塞所致。如果无法对每个层级进行可观测性监控,要诊断实际原因就只能靠猜测。
可观测性的三大支柱 指标
指标是指随时间推移以固定间隔收集的数值数据。它们是仪表盘和告警功能的基础。 在区块链基础设施中,关键指标包括 RPC 响应延迟(每次 API 调用所需的时间)、请求量(应用程序每秒发出的调用次数)、错误率(返回错误的请求所占的比例)、区块高度差(节点与区块链末端的差距)、gas 价格趋势(当前网络手续费水平)以及交易确认时间(从提交到被纳入区块所需的时间)。
指标最适合用于理解趋势和检测异常。RPC 延迟的突然飙升、错误率的逐渐上升或请求吞吐量的下降,都是表明情况发生变化的信号。Prometheus、Datadog 和 Grafana 等指标工具会收集、存储并可视化随时间变化的指标,既支持实时仪表盘,也支持历史趋势分析。
指标的优势在于它们轻量且经过聚合,因此可以高频采集,而不会产生海量数据。其局限性在于,指标只能告诉你发生了什么,却无法解释原因。你知道延迟增加了,但并不知道具体是哪些请求变慢了,也不知道导致它们变慢的原因是什么。
日志 日志是带有时间戳的离散事件记录。系统执行的每一项重要操作、遇到的每个错误、做出的每个决策,都可以作为日志条目进行记录。 在区块链应用中,相关的日志包括 RPC 请求和响应详情(方法、参数、响应时间、状态)、交易生命周期事件(已提交、待处理、已确认、已失败)、智能合约事件发布(来自智能合约的解码事件数据)、错误详情(堆栈跟踪、错误代码、请求上下文)以及用户操作(钱包连接、交易确认、页面导航)。
日志在提供诊断特定事件所需的详细信息方面表现出色。当指标提示错误率骤升时,日志能告诉您具体发生了哪些错误、哪些端点受到影响,以及请求参数是什么。Elasticsearch、Loki、Splunk 和 CloudWatch Logs 等日志分析工具支持跨服务和时间范围对日志条目进行搜索、筛选和关联分析。
日志带来的取舍在于数据量。对每次 RPC 调用、每次事务事件和每次用户操作进行详细日志记录会产生海量数据。日志存储成本可能会迅速增加,而要在数百万条日志条目中搜索特定事件,则需要高效的索引和查询工具。
痕迹 追踪记录了单个请求在分布式系统中从开始到结束的全过程。当用户发起代币兑换时,追踪会捕获每个步骤:前端处理时间、后端 API 调用延迟、发往节点的 RPC 请求、节点的处理时间、交易提交以及最终的区块确认。 每个步骤都被记录为一个“跨度”(span),包含开始时间、结束时间和元数据。跨度通过追踪 ID 相互关联,从而完整呈现请求的路径。
已优化的架构。如果一笔互换交易从用户点击到显示确认信息共耗时8秒,追踪结果会显示:200毫秒用于前端渲染,100毫秒用于后端处理,500毫秒为RPC延迟,12秒用于链上确认(应用程序在此期间处于等待状态),剩余时间则用于WebSocket事件传递。现在,您已经确切地知道时间耗费在哪些环节,以及应优化哪个组件。
Jaeger、Zipkin、Datadog APM 和 Honeycomb 等分布式追踪工具旨在收集、存储和可视化跨服务的追踪信息。对于微服务架构而言,这些工具尤为重要,因为在该架构中,单个用户请求会涉及多个服务、数据库和外部 API。
可观测性为何对区块链应用程序至关重要 区块链应用程序本质上是分布在多个独立系统之上的:您的基础设施、您的 RPC 提供商的基础设施,以及区块链网络本身。与仅依赖自身服务器和数据库的传统应用程序相比,这导致了更大的故障和性能下降风险。
RPCendpoint 问题是区块链开发者面临的最常见问题之一。endpoint 可能返回过时数据(因为底层节点同步滞后)、响应缓慢(因地理距离或负载原因),或者返回错误(因速率限制或节点故障)。如果无法对 RPC 层进行可观测性分析,这些问题在用户投诉之前是无法察觉的。
尽管链上状况超出了您的控制范围,但它们仍会影响您的应用程序。链上拥堵会导致 gas 费用上涨和确认时间延长。区块重组可能会使最近已确认的交易失效。在较小的区块链上,验证节点停机可能会导致区块生成延迟。能够同时跟踪链级指标和应用程序指标的可观测性工具,可让您全面了解哪些因素正在影响您的用户。
可观测性和监控之间有什么区别? 监控与可观测性虽有关联,但并非互换概念。监控是监视一组已知的信号,并在其中任何一个信号超过阈值时发出提示:它回答的是“是否出了问题?”。可观测性则是一种更广泛的能力,即利用丰富的数据对系统提出开放式问题,从而使您能够回答“为什么会出现问题?”,即使面对从未预料到的故障也是如此。监控是可观测性的一部分;您需要监控来发现问题,而需要可观测性来解释这些问题。
方面
监测
可观测性
核心问题
有什么问题吗?
为什么这是错的?
范围
预定义信号和阈值
对系统状态的开放式探索
故障类型
已知、预期的故障
已知和未知的故障
原始数据
仪表盘和警报
指标、日志和跟踪的结合
指标、日志和追踪是如何协同工作的? 这三大支柱是相辅相成的,而非相互竞争的。指标告诉你发生了变化,日志告诉你具体发生了什么,而追踪则告诉你时间消耗或错误发生在分布式请求的哪个环节。健全的可观测性实践会综合运用这三者:指标触发告警,追踪将问题范围缩小到某个服务,日志则揭示确切的错误。下表将每个支柱与其最能解答的问题进行了对应。
支柱
答案
区块链示例
常用工具
指标
发生了什么变化?是什么时候发生的?
14:02 时 RPC 延迟骤升
Prometheus、Grafana
日志
到底发生了什么?
eth_call 返回了超时错误
洛基,Splunk
痕迹
时间都花在哪里了?
RPC 跨度为 500 毫秒
Jaeger、Datadog APM
如何实现区块链基础设施的可观测性? 首先对 RPC 层进行监控,因为它位于您的应用和区块链之间:记录各方法的请求量、延迟百分位数和错误率。添加健康检查,将节点的区块高度与区块链末端进行比较,以便尽早发现同步延迟。 然后,将警报与能够真正预测用户痛点的信号关联起来,并设计出具有弹性恢复能力的架构,确保单点故障不会导致系统失效。将可观测性与可靠的节点 、高可用性 以及经过测试的故障转移 路径相结合,这样当系统出现故障时,您既能及时发现问题,又能绕过故障点继续运行。
常见问题解答
可观测性与监控是一回事吗? 不。监控会持续监视预定义的信号,并在某项指标超过阈值时向您发出警报;而可观测性则为您提供充足的数据,以便调查任何问题,包括您未预料到的故障。监控是更广泛的可观测性实践中的一个组成部分。
可观测性的三大支柱是什么? 指标、日志和追踪。指标是随时间变化的数值测量结果,日志是带有时间戳的离散事件记录,而追踪则追踪单个请求在分布式系统中的流转路径。它们共同帮助您检测、分析并定位问题。
为什么区块链应用的可观测性更具挑战性? 区块链应用涵盖您自己的基础设施、第三方 RPC 提供商以及区块链本身,因此故障可能源于您无法控制的层级。由于影响范围更广,您需要对每个层级都具备可视性,包括链层级的状况,例如拥塞和重组。
对于 RPC 基础设施而言,哪些指标最为重要? 响应延迟、请求量、错误率和区块高度差是核心指标。延迟和错误反映了endpoint 的运行状况,请求量反映了负载情况,而区块高度差则表明该节点是否跟上了区块链的最新状态。
每个立柱都需要单独的工具吗? 未必如此。许多平台涵盖了多个核心领域,且服务提供商通常会提供 RPC 分析和指标导出工具,您可以将其集成到现有的技术栈中。目标是在应用程序层和区块链层之间实现统一的可视化,而非局限于特定数量的工具。
Quicknode 如何支持可观测性 Quicknode 为区块链基础设施层提供了内置的可观测性功能。Quicknode 仪表盘包含实时分析数据,可显示每个endpoint 的请求量、响应延迟、错误率以及方法级别的详细统计。这使开发人员能够立即了解其 RPC 使用模式,而无需自行部署监控工具。
对于已部署可观测性解决方案的团队(stacks ),Quicknode 的专用Clusters 支持与 Prometheus Exporter 集成,使您能够将节点级指标直接导入 Grafana 仪表盘、Datadog 或任何兼容 Prometheus 的监控系统。这使您能够通过单一控制面板,在应用程序基础设施和区块链基础设施之间实现统一的可观测性。
Quicknode Streams 为您的数据管道层增添可观测性,为每个流提供传输状态、处理指标和错误报告。结合 RPC 分析仪表盘,这使开发人员能够全面掌握其实时 API 访问和流式数据摄取情况。
延伸阅读 // Publisher
Quicknode
更新于2026年6月2日
2026年3月20日 — 阅读时间10分钟