Loki — Kubernetes 日志聚合服务器
本示例将一个小型的真实技术栈——一个 Grafana Loki 日志聚合服务器——从一个由 Developer 编写的 Aggregate 编译到 Kubernetes,底层使用单二进制形态的官方 Grafana Loki Helm chart。
Loki 是一个日志后端:它通过 HTTP 推送 API 接收日志流,按标签而非全文内容为其建立索引,将其存储在 chunk 对象存储中,并通过同一 HTTP API 响应日志查询和范围请求。在单二进制形态下,Loki 的每个子系统——distributor、ingester、querier、compactor——都运行在由本地 chunk 存储支撑的同一进程中,因此整个服务器是一个有状态工作负载。日志采集器将日志流推送到 Loki;仪表盘服务器则通过查询 API 读回这些日志。
文件
| 文件 | 角色 |
|---|---|
aggregate.yaml | Developer 意图:单个 logging 组件(core/observability/loki),日志保留七天。 |
manifest.yaml | 将组件类型映射到 Loki 的源 Recipe(loki)。 |
release.yaml | Kubernetes 目标的 Operator 记录:服务器计算资源和 chunk 存储卷大小。 |
演示内容
- 单一编写入口。 单个 Aggregate 是 Loki 是什么 的唯一事实来源;Manifest 说明如何实现它。
- 单二进制日志后端。 源 Recipe 将 Loki 渲染为一个带数据卷的
StatefulSet、存放其配置的ConfigMap、暴露 HTTP 推送与查询端点的Service,以及一个ServiceAccount——一个自包含的单一工作负载,不启用分布式扩展路径和捆绑的辅助服务。 - 由开发者设置的保留期。 开发者设置的
retention_period传入进程内的 compactor,后者会在存储的日志流超过该期限后将其删除。 - 导出的摄取契约。 该组件通过
uses拓扑导出其集群内服务主机和端口,日志采集器据此连接并推送日志流。 - 可复现的镜像。 该 Recipe 将 Loki 服务器镜像和配置重载 sidecar 镜像固定到可解析的标签,使渲染出的工作负载引用固定的版本。
生成示例
你可以用下面的命令构建这个示例,也可以让你的 AI 助手替你构建。
将示例写入一个以其命名的新文件夹:
aggrega scaffold --example loki-logging然后它会打印接下来要运行的命令。第一条命令进入新文件夹:
cd loki-logging构建
此工作区不带 .aggrega-config.yaml,因此标准库实体从 hub 注册表 hub.aggrega.ai 解析,无需目录标志:
aggrega pull --release release.yamlaggrega build --release release.yaml渲染产物位于 dist/ 下。构建在执行 aggrega pull 时通过 OCI 引用解析上游 chart,并将其固定在锁文件中。
借助 AI 助手
已配置 Aggrega 工具的 AI 助手也能完成同样的操作:把下面这条提示粘贴给它。
只使用 Aggrega 工具,不要自己创建任何文件夹。如果工作区文件夹中还没有 `loki-logging` 文件夹,调用一次 `scaffold` 工具,将 `example` 设为 `loki-logging`,不设 `dir`:它会把示例写入一个新的 `loki-logging` 文件夹。然后调用 `build` 工具,将 `workspace_root` 设为 `loki-logging`、`release` 设为 `release.yaml`、`auto_pull` 设为 true、`write` 设为 true。告诉我构建写入了哪些文件;它们位于 `loki-logging/dist/` 下。渲染结果
构建将 Loki 服务器输出为一组自包含的 Kubernetes 对象:
- 一个
StatefulSet——单二进制 Loki 进程,其 chunk 存储位于持久卷上, ConfigMap——Loki 配置和运行时配置,Service——在端口 3100 上暴露 HTTP 推送与查询端点,- 一个供该工作负载使用的
ServiceAccount,及其访问绑定。
不会渲染分布式的读/写/后端工作负载、对象存储子 chart、缓存或 operator——渲染结果是单个 Loki 工作负载。Loki 服务器和配置重载 sidecar 镜像固定到各自的发布标签,因此该工作负载引用的是固定的镜像。