跳转到内容
AggregaAggrega
选择语言: 简体中文
本页面由机器翻译。阅读英文原文。

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.yamlDeveloper 意图:一个 tracing 组件(core/observability/tempo),追踪数据保留七天。
manifest.yaml将组件类型映射到合成的 Tempo Recipe(tempo)。
release.yamlKubernetes 目标的运维记录:服务器计算资源和追踪存储卷大小。

演示内容

  • 单一编写入口。 单个 Aggregate 是 Tempo 是什么的唯一事实来源; Manifest 则说明如何实现它。
  • 单二进制追踪后端。 合成的 Recipe 将 Tempo 渲染为一个 带有每副本数据卷的 StatefulSet、一个承载 Tempo 配置的 ConfigMap,以及暴露追踪 接收器和 HTTP 查询 API 的 ClusterIP 与 Headless Service——一个自包含的单一 workload。
  • 由开发者设置的保留期。 开发者设置的 retention_period 传递给 进程内的 compactor,后者会在已存储的追踪块超过该期限后将其删除。
  • 导出的数据摄取契约。 该组件通过 uses 拓扑导出其 OTLP gRPC 接收器的主机和端口,因此追踪数据生产者可以连接到它 并将 span 推送到那里。
  • 可复现的镜像。 Recipe 根据 infra.engine_version 固定 Tempo 服务器镜像标签,使渲染出的 workload 引用一个固定的版本。

生成示例

你可以用下面的命令构建这个示例,也可以让你的 AI 助手替你构建。

将示例写入一个以其命名的新文件夹:

Terminal window
aggrega scaffold --example tempo-tracing

然后它会打印接下来要运行的命令。第一条命令进入新文件夹:

Terminal window
cd tempo-tracing

构建

此工作区不带 .aggrega-config.yaml,因此标准库实体从 hub 注册表 hub.aggrega.ai 解析,无需目录标志;--auto-pull 会在构建期间写入新克隆所缺少的锁文件:

Terminal window
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 引用的是一个固定的镜像标签。