Loki 如何访问 /ui 部署管理界面并检查集群组件状态?

原创2026-09-11 21:48:571,417 阅读
文章标签:日志分析可观测性后端云原生分布式数据库存储

Loki 如何访问 /ui 部署管理界面并检查集群组件状态?

Loki 提供了一个部署管理界面(Loki Deployment UI),用于以 Web 页面的形式查看和管理 Loki 部署中各组件的运行状态。本文的目标是:在一个已运行的 Loki 实例上(microservices mode 或 single binary mode 均可)打开 /ui 界面,并通过 Nodes 和 Rings 页面检查集群组件是否健康。

先明确三件事(来自 Loki UI 文档 的 Considerations 部分):

  1. Loki Deployment UI 是实验性功能,会持续变化;
  2. UI 没有认证和授权——任何能访问到 UI 的人都可以发起删除请求、修改日志级别等,注意限制网络暴露面;
  3. 该 UI 不打算替代 Loki 的 meta-monitoring(元监控)。

确认 UI 是否已启用

UI 服务已内置在每个 Loki 组件中,是否可访问取决于部署方式:

  • Docker 容器运行 Loki 时:UI 服务默认启用,无需额外配置。
  • Helm 部署时:默认未启用。在 Helm 的 values 文件 values.yaml 的 loki 段中打开 UI 发现能力,需要修改的内容见 Helm 参考文档(loki.ui 默认值为 {"enabled":false,"gateway":{"enabled":true}},启用后 UI 位于 loki-gateway 的 /ui/ 路径):
loki:
  ui:
    enabled: true

另外,Loki 配置文件本身也有对应的开关。根据 配置参考,ui.enabled 默认值为 false,对应 CLI 参数 -ui.enabled:

ui:
  # Enable the experimental Loki UI.
  # CLI flag: -ui.enabled
  [enabled: <boolean> | default = false]

注意两处默认值表述不一致:Loki UI 文档说 Docker 运行时 UI 服务默认启用;而配置参考中 ui.enabled 默认 false。如果你的实例访问 /ui 失败,最直接的排查手段就是显式加上面的 ui.enabled: true 配置(Helm 用户改 values.yaml),不必纠结于哪处默认值生效。

访问 /ui 界面

UI 的访问地址为:

http://<LOKI_HOST>:<LOKI_PORT>/ui

其中 <LOKI_HOST> 是 Loki 服务器的主机名或 IP 地址,<LOKI_PORT> 是 Loki 运行端口;Loki 默认运行在 3100 端口。

在 Kubernetes 中部署时,UI 通过 loki-gateway service 暴露,文档给出了两种访问方式:port-forward 或把 service 暴露为 LoadBalancer。以 port-forward 为例(<NAMESPACE> 替换为你部署 Loki 的命名空间):

kubectl --namespace <NAMESPACE> port-forward svc/loki-gateway 3100

然后浏览器打开 http://localhost:3100/ui 即可。

一个限制要提前知道:/ui 这个路径目前不能改成其他路径,文档说明这需要额外的代码贡献。

用 Nodes 页面检查各组件状态

进入 UI 后,Nodes 页面列出部署中每个 Loki 组件的状态。根据部署模式,每个组件会被视作一个 node 或一个 service。节点表格包含以下列:

  • Node Name:组件名,可能包含 pod 哈希或 zone 信息等唯一标识;
  • Target:组件类型,如 distributor、ingester、querier 等;
  • Version:组件版本,基于容器镜像 tag;
  • Build Date:容器镜像的构建时间;
  • Status:组件内各服务的当前状态,组件包含哪些服务取决于组件类型;
  • Ready:组件就绪状态,基于内部服务的状态判断。服务都应为 ready,组件才被认为是 ready,否则为 not ready——not ready 通常会显示红色图标和错误信息;
  • Actions:跳转到该节点的详情页。

点击 Actions 进入 Node 页面后,可以看到更详细的排查信息:

  • 页面上方是 Nodes 表格中该节点的信息,并附有 Version、Created、Edition、Architecture、OS 等扩展字段;
  • Log Level:可以修改该组件的日志级别;
  • Profiling Tools:查看该组件的 profile 数据(新标签页展示或下载为文件);
  • 三个标签页:Configuration(查看该组件的 Loki 配置,确认某个配置是否已应用到组件)、Analytic(组件的汇总指标,例如 ingester 会显示 stream count、flushed chunk rate 等)、Raw Metrics(组件的原始 metrics)。

判断组件健康的最直接依据就是 Ready 列:出现红色图标和错误信息时,用 Actions 进入节点页,先看 Configuration 确认配置,再看 Analytic / Raw Metrics 定位。

用 Rings 页面检查环成员状态

Rings 页面展示 ring 成员的状态。一个 Loki 部署中最多有 5 个 ring,每个 ring 负责特定任务;并非所有 ring 都会出现在你的部署里——例如 Index Gateway 和 Query Scheduler 都需要显式配置后才启用,因此你看到的 ring 数量取决于部署配置。

Ring 表格的列包括:

  • ID:ring 成员的唯一标识;
  • Status:成员当前状态,如 ACTIVE、UNHEALTHY、LEAVING 等;
  • Address:ring 成员的 IP 地址;
  • Ownership:该成员持有 token 的百分比;
  • Zone:成员所在的 zone;
  • Last Heartbeat:成员最近一次发送心跳的时间。

检查时关注 Status 列:成员应处于 ACTIVE;出现 UNHEALTHY 或长时间停留在 LEAVING,结合 Last Heartbeat 时间可以判断成员是否掉线或正在退出。

当前可用的其他功能

文档中的功能就绪状态表显示,除 Nodes 和 Rings 外,当前 Ready 的功能还有:

  • Analyze Labels:分析给定租户和时间范围内各标签在日志流中的分布,用于理解标签基数。注意单二进制模式或关闭了 auth_enabled 时,Tenant ID 填 fake;
  • Deletes:查看计划中的 compactor 删除请求并手动删除数据,表格列出 Status、User(租户 ID)、Created At、Range、Deleted Lines、Query 等列。

而 Rollouts & Versions、Object Storage、Data Objects、Limits、Labels、Rules 等功能均为 Coming Soon,不要指望用 UI 完成这些检查。

限制与下一步

  • UI 无认证无授权,不要把它直接暴露给不受信任的网络;
  • not ready 组件会显示红色图标和错误信息,UI 文档本身不解释每种错误的成因——需要结合 Node 页的 Configuration、Analytic、Raw Metrics 标签页查看该组件的实际情况;
  • 文档同时说明该 UI 不是用来替代 meta-monitoring 的,持续性的监控告警仍应依靠原有手段。

如需继续深入了解 UI 各页面细节,可阅读 Loki UI 文档。

登录后查看全文
loki