Tempo — Kubernetes 分布式追踪服务器
本示例编译一个小型的真实技术栈——一个 Grafana Tempo 分布式追踪
服务器——从一个由 Developer 编写的 Aggregate 出发,基于官方 grafana/tempo 镜像,通过 Workload
合成以单二进制形态编译到 Kubernetes。
Tempo 是一个追踪后端:它通过 OpenTelemetry 协议(以及 其他追踪传输格式)接收 span,将其存储在追踪对象存储中,并通过其 HTTP API 响应 追踪查找和搜索查询。在单二进制形态下, Tempo 的每个子系统——distributor、ingester、querier、compactor——都运行在 由本地追踪存储支持的同一个进程中,因此整个服务器是一个有状态的 workload。经过插桩的应用将 span 推送到 Tempo 的 OTLP 接收器; 仪表盘服务器则通过查询 API 将其读回。
文件
| 文件 | 角色 |
|---|---|
aggregate.yaml | Developer 意图:一个 tracing 组件(core/observability/tempo),追踪数据保留七天。 |
manifest.yaml | 将组件类型映射到合成的 Tempo Recipe(tempo)。 |
release.yaml | Kubernetes 目标的运维记录:服务器计算资源和追踪存储卷大小。 |
演示内容
- 单一编写入口。 单个 Aggregate 是 Tempo 是什么的唯一事实来源; Manifest 则说明如何实现它。
- 单二进制追踪后端。 合成的 Recipe 将 Tempo 渲染为一个
带有每副本数据卷的
StatefulSet、一个承载 Tempo 配置的ConfigMap,以及暴露追踪 接收器和 HTTP 查询 API 的ClusterIP与HeadlessService——一个自包含的单一 workload。 - 由开发者设置的保留期。 开发者设置的
retention_period传递给 进程内的 compactor,后者会在已存储的追踪块超过该期限后将其删除。 - 导出的数据摄取契约。 该组件通过
uses拓扑导出其 OTLP gRPC 接收器的主机和端口,因此追踪数据生产者可以连接到它 并将 span 推送到那里。 - 可复现的镜像。 Recipe 根据
infra.engine_version固定 Tempo 服务器镜像标签,使渲染出的 workload 引用一个固定的版本。
生成示例
你可以用下面的命令构建这个示例,也可以让你的 AI 助手替你构建。
将示例写入一个以其命名的新文件夹:
aggrega scaffold --example tempo-tracing然后它会打印接下来要运行的命令。第一条命令进入新文件夹:
cd tempo-tracing构建
此工作区不带 .aggrega-config.yaml,因此标准库实体从 hub 注册表 hub.aggrega.ai 解析,无需目录标志;--auto-pull 会在构建期间写入新克隆所缺少的锁文件:
aggrega build --release release.yaml --auto-pull渲染产物位于 dist/ 下。合成的目标无需获取外部
chart——Recipe 直接将官方镜像渲染为 StatefulSet、
Service 和数据卷。
借助 AI 助手
已配置 Aggrega 工具的 AI 助手也能完成同样的操作:把下面这条提示粘贴给它。
仅使用 Aggrega 工具,不要自行创建任何文件夹。如果工作区文件夹中还没有 `tempo-tracing` 文件夹,请调用一次 `scaffold` 工具,将 `example` 设为 `tempo-tracing`,且不设 `dir`:它会把示例写入新的 `tempo-tracing` 文件夹。然后调用 `build` 工具,将 `workspace_root` 设为 `tempo-tracing`,`release` 设为 `release.yaml`,`auto_pull` 设为 true,`write` 设为 true。告诉我构建写入了哪些文件;它们位于 `tempo-tracing/dist/` 下。渲染结果
构建将 Tempo 服务器输出为四个 Kubernetes 对象:
- 一个
StatefulSet——单二进制 Tempo 进程,其追踪存储位于 每副本的持久卷上, - 一个
ConfigMap——Tempo 配置, - 一个
ClusterIP Service——在 4317 端口暴露 OTLP gRPC 接收器,在 4318 端口暴露 OTLP HTTP 接收器,在 3200 端口暴露 HTTP 查询 API, - 一个
Headless Service——StatefulSet 的稳定网络标识,暴露 相同的端口。
Tempo 镜像标签根据 infra.engine_version 固定,因此 workload 引用的是一个固定的镜像标签。