跳转到主要内容

设计归档

设计归档解释 PG Exporter 为什么采用今天的实现方式。每篇文章都会区分设计、实现、合并、发布、软件包、部署与生产验证，避免把一项已经接受的设计误读成已经发布的功能。

当前产品行为以使用手册为准，已经交付的版本以发布归档为准；本栏目记录形成这些结果的理由、备选方案、不变量与验证证据。

把 PostgreSQL CSV 日志转成持久指标 设计PostgreSQL日志Prometheus可靠性
把 pgBackRest 指标移出抓取路径 设计pgBackRestPrometheus可靠性
我们最终没有做的 PostgreSQL 可观测性产品 设计产品PostgreSQL可观测性
一个端点，多种来源：Composite Exporter 契约 设计架构PrometheusPgBouncerPatroni
快照直方图是 Gauge，不是 Counter 设计HistogramPrometheusPostgreSQL

  • 把 PostgreSQL CSV 日志转成持久指标

    Vonng 发布于 设计 3903 字 8 分钟

    Vonngdesign设计PostgreSQL日志Prometheus可靠性

    Featured Image for 把 PostgreSQL CSV 日志转成持久指标

    决策状态： 已在开发线实现；截至 2026-08-28，尚未进入 main、tag 或公开软件包。 决策日期： 2026-08-24。 适用范围： Composite Exporter 中默认关闭的 PostgreSQL 14+ CSV 日志 collector。 取代： 我们最终没有做的 PostgreSQL 可观测性产品中独立产品的方向。 发布边界： 已有实现与源码测试；合并、release、软件包、Pigsty 部署与生产 canary 仍是独立门槛。 PostgreSQL 日志包含 …

    决策状态： 已在开发线实现；截至 2026-08-28，尚未进入 main、tag 或公开软件包。 决策日期： 2026-08-24。 适用范围： Composite Exporter 中默认关闭的 PostgreSQL 14+ CSV 日志 collector。 取代： 我们最终没有做的 PostgreSQL 可观测性产品中独立产品的方向。 发布边界： 已有实现与源码测试；合并、release、软件包、Pigsty 部署与生产 canary 仍是独立门槛。 PostgreSQL 日志包含 …

  • 把 pgBackRest 指标移出抓取路径

    Vonng 发布于 设计 1736 字 4 分钟

    Vonngdesign设计pgBackRestPrometheus可靠性

    Featured Image for 把 pgBackRest 指标移出抓取路径

    决策状态： 已在开发线实现；截至 2026-08-28，尚未进入 main、tag 或公开软件包。 决策日期： 2026-08-23。 适用范围： Composite Exporter 内可选的 --pgbackrest 缓存组件。 发布边界： 源码行为已经实现并测试；公开版本、软件包、部署和独立 exporter 退役尚未验证。 pgBackRest 通过 pgbackrest info --output=json 暴露丰富的备份状态，但它提供的是命令，不是低延迟 metrics …

    决策状态： 已在开发线实现；截至 2026-08-28，尚未进入 main、tag 或公开软件包。 决策日期： 2026-08-23。 适用范围： Composite Exporter 内可选的 --pgbackrest 缓存组件。 发布边界： 源码行为已经实现并测试；公开版本、软件包、部署和独立 exporter 退役尚未验证。 pgBackRest 通过 pgbackrest info --output=json 暴露丰富的备份状态，但它提供的是命令，不是低延迟 metrics …

  • 我们最终没有做的 PostgreSQL 可观测性产品

    Vonng 发布于 设计 1952 字 4 分钟

    Vonngdesign设计产品PostgreSQL可观测性

    Featured Image for 我们最终没有做的 PostgreSQL 可观测性产品

    决策状态： 2026-08-24 被进程内 PostgreSQL CSV 日志指标方案取代。 研究日期： 2026-08-13。 仍然有效： CSV framing、轮转、SQLSTATE、隐私和有限基数结论。 不再适用： 新产品、仓库、binary、品牌、交互查询工具、TUI、Agent 或日志发送管道。 在收敛 PostgreSQL 日志指标范围之前，我们探索过一个大得多的产品：local-first 事故工作台。它可以检查结构化日志、重建 session 时间线、提供交互过滤与终端界面， …

    决策状态： 2026-08-24 被进程内 PostgreSQL CSV 日志指标方案取代。 研究日期： 2026-08-13。 仍然有效： CSV framing、轮转、SQLSTATE、隐私和有限基数结论。 不再适用： 新产品、仓库、binary、品牌、交互查询工具、TUI、Agent 或日志发送管道。 在收敛 PostgreSQL 日志指标范围之前，我们探索过一个大得多的产品：local-first 事故工作台。它可以检查结构化日志、重建 session 时间线、提供交互过滤与终端界面， …

  • 一个端点，多种来源：Composite Exporter 契约

    Vonng 发布于 设计 2378 字 5 分钟

    Vonngdesign设计架构PrometheusPgBouncerPatroni

    Featured Image for 一个端点，多种来源：Composite Exporter 契约

    决策状态： 已在开发线实现；截至 2026-08-28，尚未进入 main、tag 或公开软件包。 决策日期： 2026-08-11；2026-08-23 与 2026-08-24 又增加了缓存组件。 适用范围： PostgreSQL、PgBouncer、Patroni、pgBackRest 与 PostgreSQL CSV 日志指标的可选 Composite 协调层。 发布边界： 已有设计与实现证据；合并、tag、软件包、部署和生产替换仍是独立门槛。 PG Exporter 最初是针对一个 …

    决策状态： 已在开发线实现；截至 2026-08-28，尚未进入 main、tag 或公开软件包。 决策日期： 2026-08-11；2026-08-23 与 2026-08-24 又增加了缓存组件。 适用范围： PostgreSQL、PgBouncer、Patroni、pgBackRest 与 PostgreSQL CSV 日志指标的可选 Composite 协调层。 发布边界： 已有设计与实现证据；合并、tag、软件包、部署和生产替换仍是独立门槛。 PG Exporter 最初是针对一个 …

  • 快照直方图是 Gauge，不是 Counter

    Vonng 发布于 设计 1936 字 4 分钟

    Vonngdesign设计HistogramPrometheusPostgreSQL

    Featured Image for 快照直方图是 Gauge，不是 Counter

    决策状态： 已随 v1.4.0 发布。 决策日期： 2026-07-11；发布前于 2026-07-17 完成修订。 适用范围： PG Exporter v1.4.0 及后续版本中的 HISTOGRAM 列与内置 pg_xact_age 采集器。 发布边界： 本文描述已经发布的源码与指标契约；Dashboard 与 recording rule 仍由消费者负责。 PG Exporter 最初把每个 SQL 结果单元映射成标量 Gauge 或 Counter。它能回答“最老事务有多老”，却无法保 …

    决策状态： 已随 v1.4.0 发布。 决策日期： 2026-07-11；发布前于 2026-07-17 完成修订。 适用范围： PG Exporter v1.4.0 及后续版本中的 HISTOGRAM 列与内置 pg_xact_age 采集器。 发布边界： 本文描述已经发布的源码与指标契约；Dashboard 与 recording rule 仍由消费者负责。 PG Exporter 最初把每个 SQL 结果单元映射成标量 Gauge 或 Counter。它能回答“最老事务有多老”，却无法保 …

最后修改 2026-08-28