LOGO OA教程 ERP教程 模切知识交流 PMS教程 CRM教程 开发文档 其他文档  
 
网站管理员

sql-tap:一款实时 SQL 流量查看神器

admin
2026年3月17日 12:56 本文热度 29

在日常开发、性能调优或者线上排查时,你是不是也这样干过:去数据库里翻慢查询日志,结果发现日志轮转了;或者给应用加上各种 APM 探针,配置繁琐还得改代码;又或者盯着数据库的 pg_stat_statements 或 performance_schema,总觉得信息支离破碎,缺少事务上下文和完整的参数绑定信息。

这些传统方法,要么侵入性强,要么信息滞后,要么维度单一。

今天给大家介绍一款实时 SQL 流量查看神器  —— sql-tap。

简介

sql-tap 是一个开源的SQL流量实时监控工具,采用文本用户界面(TUI)方式展示数据库SQL活动。适合用于数据库性能分析和调试。

工作原理

sql-tap 工作原理十分清晰,主要由两个核心组件构成:sql-tapd(代理守护进程)和 sql-tap(终端用户界面客户端)。

1.代理 (sql-tapd)

这是真正干“脏活累活”的部分。sql-tapd 启动后会监听一个我们指定的端口(比如 :5433)。应用程序不再直连数据库,而是连接到这个端口。sql-tapd 会代表我们的应用,与真实的数据库(目前完美支持 PostgreSQL 和 MySQL,还支持 TiDB)建立连接。

此后,它便在两者之间扮演一个“双向透明转发+深度解析”的角色。所有网络包都被它快速转发,保证业务不受影响;同时,它复制一份流量,进行深度的协议解析。

2.客户端 (sql-tap)

解析出的数据如何实时呈现?sql-tapd 通过 gRPC 流(stream) 将事件元数据实时推送给一个或多个 sql-tap TUI 客户端。gRPC 基于 HTTP/2,天生适合这种持续的流式数据传输。

我们只需要在终端运行 sql-tap 命令并连接到 sql-tapd 的 gRPC 服务地址,一个交互式的终端界面就会呈现。所有 SQL 查询如同瀑布流般实时滚动,我们可以清晰地看到每条查询何时发生、由哪个客户端发起、执行了多久、属于哪个事务。

使用

sql-tap的使用体验非常友好,提供了多种安装方式,比如用 Homebrew、Go 安装、下载二进制文件或者 Docker 运行。

一个典型的使用流程是这样的:

1.启动代理: 在数据库所在的服务器或网络可达的位置,运行 sql-tapd,指定上游数据库地址和代理监听端口。

sql-tapd -driver postgres -listen :5433 -upstream localhost:5432

2.修改应用配置: 将应用程序的数据库连接字符串(如 DATABASE_URL)中的主机和端口,改为 sql-tapd 代理的地址(例如从 localhost:5432 改为 proxy-host:5433)。重启应用。

3.启动监控终端: 在开发机上,运行 sql-tap 客户端,连接到代理的 gRPC 地址。

sql-tap --connect grpc://proxy-host:8080

然后,我们就能在终端里实时看到所有 SQL 流量了!可以检查查询、跟踪事务,一切都清晰可见。

效果展示

开源地址

https://github.com/mickamy/sql-tap


阅读原文:原文链接


该文章在 2026/3/17 18:35:06 编辑过
关键字查询
相关文章
正在查询...
点晴ERP是一款针对中小制造业的专业生产管理软件系统,系统成熟度和易用性得到了国内大量中小企业的青睐。
点晴PMS码头管理系统主要针对港口码头集装箱与散货日常运作、调度、堆场、车队、财务费用、相关报表等业务管理,结合码头的业务特点,围绕调度、堆场作业而开发的。集技术的先进性、管理的有效性于一体,是物流码头及其他港口类企业的高效ERP管理信息系统。
点晴WMS仓储管理系统提供了货物产品管理,销售管理,采购管理,仓储管理,仓库管理,保质期管理,货位管理,库位管理,生产管理,WMS管理系统,标签打印,条形码,二维码管理,批号管理软件。
点晴免费OA是一款软件和通用服务都免费,不限功能、不限时间、不限用户的免费OA协同办公管理系统。
Copyright 2010-2026 ClickSun All Rights Reserved