# 设计归档

> PG Exporter 的架构决策、被否决方案与实现契约

---

LLMS 索引： [llms.txt](/zh/llms.txt)

---

设计记录解释 PG Exporter 的架构、备选方案与取舍。每篇注明状态、源码边界和最后核验日期。

快照直方图已随 v1.4.0 发布。[复制采集器修正](/zh/design/replication-collector-contracts/)与[目标状态约定](/zh/design/target-state-contracts/)已随 v1.5.0 发布。Composite 模式、缓存 pgBackRest 指标和 PostgreSQL 日志指标已在开发分支实现，尚未进入稳定版 v1.6.0。独立可观测性产品提案已被取代。

稳定版操作方法见[使用手册](/zh/docs/)，已发布变更见[发布归档](/zh/release/)。

---

本节页面：

- [SQL 采集的总时限与客户端取消](/zh/design/scrape-lifetime/)
- [保留集群进度与准确的关系标识](/zh/design/progress-database-scope/)
- [容器信任根与发布检查](/zh/design/container-trust/)
- [目标身份与一致的健康检查响应](/zh/design/target-state-contracts/)
- [复制采集器的身份、状态与权限修正](/zh/design/replication-collector-contracts/): 订阅身份、接收器状态、复制源权限和关系计数的最小修正
- [把 PostgreSQL CSV 日志转成持久指标](/zh/design/postgres-log-metrics/): 读取完整 CSV 记录，持久化游标与聚合值，发布有界 PostgreSQL 日志指标
- [把 pgBackRest 指标移出抓取路径](/zh/design/cached-pgbackrest-metrics/): 在有界后台任务中执行 pgBackRest，并提供最后一份有效指标快照
- [我们最终没有做的 PostgreSQL 可观测性产品](/zh/design/observability-product-pivot/): 为什么独立事故工作台最终变为 PG Exporter 内的 CSV 日志采集器
- [一个端点，多种来源：Composite Exporter 契约](/zh/design/composite-exporter/): 通过固定所有权和独立故障处理，合并 PostgreSQL 与可选来源的指标
- [快照直方图是 Gauge，不是 Counter](/zh/design/snapshot-histograms/): 为什么 SQL 快照分布将桶、计数与总和输出为 Gauge 序列