一款实时 SQL 流量查看神器

在日常开发、性能调优或者线上排查时，你是不是也这样干过：去数据库里翻慢查询日志，结果发现日志轮转了；或者给应用加上各种 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

构建高质量的技术交流社群，欢迎从事编程开发、技术招聘HR进群，也欢迎大家分享自己公司的内推信息，相互帮助，一起进步！

文明发言，以交流技术、职位内推、行业探讨为主

广告人士勿入，切勿轻信私聊，防止被骗

点下方的“❤”支持我们，非常感谢！