pg_tracing

PostgreSQL分布式Tracing

概览

扩展包名	版本	分类	许可证	语言
`pg_tracing`	`0.1.3`	STAT	MIT	C

ID	扩展名	Bin	Lib	Load	Create	Trust	Reloc	模式
6010	`pg_tracing`	否	是	是	是	否	是	-

相关扩展	`pg_stat_log` `pg_stat_backtrace` `pgfr_record` `logerrors` `pgelog`

版本

类型	仓库	版本	PG 大版本	包名	依赖
EXT	PIGSTY	`0.1.3`	1817161514	`pg_tracing`	-
RPM	PIGSTY	`0.1.3`	1817161514	`pg_tracing_$v`	-
DEB	PIGSTY	`0.1.3`	1817161514	`postgresql-$v-pg-tracing`	-

OS / PG	PG18	PG17	PG16	PG15	PG14
el8.x86_64	PIGSTY 0.1.3 el8.x86_64.pg18 : pg_tracing_18 pg_tracing_18-0.1.3-2PIGSTY.el8.x86_64.rpm PIGSTY · 0.1.3 · 46.2KiB	PIGSTY 0.1.3 el8.x86_64.pg17 : pg_tracing_17 pg_tracing_17-0.1.3-2PIGSTY.el8.x86_64.rpm PIGSTY · 0.1.3 · 46.2KiB	PIGSTY 0.1.3 el8.x86_64.pg16 : pg_tracing_16 pg_tracing_16-0.1.3-2PIGSTY.el8.x86_64.rpm PIGSTY · 0.1.3 · 46.2KiB	PIGSTY 0.1.3 el8.x86_64.pg15 : pg_tracing_15 pg_tracing_15-0.1.3-2PIGSTY.el8.x86_64.rpm PIGSTY · 0.1.3 · 47.9KiB	PIGSTY 0.1.3 el8.x86_64.pg14 : pg_tracing_14 pg_tracing_14-0.1.3-2PIGSTY.el8.x86_64.rpm PIGSTY · 0.1.3 · 48.2KiB
el8.aarch64	PIGSTY 0.1.3 el8.aarch64.pg18 : pg_tracing_18 pg_tracing_18-0.1.3-2PIGSTY.el8.aarch64.rpm PIGSTY · 0.1.3 · 44.8KiB	PIGSTY 0.1.3 el8.aarch64.pg17 : pg_tracing_17 pg_tracing_17-0.1.3-2PIGSTY.el8.aarch64.rpm PIGSTY · 0.1.3 · 44.9KiB	PIGSTY 0.1.3 el8.aarch64.pg16 : pg_tracing_16 pg_tracing_16-0.1.3-2PIGSTY.el8.aarch64.rpm PIGSTY · 0.1.3 · 44.9KiB	PIGSTY 0.1.3 el8.aarch64.pg15 : pg_tracing_15 pg_tracing_15-0.1.3-2PIGSTY.el8.aarch64.rpm PIGSTY · 0.1.3 · 46.5KiB	PIGSTY 0.1.3 el8.aarch64.pg14 : pg_tracing_14 pg_tracing_14-0.1.3-2PIGSTY.el8.aarch64.rpm PIGSTY · 0.1.3 · 47.3KiB
el9.x86_64	PIGSTY 0.1.3 el9.x86_64.pg18 : pg_tracing_18 pg_tracing_18-0.1.3-2PIGSTY.el9.x86_64.rpm PIGSTY · 0.1.3 · 43.9KiB	PIGSTY 0.1.3 el9.x86_64.pg17 : pg_tracing_17 pg_tracing_17-0.1.3-2PIGSTY.el9.x86_64.rpm PIGSTY · 0.1.3 · 43.9KiB	PIGSTY 0.1.3 el9.x86_64.pg16 : pg_tracing_16 pg_tracing_16-0.1.3-2PIGSTY.el9.x86_64.rpm PIGSTY · 0.1.3 · 43.9KiB	PIGSTY 0.1.3 el9.x86_64.pg15 : pg_tracing_15 pg_tracing_15-0.1.3-2PIGSTY.el9.x86_64.rpm PIGSTY · 0.1.3 · 46.4KiB	PIGSTY 0.1.3 el9.x86_64.pg14 : pg_tracing_14 pg_tracing_14-0.1.3-2PIGSTY.el9.x86_64.rpm PIGSTY · 0.1.3 · 46.6KiB
el9.aarch64	PIGSTY 0.1.3 el9.aarch64.pg18 : pg_tracing_18 pg_tracing_18-0.1.3-2PIGSTY.el9.aarch64.rpm PIGSTY · 0.1.3 · 43.3KiB	PIGSTY 0.1.3 el9.aarch64.pg17 : pg_tracing_17 pg_tracing_17-0.1.3-2PIGSTY.el9.aarch64.rpm PIGSTY · 0.1.3 · 43.4KiB	PIGSTY 0.1.3 el9.aarch64.pg16 : pg_tracing_16 pg_tracing_16-0.1.3-2PIGSTY.el9.aarch64.rpm PIGSTY · 0.1.3 · 43.3KiB	PIGSTY 0.1.3 el9.aarch64.pg15 : pg_tracing_15 pg_tracing_15-0.1.3-2PIGSTY.el9.aarch64.rpm PIGSTY · 0.1.3 · 45.8KiB	PIGSTY 0.1.3 el9.aarch64.pg14 : pg_tracing_14 pg_tracing_14-0.1.3-2PIGSTY.el9.aarch64.rpm PIGSTY · 0.1.3 · 46.3KiB
el10.x86_64	PIGSTY 0.1.3 el10.x86_64.pg18 : pg_tracing_18 pg_tracing_18-0.1.3-2PIGSTY.el10.x86_64.rpm PIGSTY · 0.1.3 · 44.4KiB	PIGSTY 0.1.3 el10.x86_64.pg17 : pg_tracing_17 pg_tracing_17-0.1.3-2PIGSTY.el10.x86_64.rpm PIGSTY · 0.1.3 · 44.4KiB	PIGSTY 0.1.3 el10.x86_64.pg16 : pg_tracing_16 pg_tracing_16-0.1.3-2PIGSTY.el10.x86_64.rpm PIGSTY · 0.1.3 · 44.5KiB	PIGSTY 0.1.3 el10.x86_64.pg15 : pg_tracing_15 pg_tracing_15-0.1.3-2PIGSTY.el10.x86_64.rpm PIGSTY · 0.1.3 · 46.8KiB	PIGSTY 0.1.3 el10.x86_64.pg14 : pg_tracing_14 pg_tracing_14-0.1.3-2PIGSTY.el10.x86_64.rpm PIGSTY · 0.1.3 · 47.3KiB
el10.aarch64	PIGSTY 0.1.3 el10.aarch64.pg18 : pg_tracing_18 pg_tracing_18-0.1.3-2PIGSTY.el10.aarch64.rpm PIGSTY · 0.1.3 · 43.7KiB	PIGSTY 0.1.3 el10.aarch64.pg17 : pg_tracing_17 pg_tracing_17-0.1.3-2PIGSTY.el10.aarch64.rpm PIGSTY · 0.1.3 · 43.6KiB	PIGSTY 0.1.3 el10.aarch64.pg16 : pg_tracing_16 pg_tracing_16-0.1.3-2PIGSTY.el10.aarch64.rpm PIGSTY · 0.1.3 · 43.5KiB	PIGSTY 0.1.3 el10.aarch64.pg15 : pg_tracing_15 pg_tracing_15-0.1.3-2PIGSTY.el10.aarch64.rpm PIGSTY · 0.1.3 · 46.2KiB	PIGSTY 0.1.3 el10.aarch64.pg14 : pg_tracing_14 pg_tracing_14-0.1.3-2PIGSTY.el10.aarch64.rpm PIGSTY · 0.1.3 · 46.8KiB
d12.x86_64	PIGSTY 0.1.3 d12.x86_64.pg18 : postgresql-18-pg-tracing postgresql-18-pg-tracing_0.1.3-2PIGSTY~bookworm_amd64.deb PIGSTY · 0.1.3 · 105.3KiB	PIGSTY 0.1.3 d12.x86_64.pg17 : postgresql-17-pg-tracing postgresql-17-pg-tracing_0.1.3-2PIGSTY~bookworm_amd64.deb PIGSTY · 0.1.3 · 105.4KiB	PIGSTY 0.1.3 d12.x86_64.pg16 : postgresql-16-pg-tracing postgresql-16-pg-tracing_0.1.3-2PIGSTY~bookworm_amd64.deb PIGSTY · 0.1.3 · 105.4KiB	PIGSTY 0.1.3 d12.x86_64.pg15 : postgresql-15-pg-tracing postgresql-15-pg-tracing_0.1.3-2PIGSTY~bookworm_amd64.deb PIGSTY · 0.1.3 · 108.2KiB	PIGSTY 0.1.3 d12.x86_64.pg14 : postgresql-14-pg-tracing postgresql-14-pg-tracing_0.1.3-2PIGSTY~bookworm_amd64.deb PIGSTY · 0.1.3 · 109.6KiB
d12.aarch64	PIGSTY 0.1.3 d12.aarch64.pg18 : postgresql-18-pg-tracing postgresql-18-pg-tracing_0.1.3-2PIGSTY~bookworm_arm64.deb PIGSTY · 0.1.3 · 102.9KiB	PIGSTY 0.1.3 d12.aarch64.pg17 : postgresql-17-pg-tracing postgresql-17-pg-tracing_0.1.3-2PIGSTY~bookworm_arm64.deb PIGSTY · 0.1.3 · 103.0KiB	PIGSTY 0.1.3 d12.aarch64.pg16 : postgresql-16-pg-tracing postgresql-16-pg-tracing_0.1.3-2PIGSTY~bookworm_arm64.deb PIGSTY · 0.1.3 · 102.9KiB	PIGSTY 0.1.3 d12.aarch64.pg15 : postgresql-15-pg-tracing postgresql-15-pg-tracing_0.1.3-2PIGSTY~bookworm_arm64.deb PIGSTY · 0.1.3 · 105.3KiB	PIGSTY 0.1.3 d12.aarch64.pg14 : postgresql-14-pg-tracing postgresql-14-pg-tracing_0.1.3-2PIGSTY~bookworm_arm64.deb PIGSTY · 0.1.3 · 107.0KiB
d13.x86_64	PIGSTY 0.1.3 d13.x86_64.pg18 : postgresql-18-pg-tracing postgresql-18-pg-tracing_0.1.3-2PIGSTY~trixie_amd64.deb PIGSTY · 0.1.3 · 105.4KiB	PIGSTY 0.1.3 d13.x86_64.pg17 : postgresql-17-pg-tracing postgresql-17-pg-tracing_0.1.3-2PIGSTY~trixie_amd64.deb PIGSTY · 0.1.3 · 105.6KiB	PIGSTY 0.1.3 d13.x86_64.pg16 : postgresql-16-pg-tracing postgresql-16-pg-tracing_0.1.3-2PIGSTY~trixie_amd64.deb PIGSTY · 0.1.3 · 105.5KiB	PIGSTY 0.1.3 d13.x86_64.pg15 : postgresql-15-pg-tracing postgresql-15-pg-tracing_0.1.3-2PIGSTY~trixie_amd64.deb PIGSTY · 0.1.3 · 108.2KiB	PIGSTY 0.1.3 d13.x86_64.pg14 : postgresql-14-pg-tracing postgresql-14-pg-tracing_0.1.3-2PIGSTY~trixie_amd64.deb PIGSTY · 0.1.3 · 109.6KiB
d13.aarch64	PIGSTY 0.1.3 d13.aarch64.pg18 : postgresql-18-pg-tracing postgresql-18-pg-tracing_0.1.3-2PIGSTY~trixie_arm64.deb PIGSTY · 0.1.3 · 103.5KiB	PIGSTY 0.1.3 d13.aarch64.pg17 : postgresql-17-pg-tracing postgresql-17-pg-tracing_0.1.3-2PIGSTY~trixie_arm64.deb PIGSTY · 0.1.3 · 103.7KiB	PIGSTY 0.1.3 d13.aarch64.pg16 : postgresql-16-pg-tracing postgresql-16-pg-tracing_0.1.3-2PIGSTY~trixie_arm64.deb PIGSTY · 0.1.3 · 103.5KiB	PIGSTY 0.1.3 d13.aarch64.pg15 : postgresql-15-pg-tracing postgresql-15-pg-tracing_0.1.3-2PIGSTY~trixie_arm64.deb PIGSTY · 0.1.3 · 106.0KiB	PIGSTY 0.1.3 d13.aarch64.pg14 : postgresql-14-pg-tracing postgresql-14-pg-tracing_0.1.3-2PIGSTY~trixie_arm64.deb PIGSTY · 0.1.3 · 107.5KiB
u22.x86_64	PIGSTY 0.1.3 u22.x86_64.pg18 : postgresql-18-pg-tracing postgresql-18-pg-tracing_0.1.3-2PIGSTY~jammy_amd64.deb PIGSTY · 0.1.3 · 114.7KiB	PIGSTY 0.1.3 u22.x86_64.pg17 : postgresql-17-pg-tracing postgresql-17-pg-tracing_0.1.3-2PIGSTY~jammy_amd64.deb PIGSTY · 0.1.3 · 129.3KiB	PIGSTY 0.1.3 u22.x86_64.pg16 : postgresql-16-pg-tracing postgresql-16-pg-tracing_0.1.3-2PIGSTY~jammy_amd64.deb PIGSTY · 0.1.3 · 128.8KiB	PIGSTY 0.1.3 u22.x86_64.pg15 : postgresql-15-pg-tracing postgresql-15-pg-tracing_0.1.3-2PIGSTY~jammy_amd64.deb PIGSTY · 0.1.3 · 132.0KiB	PIGSTY 0.1.3 u22.x86_64.pg14 : postgresql-14-pg-tracing postgresql-14-pg-tracing_0.1.3-2PIGSTY~jammy_amd64.deb PIGSTY · 0.1.3 · 133.2KiB
u22.aarch64	PIGSTY 0.1.3 u22.aarch64.pg18 : postgresql-18-pg-tracing postgresql-18-pg-tracing_0.1.3-2PIGSTY~jammy_arm64.deb PIGSTY · 0.1.3 · 113.7KiB	PIGSTY 0.1.3 u22.aarch64.pg17 : postgresql-17-pg-tracing postgresql-17-pg-tracing_0.1.3-2PIGSTY~jammy_arm64.deb PIGSTY · 0.1.3 · 128.1KiB	PIGSTY 0.1.3 u22.aarch64.pg16 : postgresql-16-pg-tracing postgresql-16-pg-tracing_0.1.3-2PIGSTY~jammy_arm64.deb PIGSTY · 0.1.3 · 127.6KiB	PIGSTY 0.1.3 u22.aarch64.pg15 : postgresql-15-pg-tracing postgresql-15-pg-tracing_0.1.3-2PIGSTY~jammy_arm64.deb PIGSTY · 0.1.3 · 130.8KiB	PIGSTY 0.1.3 u22.aarch64.pg14 : postgresql-14-pg-tracing postgresql-14-pg-tracing_0.1.3-2PIGSTY~jammy_arm64.deb PIGSTY · 0.1.3 · 132.7KiB
u24.x86_64	PIGSTY 0.1.3 u24.x86_64.pg18 : postgresql-18-pg-tracing postgresql-18-pg-tracing_0.1.3-2PIGSTY~noble_amd64.deb PIGSTY · 0.1.3 · 110.1KiB	PIGSTY 0.1.3 u24.x86_64.pg17 : postgresql-17-pg-tracing postgresql-17-pg-tracing_0.1.3-2PIGSTY~noble_amd64.deb PIGSTY · 0.1.3 · 110.2KiB	PIGSTY 0.1.3 u24.x86_64.pg16 : postgresql-16-pg-tracing postgresql-16-pg-tracing_0.1.3-2PIGSTY~noble_amd64.deb PIGSTY · 0.1.3 · 110.1KiB	PIGSTY 0.1.3 u24.x86_64.pg15 : postgresql-15-pg-tracing postgresql-15-pg-tracing_0.1.3-2PIGSTY~noble_amd64.deb PIGSTY · 0.1.3 · 113.1KiB	PIGSTY 0.1.3 u24.x86_64.pg14 : postgresql-14-pg-tracing postgresql-14-pg-tracing_0.1.3-2PIGSTY~noble_amd64.deb PIGSTY · 0.1.3 · 114.1KiB
u24.aarch64	PIGSTY 0.1.3 u24.aarch64.pg18 : postgresql-18-pg-tracing postgresql-18-pg-tracing_0.1.3-2PIGSTY~noble_arm64.deb PIGSTY · 0.1.3 · 109.2KiB	PIGSTY 0.1.3 u24.aarch64.pg17 : postgresql-17-pg-tracing postgresql-17-pg-tracing_0.1.3-2PIGSTY~noble_arm64.deb PIGSTY · 0.1.3 · 109.2KiB	PIGSTY 0.1.3 u24.aarch64.pg16 : postgresql-16-pg-tracing postgresql-16-pg-tracing_0.1.3-2PIGSTY~noble_arm64.deb PIGSTY · 0.1.3 · 109.1KiB	PIGSTY 0.1.3 u24.aarch64.pg15 : postgresql-15-pg-tracing postgresql-15-pg-tracing_0.1.3-2PIGSTY~noble_arm64.deb PIGSTY · 0.1.3 · 112.4KiB	PIGSTY 0.1.3 u24.aarch64.pg14 : postgresql-14-pg-tracing postgresql-14-pg-tracing_0.1.3-2PIGSTY~noble_arm64.deb PIGSTY · 0.1.3 · 113.9KiB
u26.x86_64	PIGSTY 0.1.3 u26.x86_64.pg18 : postgresql-18-pg-tracing postgresql-18-pg-tracing_0.1.3-2PIGSTY~resolute_amd64.deb PIGSTY · 0.1.3 · 109.5KiB	PIGSTY 0.1.3 u26.x86_64.pg17 : postgresql-17-pg-tracing postgresql-17-pg-tracing_0.1.3-2PIGSTY~resolute_amd64.deb PIGSTY · 0.1.3 · 109.6KiB	PIGSTY 0.1.3 u26.x86_64.pg16 : postgresql-16-pg-tracing postgresql-16-pg-tracing_0.1.3-2PIGSTY~resolute_amd64.deb PIGSTY · 0.1.3 · 109.6KiB	PIGSTY 0.1.3 u26.x86_64.pg15 : postgresql-15-pg-tracing postgresql-15-pg-tracing_0.1.3-2PIGSTY~resolute_amd64.deb PIGSTY · 0.1.3 · 112.1KiB	PIGSTY 0.1.3 u26.x86_64.pg14 : postgresql-14-pg-tracing postgresql-14-pg-tracing_0.1.3-2PIGSTY~resolute_amd64.deb PIGSTY · 0.1.3 · 113.1KiB
u26.aarch64	PIGSTY 0.1.3 u26.aarch64.pg18 : postgresql-18-pg-tracing postgresql-18-pg-tracing_0.1.3-2PIGSTY~resolute_arm64.deb PIGSTY · 0.1.3 · 108.0KiB	PIGSTY 0.1.3 u26.aarch64.pg17 : postgresql-17-pg-tracing postgresql-17-pg-tracing_0.1.3-2PIGSTY~resolute_arm64.deb PIGSTY · 0.1.3 · 108.0KiB	PIGSTY 0.1.3 u26.aarch64.pg16 : postgresql-16-pg-tracing postgresql-16-pg-tracing_0.1.3-2PIGSTY~resolute_arm64.deb PIGSTY · 0.1.3 · 107.9KiB	PIGSTY 0.1.3 u26.aarch64.pg15 : postgresql-15-pg-tracing postgresql-15-pg-tracing_0.1.3-2PIGSTY~resolute_arm64.deb PIGSTY · 0.1.3 · 111.0KiB	PIGSTY 0.1.3 u26.aarch64.pg14 : postgresql-14-pg-tracing postgresql-14-pg-tracing_0.1.3-2PIGSTY~resolute_arm64.deb PIGSTY · 0.1.3 · 112.8KiB

构建

您可以使用 pig build 命令构建 pg_tracing 扩展的 RPM / DEB 包：

BASH

pig build pkg pg_tracing         # 构建 RPM / DEB 包

安装

您可以直接安装 pg_tracing 扩展包的预置二进制包，首先确保 PGDG 和 PIGSTY 仓库已经添加并启用：

BASH

pig repo add pgsql -u          # 添加仓库并更新缓存

使用 pig 或者是 apt/yum/dnf 安装扩展：

安装

BASH

pig install pg_tracing;          # 当前活跃 PG 版本安装

pig

BASH

pig ext install -y pg_tracing -v 18  # PG 18
pig ext install -y pg_tracing -v 17  # PG 17
pig ext install -y pg_tracing -v 16  # PG 16
pig ext install -y pg_tracing -v 15  # PG 15
pig ext install -y pg_tracing -v 14  # PG 14

dnf

BASH

dnf install -y pg_tracing_18       # PG 18
dnf install -y pg_tracing_17       # PG 17
dnf install -y pg_tracing_16       # PG 16
dnf install -y pg_tracing_15       # PG 15
dnf install -y pg_tracing_14       # PG 14

apt

BASH

apt install -y postgresql-18-pg-tracing   # PG 18
apt install -y postgresql-17-pg-tracing   # PG 17
apt install -y postgresql-16-pg-tracing   # PG 16
apt install -y postgresql-15-pg-tracing   # PG 15
apt install -y postgresql-14-pg-tracing   # PG 14

预加载配置：

BASH

shared_preload_libraries = 'pg_tracing';

创建扩展：

SQL

CREATE EXTENSION pg_tracing;

用法

pg_tracing: PostgreSQL 分布式追踪

pg_tracing 生成服务端 Span 用于分布式追踪。它为规划器、执行器、计划节点、嵌套查询、触发器、并行工作进程和事务提交创建 Span。

通过 SQLCommenter 传播追踪上下文

将追踪上下文作为 SQL 注释传递。带有采样标志的查询将生成 Span：

SQL

/*traceparent='00-00000000000000000000000000000123-0000000000000123-01'*/ SELECT 1;

通过 GUC 传播追踪上下文

SQL

BEGIN;
SET LOCAL pg_tracing.trace_context='traceparent=''00-00000000000000000000000000000005-0000000000000005-01''';
UPDATE pgbench_accounts SET abalance=1 WHERE aid=1;
COMMIT;

独立采样

无需外部追踪上下文，随机采样查询：

SQL

SET pg_tracing.sample_rate = 1.0;  -- 追踪所有查询
SELECT 1;

查看 Span

SQL

-- 消费 Span（从缓冲区移除）
SELECT trace_id, parent_id, span_id, span_start, span_end, span_type, span_operation
FROM pg_tracing_consume_spans ORDER BY span_start;

-- 查看 Span（非破坏性）
SELECT * FROM pg_tracing_peek_spans;

-- 导出为 OTLP JSON
SELECT pg_tracing_json_spans();

统计信息

SQL

SELECT * FROM pg_tracing_info;
SELECT pg_tracing_reset();

发送 Span 到 OpenTelemetry Collector

在 postgresql.conf 中配置：

pg_tracing.otel_endpoint = http://127.0.0.1:4318/v1/traces
pg_tracing.otel_naptime = 2000

关键 GUC 参数

参数	默认值	描述
`pg_tracing.max_span`	10000	共享内存中的最大 Span 数
`pg_tracing.track`	`all`	追踪哪些语句
`pg_tracing.sample_rate`	0	随机采样查询的比例
`pg_tracing.otel_endpoint`	(空)	用于 Span 导出的 OTLP HTTP 端点

意见反馈

这个页面对您有帮助吗？

感谢反馈！请告诉我们如何改进。

抱歉给您带来不便。请告诉我们如何改进。