地理空间数据可观测性

面向空间数据 pipeline 的运维监控 —— 传统 APM 无法察觉的遥测数据。
用于在几何级别检测 GIS 工作流的即用型架构与操作手册： 新鲜度 SLA、坐标参考系统漂移、拓扑校验、索引健康度以及事件响应。

🌐 www.dataobservability.org

## 这是什么 [**dataobservability.org**](https://www.dataobservability.org) 是一个开放且深度交叉链接的 参考资料，专为致力于保障空间数据 pipeline 准确性的工程师打造。标准的应用程序监控 会跟踪延迟、内存和查询时间，但对那些实际上会破坏 GIS 平台的故障却视而不见：上游静默重新投影的坐标参考系统、通过了行数检查却破坏了下游所有空间连接的自相交多边形、看似最新却在提供一周前快照的切片图层，或者是静默退化为顺序扫描的 GiST 索引。 每份指南都直接针对这些故障模式进行检测 —— 将底层概念（CRS 完整性、几何有效性、信任边界、新鲜度预算）与 PostGIS SQL、OpenTelemetry collector 配置、PromQL 告警规则和 Python 中完整的、可直接复制的实现相结合。这里没有任何伪代码：每一页的内容都按照从业者构建可观测 pipeline 的方式来组织 —— 首先是架构，然后是可运行的 instrumentation，接着是针对 空间工作非线性成本调优的告警阈值，最后是你在凌晨 3 点真正需要用到的故障排查手册。 ## 适用人群 - **数据工程师**：负责空间 ETL，并需要让其大声报错而不是静默失败。 - **GIS 平台管理员**：大规模运行 PostGIS、GeoServer、切片 pipeline 和要素服务器。 - **站点可靠性工程师 (SRE)**：将空间信号接入 OpenTelemetry、Prometheus 和 Grafana。 - **合规与运维团队**：必须按需证明数据的新鲜度、覆盖范围和血缘。 ## 包含内容 这些材料被组织为三份深度指南，每份都链接到专注于特定主题的实操内容： - **[架构与基础](https://www.dataobservability.org/geospatial-observability-architecture-fundamentals/)** —— 信任边界、空间指标分类法、OpenTelemetry instrumentation、多区域 拓扑、矢量数据范围界定、空间索引健康度以及平滑的 API 降级链。 - **[新鲜度与质量指标](https://www.dataobservability.org/spatial-data-freshness-quality-metrics/)** —— 新鲜度 SLA、坐标参考系统校验、几何与拓扑检查、覆盖范围与 边界监控、时间基线对齐、属性同步以及 schema/属性漂移检测。 - **[事件响应与工具](https://www.dataobservability.org/spatial-incident-response-and-tooling/)** —— 工具决策指南（GiST vs BRIN、OpenTelemetry vs Prometheus 原生、Push vs Pull）以及针对触发值班人员寻呼的故障模式的 检测 → 分诊 → 修复 → 复盘 操作手册。 在整个网站中，您将发现 50 多篇相互关联的指南，其中包含手绘的架构图、 指标参考表、用于复合新鲜度和阈值分数的 KaTeX 公式，以及您可以调整为适应自己技术栈的可运行 配置。 ## 独特之处 - **几何级别，而非主机级别** —— 诸如 CRS 漂移、顶点数分布、拓扑 错误率和要素级别的复制延迟等信号，是一般基础设施工具永远无法捕捉到的。 - **可运行，而非含糊其辞** —— 真实的 PostGIS 函数（`ST_IsValid`、`ST_SRID`、`ST_Extent`， `ST_MakeValid`）、contrib 版本构建的 OpenTelemetry 处理器，以及具有分级严重程度的 PromQL 规则。 - **坦诚面对失败** —— 每一页都以边缘情况和陷阱结尾：通过了 有效性检查的 SRID 不匹配、丢弃了你所需的拓扑错误 span 的自适应采样、由于 批量加载导致的索引膨胀，以及看起来正确直到突然出错的轴序交换。 - **为按顺序阅读而设计** —— 严密的内部链接图谱将每个主题置于距离其 父指南仅一两次点击的位置。 ## 构建方式 一个使用 [Eleventy](https://www.11ty.dev/) 生成并由 [Cloudflare Workers](https://developers.cloudflare.com/workers/) 提供服务的静态站点。内容使用 Markdown 编写， 标题和导航派生自目录结构，每页都会发出结构化数据（面包屑导航和 文章 schema），数学公式使用自托管的 [KaTeX](https://katex.org/) 渲染。 ``` npm install # install dependencies npm run build # generate the static site into _site/ npm run serve # local preview with live reload ``` ## 关于本仓库 本仓库包含该站点的全部源代码 —— 每一份指南、图表、样式表和构建 脚本。欢迎对技术内容进行更正和改进；如果某个查询、阈值或 配置片段可以变得更准确或更贴近生产实际，这正是 值得发起 PR 的改动。 ## 许可证与链接 - 🌐 网站：**[www.dataobservability.org](https://www.dataobservability.org)** - 🧭 从这里开始：[架构与基础](https://www.dataobservability.org/geospatial-observability-architecture-fundamentals/) - 📈 或直接跳转至：[新鲜度与质量指标](https://www.dataobservability.org/spatial-data-freshness-quality-metrics/) · [事件响应与工具](https://www.dataobservability.org/spatial-incident-response-and-tooling/) 内容版权归站点作者所有。代码按“原样”提供，供您在自己的空间 数据 pipeline 中参考和重用。

标签：GET参数, OpenTelemetry, PostGIS, 数据可观测性, 数据质量, 用户代理, 监控告警, 程序员工具, 空间数据, 自定义脚本, 自定义请求头, 逆向工具