Loki 部署使用

发表于 2026-04-16 上层目录 Tools 阅读次数：

Loki 是 Grafana 体系里的日志聚合系统，设计思路和 Prometheus 很像，但处理对象是日志。它和传统全文检索型日志系统的最大区别是： 默认只索引标签（labels），不索引整条日志正文 ，所以存储成本通常更低，扩展性也更好，特别适合 Kubernetes、Docker、主机系统日志、应用日志统一汇聚场景。

截至 2026-04-16，Promtail 已经 EOL，新的采集端优先建议使用 Grafana Alloy ；另外，Loki 本身不内置认证层，生产环境应放在 Nginx 等反向代理或网关之后。

它的典型链路是：

日志源 → 采集器（Alloy）→ Loki → Grafana 查询与展示

其中：

Loki 负责接收、压缩、存储、查询日志。
Alloy 负责在主机或 K8s 节点上收集日志、打标签、做预处理，再推送到 Loki。
Grafana 负责可视化、检索、告警。

Loki 核心架构逻辑上常见有这些组件：

Distributor ：接收写入请求
Ingester ：缓存并写入日志块
Querier ：执行查询
Query Frontend ：查询拆分与缓存
Compactor ：压缩、整理、保留策略
Index / Storage ：索引和日志对象存储

标签设计建议

Loki 的性能很大程度取决于标签设计，因此标签设计非常关键。

建议保留低基数标签 ：

job
host
env
app
namespace
pod
container

不要把高基数内容做成标签 ：

user_id
request_id
trace_id
URL 全路径
错误详情
SQL 文本

官方文档强调 labels 是 Loki 的核心组织方式，但标签过多、基数过高会带来性能和成本问题。

Docker Compose 部署示例

docker-compose.yaml

services:
  loki:
    image: grafana/loki:latest
    command:
      - '-config.file=/etc/loki/config.yaml'    
    ports:
      - "3100:3100"
    volumes:
      - "./config/loki/:/etc/loki/:ro"
      - "./data/loki/:/data/loki"

  grafana:
    image: grafana/grafana
    ports:
      - "3000:3000"
    volumes:
      - "./config/grafana/:/etc/grafana/"
      - "./data/grafana/:/var/lib/grafana/"


  alloy:
    image: grafana/alloy
    container_name: alloy
    restart: unless-stopped
    ports:
      - "12345:12345"
    command:
      - run
      - --server.http.listen-addr=0.0.0.0:12345
      - --storage.path=/var/lib/alloy/data
      - /etc/alloy/config.alloy
    volumes:
      - ./config/alloy/:/etc/alloy/:ro
      - ./data/alloy/:/var/lib/alloy/data
      - /var/run/docker.sock:/var/run/docker.sock

主配置文件 /etc/loki/config.yaml 内容参考：

/etc/loki/config.yaml

auth_enabled: false

server:
  http_listen_port: 3100

common:
  path_prefix: /loki
  replication_factor: 1
  ring:
    kvstore:
      store: inmemory

schema_config:
  configs:
    - from: "2024-01-01"
      store: tsdb
      object_store: filesystem
      schema: v13
      index:
        prefix: index_
        period: 24h

storage_config:
  filesystem:
    directory: /loki/chunks

limits_config:
  allow_structured_metadata: true
  retention_period: 168h

compactor:
  working_directory: /loki/compactor
  retention_enabled: true
  delete_request_store: filesystem

Alloy 配置文件参考：

config/alloy/config.alloy

logging {
  level  = "info"
  format = "logfmt"
}

discovery.docker "containers" {
  host = "unix:///var/run/docker.sock"
}

discovery.relabel "docker_logs" {
  targets = discovery.docker.containers.targets

  rule {
    source_labels = ["__meta_docker_container_name"]
    target_label  = "container"
    regex         = "/(.*)"
    replacement   = "$1"
  }

  rule {
    source_labels = ["__meta_docker_container_log_stream"]
    target_label  = "stream"
  }

  rule {
    source_labels = ["__meta_docker_container_label_com_docker_compose_service"]
    target_label  = "service"
  }
}

loki.source.docker "containers" {
  host       = "unix:///var/run/docker.sock"
  targets    = discovery.relabel.docker_logs.output
  forward_to = [loki.write.local.receiver]
}

loki.write "local" {
  endpoint {
    url = "http://loki:3100/loki/api/v1/push"
  }

  external_labels = {
    host = "prometheus-jumpserver",
    env  = "prod",
  }
}

启动成功后，在 Grafana 中添加新的 Data Source。即可在 Grafana 中查看到日志。