本页面由机器翻译。阅读英文原文。
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.yaml | Kubernetes 目标的运维记录:服务器计算资源和追踪存储卷大小。 |
演示内容
- 单一编写界面。 单个 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 助手替你构建。
将示例写入一个以其命名的新文件夹:
aggrega scaffold --example jaeger-tracing然后它会打印接下来要运行的命令。第一条命令进入新文件夹:
cd jaeger-tracing构建
此工作区不带 .aggrega-config.yaml,因此标准库实体从 hub 注册表 hub.aggrega.ai 解析,无需目录标志:
aggrega pull --release release.yamlaggrega 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的嵌入式键值存储), - 一个
ClusterIPService——在 4317 端口暴露 OTLP gRPC 接收器,在 4318 端口暴露 OTLP HTTP 接收器,在 16686 端口暴露查询 UI, - 一个 headless
Service——StatefulSet 为获得稳定的逐副本标识 所需的管理服务。
Jaeger 镜像固定到其发布标签,因此工作负载引用的是固定的镜像标签。