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

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.yamlDeveloper 意图:单个 logging 组件(core/observability/loki),日志保留七天。
manifest.yaml将组件类型映射到 Loki 的源 Recipe(loki)。
release.yamlKubernetes 目标的 Operator 记录:服务器计算资源和 chunk 存储卷大小。

演示内容

  • 单一编写入口。 单个 Aggregate 是 Loki 是什么 的唯一事实来源;Manifest 说明如何实现它。
  • 单二进制日志后端。 源 Recipe 将 Loki 渲染为一个带数据卷的 StatefulSet、存放其配置的 ConfigMap、暴露 HTTP 推送与查询端点的 Service,以及一个 ServiceAccount——一个自包含的单一工作负载,不启用分布式扩展路径和捆绑的辅助服务。
  • 由开发者设置的保留期。 开发者设置的 retention_period 传入进程内的 compactor,后者会在存储的日志流超过该期限后将其删除。
  • 导出的摄取契约。 该组件通过 uses 拓扑导出其集群内服务主机和端口,日志采集器据此连接并推送日志流。
  • 可复现的镜像。 该 Recipe 将 Loki 服务器镜像和配置重载 sidecar 镜像固定到可解析的标签,使渲染出的工作负载引用固定的版本。

生成示例

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

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

Terminal window
aggrega scaffold --example loki-logging

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

Terminal window
cd loki-logging

构建

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

Terminal window
aggrega pull --release release.yaml
aggrega 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 镜像固定到各自的发布标签,因此该工作负载引用的是固定的镜像。