OpenStatus 探测层为何选择 GoADR-0004 架构决策全解析【免费下载链接】openstatus Status page with uptime monitoring API monitoring as code 项目地址: https://gitcode.com/GitHub_Trending/op/openstatus本文基于 OpenStatus 仓库中的架构决策记录 docs/adr/0004-go-for-the-probing-tier.md 展开。OpenStatus 是一款以「代码即监控」为理念的合成监控产品状态页 可用性监控 API 监控其核心任务是从全球多个地理位置探测客户端点——HTTP、TCP、ICMP、UDP、DNS、SSL——并逐阶段记录每次探测的耗时DNS、连接、TLS 握手、首字节、传输。本篇文章将深入剖析为什么这一探测层最终选择了 Go 而非 TypeScript 或 RustGo 在标准库、并发模型、交付形态上如何支撑一个运行在约 35 个 fly.io 区域、单机 512MB 内存、承受上千并发探测的探针舰队读完你将对跨语言架构边界的划分、探测时序数据的采集原理以及静态二进制自托管交付有完整的可落地方案认知。一、决策背景探测服务是什么运行在哪里在展开语言选型之前必须先理解探测层在 OpenStatus 架构中的角色与运行约束。根据 ADR-0004 的描述探测服务apps/checker以**舰队fleet**形态运行部署在约 35 个 fly.io 区域每台机器是512MB 内存 / 2 共享 CPU的小型 VM单机需要处理约 1000 个并发请求该数值与 apps/checker/fly.toml 中http_service.concurrency的hard_limit 1000、soft_limit 500配置互相印证同时它以 Docker 镜像的形式交付给客户在客户自有的基础设施上运行承担私有位置private location监控对应代码在apps/private-location。而 OpenStatus 的其余部分——Dashboard、API Server、共享包——全部是 TypeScript。于是 ADR-0004 要回答的核心问题是探测这一层应该用什么语言写这里的关键洞察在于一次探测任务会**扇出fan-out**为大量并发、且绝大部分时间处于空闲等待的网络探针。这种 I/O 密集、等待密集的工作负载对运行时的并发开销、内存占用、冷启动速度都提出了特定要求。二、决策驱动力五个硬性约束ADR-0004 明确了五项决策驱动因素它们共同构成了选型的天平并发要便宜单个检查会扇出为大量并发的、大多处于空闲状态的网络探针运行时必须让这种并发变得廉价。小 VM 上的效率是经常性成本舰队运行在约 35 个区域的小型 VM 上低内存占用和快速冷启动至关重要。需要底层网络控制能力逐阶段请求计时、原始 ICMP、自定义 dialer——而不是仅仅一个fetch。交付物必须小巧可移植探针 Agent 要能作为独立的、自包含的产物让客户在自有基础设施上运行。与系统其余部分的契约是数据而非共享代码探测层与业务层之间通过显式数据契约通信。这五条驱动因素直接决定了候选方案的评价标准并发模型效率、运行时体积、底层网络 API 可达性、交付形态、以及跨语言协作成本。三、候选方案与对比ADR-0004 对比了三个选项Go、TypeScript / Node与其余技术栈保持一致、Rust。维度GoTypeScript / NodeRust并发模型goroutine扇出廉价且简单事件循环 异步着色VM 更重与 Go 同级的效率与控制力网络底层能力net/net/http标准库直接暴露 httptrace、原始 socket底层网络计时和非 HTTP 协议探测别扭且部分不可用同 Go交付形态静态链接二进制小巧可移植需要运行时冷启动慢静态二进制但迭代慢、学习曲线陡团队学习成本中需引入第二门语言低全栈统一 TS高团队其余后端技能是 TS主要代价仓库变为多语言每 VM 运行时更重、跨大型舰队冷启动更慢对 I/O 密集型工作负载相比 Go 的并发收益边际ADR 对 Rust 的评价尤为值得注意Rust 虽然在效率和网络控制上能与 Go 媲美但对于一个团队其余后端技能均为 TypeScript 的仓库而言迭代速度更慢、学习曲线更陡且对于这个 I/O 密集型的探测负载Rust 相对 Go 的并发优势是**边际marginal**的——这并非贬低 Rust而是说明选型必须结合团队与工作负载特征。TypeScript / Node 的优势在于全仓库单一语言、共享类型断言、区域代码、schema但代价是每个 VM 运行时更重、跨大型舰队冷启动更慢且低层网络计时与非 HTTP 协议探测在 Node 生态中部分不可用——这正是探测产品的地基能力。四、决策结果Go 被限定在探测边界ADR-0004 的结论是探测层apps/checker与apps/private-location用 Go 编写OpenStatus 其余部分保持 TypeScript。理由有三且都能在仓库源码中找到直接对应4.1 goroutine让探针扇出变得廉价Go 的 goroutine 让大规模探测扇出无需异步着色async-coloring模型或线程池模型。当一次检查需要同时向多个目标发起连接、且每个连接大部分时间在等待网络时goroutine 的微栈调度使数千个并发探针的开销可以忽略。4.2 标准库httptrace 直接支撑产品级分阶段计时ADR 明确写道Go 的net/net/http标准库暴露了产品所依赖的底层钩子——httptrace提供了 OpenStatus 所报告的 DNS / connect / TLS / TTFB 分阶段计时。这在 apps/checker/checker/http.go 中有完整实现。Http函数构造了一个httptrace.ClientTrace通过DNSStart、DNSDone、ConnectStart、ConnectDone、TLSHandshakeStart、TLSHandshakeDone、GotConn、GotFirstResponseByte等回调把每一次 HTTP 探测拆解为毫秒级的十段时序type Timing struct { DnsStart int64 json:dnsStart DnsDone int64 json:dnsDone ConnectStart int64 json:connectStart ConnectDone int64 json:connectDone TlsHandshakeStart int64 json:tlsHandshakeStart TlsHandshakeDone int64 json:tlsHandshakeDone FirstByteStart int64 json:firstByteStart FirstByteDone int64 json:firstByteDone TransferStart int64 json:transferStart TransferDone int64 json:transferDone }随后通过req req.WithContext(httptrace.WithClientTrace(req.Context(), trace))将追踪器注入请求配合client.Do(req)前后记录总延迟。这些时序字段最终以 JSON 形态随响应输出——这正是探测结果数据契约的一部分详见下文第六节。此外http.go 还演示了一个值得借鉴的容错设计当请求失败时不直接返回 Go error而是构造一个带Error字段的Response——确保超时、连接拒绝、DNS 失败等所有故障形态都能被正常摄入并展示在 Dashboard 中而不是在探针内部被吞掉。4.3 原始 socket非 HTTP 协议探测的地基ADR 提到raw sockets cover the non-HTTP probe types。这在 apps/checker/checker/icmp.go 中得到最充分的体现这也是全仓库最底层的一段代码使用golang.org/x/net/icmp与ipv4/ipv6包直接构造 ICMP Echo 报文Echo ID 以进程 PID 为种子icmp.go因为原始 socket 会收到发往主机的所有 ICMP 包并发探测必须靠 echo id 区分而用 PID 做种子可避免重启后立即复用仍在途中的包 ID每次探测发送3 个包、间隔 100msicmpPacketCount/icmpPacketInterval常量icmp.go优先使用无特权数据报 socket失败时回退到原始 socketlistenICMPicmp.go兼容容器等缺乏ping_group_range权限的环境应答匹配逻辑sendEcho处理了两个精妙的细节原始 socket 上按 IP Echo ID Seq 匹配数据报 socket 上因内核会改写 Echo ID 而只能按 Seq 匹配对DstUnreach/TimeExceeded错误则通过provokedByProbe解析报文中引用的原始数据报quoted datagram来确认是否由本探针引发避免把别的流量的destination unreachable误判为自己的失败。最终输出的ICMPResult包含平均/最小/最大延迟、发包数、收包数以及每个包的 RTT 数组丢包以-1标记。非 HTTP 探测不止 ICMP还包括TCPapps/checker/checker/tcp.go 用net.DialTimeout实现端口连通性探测并对超时、连接拒绝、一般拨号错误做差异化错误消息DNSapps/checker/checker/dns.go 通过net.DefaultResolver的 context 感知方法LookupIP、LookupCNAME、LookupMX、LookupNS、LookupTXT抓取 A / AAAA / CNAME / MX / NS / TXT 全套记录注释中特别说明了为何不用包级net.Lookup*帮助函数——它们不接受 context卡住的 resolver 会让探针超过超时并阻塞 monitor 的下一轮运行同时 MX 和 TXT 容忍查询错误但若 deadline 到期则视为整体失败dns.gogRPCapps/checker/checker/grpc.go 定义了tls/plaintext/tls_insecure三种 TLS 模式并调用grpc_health_v1健康检查服务输出SERVING/NOT_SERVING/SERVICE_UNKNOWN/UNKNOWN等 ServingStatus。这些实现共同验证了 ADR 的核心判断探测产品的地基能力逐阶段计时、原始协议访问、自定义 dialer无法靠一个fetch完成Go 标准库恰好原生提供。4.4 静态二进制既是多区域镜像也是自托管产物ADR 指出静态链接的 Go 二进制以极小的多区域镜像部署同时作为自托管产物无需安装任何运行时。apps/checker/private-location.Dockerfile 完整展示了这一思路FROM --platform$BUILDPLATFORM golang:1.25-alpine as builder WORKDIR /go/src/app RUN apk add --no-cache tzdata ENV TZUTC ENV CGO_ENABLED0 COPY go.* . RUN go mod download COPY . . RUN GOOS${TARGETOS} GOARCH${TARGETARCH} go build -trimpath -ldflags -s -w -o private ./cmd/private FROM scratch WORKDIR /opt/bin COPY --frombuilder /etc/ssl/certs/ca-certificates.crt /etc/ssl/certs/ COPY --frombuilder /usr/share/zoneinfo /usr/share/zoneinfo COPY --frombuilder /go/src/app/private /opt/bin/private ENV TZUTC ENV USER1000 ENV GIN_MODErelease CMD [ /opt/bin/private ]几个关键点CGO_ENABLED0保证纯静态编译-trimpath -ldflags -s -w去除调试信息、缩小体积最终镜像以FROM scratch为基础只额外携带 CA 证书与时区数据——一个没有 shell、没有包管理器、没有任何运行时的自包含产物这正是客户在自己的基础设施上运行私有位置监控所需的交付形态。五、多语言代价被接受且被刻意限定边界ADR-0004 明确承认了多语言polyglot的代价并刻意将其限定在探测边界内产品与业务逻辑保留在 TypeScriptpackages/services遵循 ADR-0001 的业务逻辑位于服务层原则两个世界只通过显式数据契约通信——探测结果写入 Tinybird、任务通过 HTTP / Cloud Tasks / ConnectRPCpackages/proto投递——绝不共享进程内代码坏处是仓库成为多语言仓库探测层的贡献者需要同时掌握 Go 与 TypeScriptCI 需要携带第二套工具链没有跨边界的类型或逻辑共享断言求值存在两份实现——packages/assertionsTS与apps/checker/pkg/assertionsGo——需要手工保持同步中性项跨边界契约Tinybird schema、protobuf是显式且带版本的而非隐式约定。apps/checker/request/request.go是理解数据契约的窗口其中HttpCheckerRequest、TCPCheckerRequest、ICMPCheckerRequest、GRPCCheckerRequest、DNSCheckerRequest等结构体以 JSON tag 定义了探针任务的入参形态URL、Method、Headers、Timeout、Retry、DegradedAfter、OtelConfig……而探测结果则被序列化后写入 Tinybird 时序库。这套 JSON 契约就是 Go 世界与 TypeScript 世界之间的数据边界。Confirmation一节给出了边界维护的具体纪律新增探测 / 边缘 Agent 代码用 Go新增产品逻辑用 TypeScript写入packages/services任何跨边界重复的逻辑断言、区域代码都要在评审中显式指出确保两份拷贝同步演进。六、跨边界契约与 ADR-0005 的呼应ADR-0004 并非孤立决策它与另外两份 ADR 形成闭环docs/adr/0005-turso-for-app-data-tinybird-for-time-series.md探测舰队是 Tinybird 的主要写入方。每次检查的结果含逐阶段时序作为高吞吐、追加型时间序列写入 TinybirdDashboard 与 API 通过packages/tinybird读取按时间窗口聚合的指标1h / 1d / 7d / 45d 的 p95 延迟与可用性按区域分组。两套存储仅靠 ID 关联Tinybird 行携带monitorId/workspaceId无跨存储事务、无跨边界 JOIN。这种设计也意味着探测写入的洪峰不会拖垮应用数据库。docs/adr/0001-business-logic-lives-in-the-services-layer.md业务逻辑统一收敛在框架无关的packages/services层tRPC、Hono、MCP、后台任务共用而 Go 探测层完全不参与该层——两世界通过任务投递HTTP / Cloud Tasks / ConnectRPC契约定义于packages/proto与结果落库Tinybird交互。也就是说OpenStatus 的最终形态是Go 管探测、TS 管业务、Tinybird 管时序、Turso 管应用数据每一层只做自己擅长的事。七、运行与部署从本地到全球舰队结合 apps/checker/README.md 与 apps/checker/fly.toml探测层的运行与部署方式如下本地运行需设置环境变量go run cmd/main.goset CRON_SECRET YOLO set CLOUD_PROVIDER local set TINYBIRD_TOKEN random构建go build -o checker *.goDocker 运行docker build -t checker . docker run -p 8080:8080 checker部署到 fly.io 全部区域对应 ADR 所述的约 35 区域舰队fly scale count 35 --region ams,arn,atl,bog,bom,bos,cdg,den,dfw,ewr,eze,fra,gdl,gig,gru,hkg,iad,jnb,lax,lhr,mad,mia,nrt,ord,otp,phx,qro,scl,sjc,sea,sin,syd,waw,yul,yyzapps/checker/fly.toml 则定义了单机资源与健康检查形态cpu_kind shared、cpus 2、memory_mb 512http_service.checks以 15 秒间隔、5 秒超时探测/health端点并发限制为soft_limit 500、hard_limit 1000。这套配置与 ADR 中512MB / 2 共享 CPU / 约 1000 并发的描述完全吻合也解释了为何低内存 快冷启动会成为决策驱动力——在 35 个区域各跑这样的实例运行时的每一点效率开销都会被放大成经常性成本。八、总结什么时候该为边界选择另一门语言ADR-0004 提供的是一个可复用的架构决策范本而非单纯的Go vs Rust vs Node口水战。它的方法论可以拆解为先界定边界的运行约束并发形态、资源上限、交付形态、团队技能——这些才是选型的输入用标准库能力做硬性筛选当产品的地基能力这里是逐阶段网络计时与原始协议依赖运行时底层 API 时语言的标准库直接决定可行性为选型代价设定显式边界多语言不是原罪无界的多语言才是Go 被限定在探测边界业务逻辑仍归packages/services跨边界只走显式数据契约Tinybird 结果、protobuf 任务从而把协作成本降到可控用部署形态反向验证FROM scratch的静态二进制与 35 区域小 VM 舰队是效率 可移植性这两个抽象诉求的具体落地。对任何需要在大规模边缘探测、监控探针或类似 I/O 密集分布式 Agent 场景中做技术选型的团队这份 ADR 及其在仓库中的源码印证apps/checker/checker/http.go、apps/checker/checker/icmp.go、apps/checker/checker/dns.go、apps/checker/private-location.Dockerfile都是可以直接对照参考的完整案例。【免费下载链接】openstatus Status page with uptime monitoring API monitoring as code 项目地址: https://gitcode.com/GitHub_Trending/op/openstatus创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 OpenStatus 探测层为何选择 Go：ADR-0004 架构决策全解析
OpenStatus 探测层为何选择 GoADR-0004 架构决策全解析【免费下载链接】openstatus Status page with uptime monitoring API monitoring as code 项目地址: https://gitcode.com/GitHub_Trending/op/openstatus本文基于 OpenStatus 仓库中的架构决策记录 docs/adr/0004-go-for-the-probing-tier.md 展开。OpenStatus 是一款以「代码即监控」为理念的合成监控产品状态页 可用性监控 API 监控其核心任务是从全球多个地理位置探测客户端点——HTTP、TCP、ICMP、UDP、DNS、SSL——并逐阶段记录每次探测的耗时DNS、连接、TLS 握手、首字节、传输。本篇文章将深入剖析为什么这一探测层最终选择了 Go 而非 TypeScript 或 RustGo 在标准库、并发模型、交付形态上如何支撑一个运行在约 35 个 fly.io 区域、单机 512MB 内存、承受上千并发探测的探针舰队读完你将对跨语言架构边界的划分、探测时序数据的采集原理以及静态二进制自托管交付有完整的可落地方案认知。一、决策背景探测服务是什么运行在哪里在展开语言选型之前必须先理解探测层在 OpenStatus 架构中的角色与运行约束。根据 ADR-0004 的描述探测服务apps/checker以**舰队fleet**形态运行部署在约 35 个 fly.io 区域每台机器是512MB 内存 / 2 共享 CPU的小型 VM单机需要处理约 1000 个并发请求该数值与 apps/checker/fly.toml 中http_service.concurrency的hard_limit 1000、soft_limit 500配置互相印证同时它以 Docker 镜像的形式交付给客户在客户自有的基础设施上运行承担私有位置private location监控对应代码在apps/private-location。而 OpenStatus 的其余部分——Dashboard、API Server、共享包——全部是 TypeScript。于是 ADR-0004 要回答的核心问题是探测这一层应该用什么语言写这里的关键洞察在于一次探测任务会**扇出fan-out**为大量并发、且绝大部分时间处于空闲等待的网络探针。这种 I/O 密集、等待密集的工作负载对运行时的并发开销、内存占用、冷启动速度都提出了特定要求。二、决策驱动力五个硬性约束ADR-0004 明确了五项决策驱动因素它们共同构成了选型的天平并发要便宜单个检查会扇出为大量并发的、大多处于空闲状态的网络探针运行时必须让这种并发变得廉价。小 VM 上的效率是经常性成本舰队运行在约 35 个区域的小型 VM 上低内存占用和快速冷启动至关重要。需要底层网络控制能力逐阶段请求计时、原始 ICMP、自定义 dialer——而不是仅仅一个fetch。交付物必须小巧可移植探针 Agent 要能作为独立的、自包含的产物让客户在自有基础设施上运行。与系统其余部分的契约是数据而非共享代码探测层与业务层之间通过显式数据契约通信。这五条驱动因素直接决定了候选方案的评价标准并发模型效率、运行时体积、底层网络 API 可达性、交付形态、以及跨语言协作成本。三、候选方案与对比ADR-0004 对比了三个选项Go、TypeScript / Node与其余技术栈保持一致、Rust。维度GoTypeScript / NodeRust并发模型goroutine扇出廉价且简单事件循环 异步着色VM 更重与 Go 同级的效率与控制力网络底层能力net/net/http标准库直接暴露 httptrace、原始 socket底层网络计时和非 HTTP 协议探测别扭且部分不可用同 Go交付形态静态链接二进制小巧可移植需要运行时冷启动慢静态二进制但迭代慢、学习曲线陡团队学习成本中需引入第二门语言低全栈统一 TS高团队其余后端技能是 TS主要代价仓库变为多语言每 VM 运行时更重、跨大型舰队冷启动更慢对 I/O 密集型工作负载相比 Go 的并发收益边际ADR 对 Rust 的评价尤为值得注意Rust 虽然在效率和网络控制上能与 Go 媲美但对于一个团队其余后端技能均为 TypeScript 的仓库而言迭代速度更慢、学习曲线更陡且对于这个 I/O 密集型的探测负载Rust 相对 Go 的并发优势是**边际marginal**的——这并非贬低 Rust而是说明选型必须结合团队与工作负载特征。TypeScript / Node 的优势在于全仓库单一语言、共享类型断言、区域代码、schema但代价是每个 VM 运行时更重、跨大型舰队冷启动更慢且低层网络计时与非 HTTP 协议探测在 Node 生态中部分不可用——这正是探测产品的地基能力。四、决策结果Go 被限定在探测边界ADR-0004 的结论是探测层apps/checker与apps/private-location用 Go 编写OpenStatus 其余部分保持 TypeScript。理由有三且都能在仓库源码中找到直接对应4.1 goroutine让探针扇出变得廉价Go 的 goroutine 让大规模探测扇出无需异步着色async-coloring模型或线程池模型。当一次检查需要同时向多个目标发起连接、且每个连接大部分时间在等待网络时goroutine 的微栈调度使数千个并发探针的开销可以忽略。4.2 标准库httptrace 直接支撑产品级分阶段计时ADR 明确写道Go 的net/net/http标准库暴露了产品所依赖的底层钩子——httptrace提供了 OpenStatus 所报告的 DNS / connect / TLS / TTFB 分阶段计时。这在 apps/checker/checker/http.go 中有完整实现。Http函数构造了一个httptrace.ClientTrace通过DNSStart、DNSDone、ConnectStart、ConnectDone、TLSHandshakeStart、TLSHandshakeDone、GotConn、GotFirstResponseByte等回调把每一次 HTTP 探测拆解为毫秒级的十段时序type Timing struct { DnsStart int64 json:dnsStart DnsDone int64 json:dnsDone ConnectStart int64 json:connectStart ConnectDone int64 json:connectDone TlsHandshakeStart int64 json:tlsHandshakeStart TlsHandshakeDone int64 json:tlsHandshakeDone FirstByteStart int64 json:firstByteStart FirstByteDone int64 json:firstByteDone TransferStart int64 json:transferStart TransferDone int64 json:transferDone }随后通过req req.WithContext(httptrace.WithClientTrace(req.Context(), trace))将追踪器注入请求配合client.Do(req)前后记录总延迟。这些时序字段最终以 JSON 形态随响应输出——这正是探测结果数据契约的一部分详见下文第六节。此外http.go 还演示了一个值得借鉴的容错设计当请求失败时不直接返回 Go error而是构造一个带Error字段的Response——确保超时、连接拒绝、DNS 失败等所有故障形态都能被正常摄入并展示在 Dashboard 中而不是在探针内部被吞掉。4.3 原始 socket非 HTTP 协议探测的地基ADR 提到raw sockets cover the non-HTTP probe types。这在 apps/checker/checker/icmp.go 中得到最充分的体现这也是全仓库最底层的一段代码使用golang.org/x/net/icmp与ipv4/ipv6包直接构造 ICMP Echo 报文Echo ID 以进程 PID 为种子icmp.go因为原始 socket 会收到发往主机的所有 ICMP 包并发探测必须靠 echo id 区分而用 PID 做种子可避免重启后立即复用仍在途中的包 ID每次探测发送3 个包、间隔 100msicmpPacketCount/icmpPacketInterval常量icmp.go优先使用无特权数据报 socket失败时回退到原始 socketlistenICMPicmp.go兼容容器等缺乏ping_group_range权限的环境应答匹配逻辑sendEcho处理了两个精妙的细节原始 socket 上按 IP Echo ID Seq 匹配数据报 socket 上因内核会改写 Echo ID 而只能按 Seq 匹配对DstUnreach/TimeExceeded错误则通过provokedByProbe解析报文中引用的原始数据报quoted datagram来确认是否由本探针引发避免把别的流量的destination unreachable误判为自己的失败。最终输出的ICMPResult包含平均/最小/最大延迟、发包数、收包数以及每个包的 RTT 数组丢包以-1标记。非 HTTP 探测不止 ICMP还包括TCPapps/checker/checker/tcp.go 用net.DialTimeout实现端口连通性探测并对超时、连接拒绝、一般拨号错误做差异化错误消息DNSapps/checker/checker/dns.go 通过net.DefaultResolver的 context 感知方法LookupIP、LookupCNAME、LookupMX、LookupNS、LookupTXT抓取 A / AAAA / CNAME / MX / NS / TXT 全套记录注释中特别说明了为何不用包级net.Lookup*帮助函数——它们不接受 context卡住的 resolver 会让探针超过超时并阻塞 monitor 的下一轮运行同时 MX 和 TXT 容忍查询错误但若 deadline 到期则视为整体失败dns.gogRPCapps/checker/checker/grpc.go 定义了tls/plaintext/tls_insecure三种 TLS 模式并调用grpc_health_v1健康检查服务输出SERVING/NOT_SERVING/SERVICE_UNKNOWN/UNKNOWN等 ServingStatus。这些实现共同验证了 ADR 的核心判断探测产品的地基能力逐阶段计时、原始协议访问、自定义 dialer无法靠一个fetch完成Go 标准库恰好原生提供。4.4 静态二进制既是多区域镜像也是自托管产物ADR 指出静态链接的 Go 二进制以极小的多区域镜像部署同时作为自托管产物无需安装任何运行时。apps/checker/private-location.Dockerfile 完整展示了这一思路FROM --platform$BUILDPLATFORM golang:1.25-alpine as builder WORKDIR /go/src/app RUN apk add --no-cache tzdata ENV TZUTC ENV CGO_ENABLED0 COPY go.* . RUN go mod download COPY . . RUN GOOS${TARGETOS} GOARCH${TARGETARCH} go build -trimpath -ldflags -s -w -o private ./cmd/private FROM scratch WORKDIR /opt/bin COPY --frombuilder /etc/ssl/certs/ca-certificates.crt /etc/ssl/certs/ COPY --frombuilder /usr/share/zoneinfo /usr/share/zoneinfo COPY --frombuilder /go/src/app/private /opt/bin/private ENV TZUTC ENV USER1000 ENV GIN_MODErelease CMD [ /opt/bin/private ]几个关键点CGO_ENABLED0保证纯静态编译-trimpath -ldflags -s -w去除调试信息、缩小体积最终镜像以FROM scratch为基础只额外携带 CA 证书与时区数据——一个没有 shell、没有包管理器、没有任何运行时的自包含产物这正是客户在自己的基础设施上运行私有位置监控所需的交付形态。五、多语言代价被接受且被刻意限定边界ADR-0004 明确承认了多语言polyglot的代价并刻意将其限定在探测边界内产品与业务逻辑保留在 TypeScriptpackages/services遵循 ADR-0001 的业务逻辑位于服务层原则两个世界只通过显式数据契约通信——探测结果写入 Tinybird、任务通过 HTTP / Cloud Tasks / ConnectRPCpackages/proto投递——绝不共享进程内代码坏处是仓库成为多语言仓库探测层的贡献者需要同时掌握 Go 与 TypeScriptCI 需要携带第二套工具链没有跨边界的类型或逻辑共享断言求值存在两份实现——packages/assertionsTS与apps/checker/pkg/assertionsGo——需要手工保持同步中性项跨边界契约Tinybird schema、protobuf是显式且带版本的而非隐式约定。apps/checker/request/request.go是理解数据契约的窗口其中HttpCheckerRequest、TCPCheckerRequest、ICMPCheckerRequest、GRPCCheckerRequest、DNSCheckerRequest等结构体以 JSON tag 定义了探针任务的入参形态URL、Method、Headers、Timeout、Retry、DegradedAfter、OtelConfig……而探测结果则被序列化后写入 Tinybird 时序库。这套 JSON 契约就是 Go 世界与 TypeScript 世界之间的数据边界。Confirmation一节给出了边界维护的具体纪律新增探测 / 边缘 Agent 代码用 Go新增产品逻辑用 TypeScript写入packages/services任何跨边界重复的逻辑断言、区域代码都要在评审中显式指出确保两份拷贝同步演进。六、跨边界契约与 ADR-0005 的呼应ADR-0004 并非孤立决策它与另外两份 ADR 形成闭环docs/adr/0005-turso-for-app-data-tinybird-for-time-series.md探测舰队是 Tinybird 的主要写入方。每次检查的结果含逐阶段时序作为高吞吐、追加型时间序列写入 TinybirdDashboard 与 API 通过packages/tinybird读取按时间窗口聚合的指标1h / 1d / 7d / 45d 的 p95 延迟与可用性按区域分组。两套存储仅靠 ID 关联Tinybird 行携带monitorId/workspaceId无跨存储事务、无跨边界 JOIN。这种设计也意味着探测写入的洪峰不会拖垮应用数据库。docs/adr/0001-business-logic-lives-in-the-services-layer.md业务逻辑统一收敛在框架无关的packages/services层tRPC、Hono、MCP、后台任务共用而 Go 探测层完全不参与该层——两世界通过任务投递HTTP / Cloud Tasks / ConnectRPC契约定义于packages/proto与结果落库Tinybird交互。也就是说OpenStatus 的最终形态是Go 管探测、TS 管业务、Tinybird 管时序、Turso 管应用数据每一层只做自己擅长的事。七、运行与部署从本地到全球舰队结合 apps/checker/README.md 与 apps/checker/fly.toml探测层的运行与部署方式如下本地运行需设置环境变量go run cmd/main.goset CRON_SECRET YOLO set CLOUD_PROVIDER local set TINYBIRD_TOKEN random构建go build -o checker *.goDocker 运行docker build -t checker . docker run -p 8080:8080 checker部署到 fly.io 全部区域对应 ADR 所述的约 35 区域舰队fly scale count 35 --region ams,arn,atl,bog,bom,bos,cdg,den,dfw,ewr,eze,fra,gdl,gig,gru,hkg,iad,jnb,lax,lhr,mad,mia,nrt,ord,otp,phx,qro,scl,sjc,sea,sin,syd,waw,yul,yyzapps/checker/fly.toml 则定义了单机资源与健康检查形态cpu_kind shared、cpus 2、memory_mb 512http_service.checks以 15 秒间隔、5 秒超时探测/health端点并发限制为soft_limit 500、hard_limit 1000。这套配置与 ADR 中512MB / 2 共享 CPU / 约 1000 并发的描述完全吻合也解释了为何低内存 快冷启动会成为决策驱动力——在 35 个区域各跑这样的实例运行时的每一点效率开销都会被放大成经常性成本。八、总结什么时候该为边界选择另一门语言ADR-0004 提供的是一个可复用的架构决策范本而非单纯的Go vs Rust vs Node口水战。它的方法论可以拆解为先界定边界的运行约束并发形态、资源上限、交付形态、团队技能——这些才是选型的输入用标准库能力做硬性筛选当产品的地基能力这里是逐阶段网络计时与原始协议依赖运行时底层 API 时语言的标准库直接决定可行性为选型代价设定显式边界多语言不是原罪无界的多语言才是Go 被限定在探测边界业务逻辑仍归packages/services跨边界只走显式数据契约Tinybird 结果、protobuf 任务从而把协作成本降到可控用部署形态反向验证FROM scratch的静态二进制与 35 区域小 VM 舰队是效率 可移植性这两个抽象诉求的具体落地。对任何需要在大规模边缘探测、监控探针或类似 I/O 密集分布式 Agent 场景中做技术选型的团队这份 ADR 及其在仓库中的源码印证apps/checker/checker/http.go、apps/checker/checker/icmp.go、apps/checker/checker/dns.go、apps/checker/private-location.Dockerfile都是可以直接对照参考的完整案例。【免费下载链接】openstatus Status page with uptime monitoring API monitoring as code 项目地址: https://gitcode.com/GitHub_Trending/op/openstatus创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考