Uptrace
Uptrace — 开源 APM，OpenTelemetry 追踪和 ClickHouse。
监控中等
技术栈组成
PlatformUptrace
StorageClickHouse
为什么
统一 trace + 指标，用 SQL 查询 trace，低成本自托管。OpenTelemetry 2024 年成为 CNCF 检测标准，70% 以上云原生组织使用。
Sentry 和 Datadog 以各 3 万以上付费客户领先错误追踪。
何时使用
用于基于 OTel 的自托管 APM。避免偏好云托管。
如何做
1. 通过 Docker 部署 Uptrace
2. 配置 OTel 导出到 Uptrace
3. 在 UI 查看 trace
4. 设置告警
示例
const exporter = new OTLPSpanExporter({ url: 'http://localhost:14318' });
// Uptrace — 使用示例
import { Uptrace } from "mon2-uptrace";
const result = await uptrace({ input: "data" });
console.log(result);
常见问题
- ⚠ClickHouse schema 迁移 — 遵循升级指南
- ⚠高基数 span 名 — 用采样
- ⚠环境间配置漂移 — 使用基础设施即代码（Terraform/Pulumi）保持 dev/staging/prod 一致
最佳实践
- ✓用 Uptrace 查询语言进行自定义分析
- ✓监控 ClickHouse 磁盘使用
- ✓设置健康检查和优雅关闭 — 处理 SIGTERM 以在退出前排空进行中的请求
常见问题解答
什么是Uptrace？适合做什么项目？
Uptrace — 开源 APM，OpenTelemetry 追踪和 ClickHouse。 它通过分层组合提供端到端类型安全与开箱即用的部署体验，适合从 MVP 到生产 SaaS 的快速迭代。
如何用Uptrace在 10 分钟内跑通一个 demo？
两步起步：① 通过 Docker 部署 Uptrace；② 配置 OTel 导出到 Uptrace。先跑通本地 dev server，再接一个真实数据源验证端到端链路。
Uptrace 最常见的坑是什么？怎么避免？
最高频的坑是：ClickHouse schema 迁移 — 遵循升级指南。避免方法：在 PR 模板里加入对应 checklist，CI 中跑类型检查 + lint + 单测，三重把关再合并。
Uptrace 的最佳实践有哪些？
Uptrace 的最佳实践包括：用 Uptrace 查询语言进行自定义分析；监控 ClickHouse 磁盘使用；设置健康检查和优雅关闭 — 处理 SIGTERM 以在退出前排空进行中的请求。其中首条「用 Uptrace 查询语言进行自定义分析」应在项目初始化时就落地，避免后期返工。
什么情况下不该选Uptrace？
三种情况另选他栈：① 团队对该栈核心框架零经验且工期紧张（学习曲线风险）；② 项目是纯内容/营销站（选 Astro 更轻）；③ 需要极高吞吐（>1 万 RPS）或强一致微服务（选 Go/Rust）。Uptrace 的强项是中高复杂度全栈与 API，别在简单静态页上过度工程。