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

Jaeger — Kubernetes 单节点链路追踪后端

本示例编译一个小型的真实技术栈——单节点形态的 Jaeger 分布式追踪 后端——从一个由开发者编写的 Aggregate 编译到 Kubernetes,直接基于 Jaeger 官方镜像合成,不依赖 上游 chart。

Jaeger 是一个追踪后端:它通过 OpenTelemetry 协议接收 span, 将其存储在本地嵌入式键值存储中,并通过其查询 UI 响应追踪查找和 搜索查询。在单节点形态下,OTLP 接收器、 存储写入器和查询服务都运行在同一个进程中,并由 本地磁盘存储支撑,因此整个服务器是一个有状态工作负载。 经过插桩的应用将 span 推送到 Jaeger 的 OTLP 接收器;运维人员 则通过 UI 读取它们。

文件

文件角色
aggregate.yaml开发者意图:单个 tracing 组件(core/observability/jaeger)。
manifest.yaml将该组件类型映射到 Jaeger 合成 Recipe(jaeger)。
release.yamlKubernetes 目标的运维记录:服务器计算资源和追踪存储卷大小。

演示内容

  • 单一编写界面。 单个 Aggregate 是 Jaeger 是什么的 唯一事实来源;Manifest 则说明如何实现它。
  • 单节点追踪后端。 合成 Recipe 将 Jaeger 渲染为一个 带数据卷的 StatefulSet、一个承载 Jaeger v2 配置的 ConfigMap,以及两个 Service 对象——一个暴露接收器和 UI 的 ClusterIP,以及一个作为 StatefulSet 管理服务的 headless Service。
  • 以文件形式交付配置。 Jaeger v2 是一个通过 YAML 文件配置的 OpenTelemetry Collector 发行版。Recipe 将该配置输出为 ConfigMap,并挂载到容器的 /etc/jaeger, 容器通过 --config /etc/jaeger/config.yaml 读取它。
  • 持久化追踪数据。 嵌入式键值存储写入挂载在 /badger 的 持久卷,因此追踪数据在重启后得以保留。
  • 导出的数据摄取契约。 该组件通过 uses 拓扑导出其 OTLP gRPC 接收器的主机和端口,因此追踪数据生产者可以连接到它 并将 span 推送到那里。
  • 可复现的镜像。 Recipe 将 Jaeger 服务器镜像固定到一个可解析的标签,使渲染出的工作负载引用固定的版本。

生成示例

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

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

Terminal window
aggrega scaffold --example jaeger-tracing

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

Terminal window
cd jaeger-tracing

构建

此工作区不带 .aggrega-config.yaml,因此标准库实体从 hub 注册表 hub.aggrega.ai 解析,无需目录标志:

Terminal window
aggrega pull --release release.yaml
aggrega build --release release.yaml

渲染产物输出到 dist/ 下。Kubernetes 目标离线渲染普通 manifest——无需拉取 chart。

借助 AI 助手

已配置 Aggrega 工具的 AI 助手也能完成同样的操作:把下面这条提示粘贴给它。

只使用 Aggrega 工具,不要自己创建任何文件夹。如果工作区文件夹中还没有 `jaeger-tracing` 文件夹,调用一次 `scaffold` 工具,将 `example` 设为 `jaeger-tracing`,不设 `dir`:它会把示例写入一个新的 `jaeger-tracing` 文件夹。然后调用 `build` 工具,将 `workspace_root` 设为 `jaeger-tracing`、`release` 设为 `release.yaml`、`auto_pull` 设为 true、`write` 设为 true。告诉我构建写入了哪些文件;它们位于 `jaeger-tracing/dist/` 下。

渲染结果

构建将 Jaeger 服务器输出为四个 Kubernetes 对象:

  • 一个 StatefulSet——单节点 Jaeger 进程,其嵌入式追踪 存储位于挂载在 /badger 的持久卷上,配置挂载在 /etc/jaeger,
  • 一个 ConfigMap——Jaeger v2 配置(OTLP 接收器、batch 处理器,以及写入 /badger/key 和 /badger/data 的嵌入式键值存储),
  • 一个 ClusterIP Service——在 4317 端口暴露 OTLP gRPC 接收器,在 4318 端口暴露 OTLP HTTP 接收器,在 16686 端口暴露查询 UI,
  • 一个 headless Service——StatefulSet 为获得稳定的逐副本标识 所需的管理服务。

Jaeger 镜像固定到其发布标签,因此工作负载引用的是固定的镜像标签。