Grafana Loki Docker 日志驱动配置详解

苗韵列Ivan

于 2025-06-01 09:05:19 发布

阅读量410

点赞数 3

本文链接：https://blog.csdn.net/gitblog_01059/article/details/148361129

版权

Grafana Loki Docker 日志驱动配置详解

loki Loki是一个开源、高扩展性和多租户的日志聚合系统，由Grafana Labs开发。它主要用于收集、存储和查询大量日志数据，并通过标签索引提供高效检索能力。Loki特别适用于监控场景，与Grafana可视化平台深度集成，帮助用户快速分析和发现问题。项目地址: https://gitcode.com/gh_mirrors/lok/loki

概述

Grafana Loki 是一个高效的日志聚合系统，而 Docker 日志驱动则是将容器日志直接发送到 Loki 的便捷方式。本文将深入讲解如何配置 Docker 日志驱动，实现容器日志的高效收集与管理。

Docker 日志驱动基础

Docker 引擎默认使用 json-file 日志驱动，但我们可以通过配置让容器使用 Loki 日志驱动。这种集成方式有以下优势：

实时日志收集：容器日志直接发送到 Loki，无需额外代理
资源占用低：相比传统日志收集方案更加轻量
原生集成：直接利用 Docker 的日志驱动机制

安装准备

在开始配置前，请确保已在 Docker 主机上安装 Loki 日志驱动插件。安装过程简单，只需执行相应命令即可完成。

单容器配置

对于单个容器，可以在 docker run 命令中直接指定日志驱动：

docker run --log-driver=loki \
    --log-opt loki-url="http://loki:3100/loki/api/v1/push" \
    --log-opt loki-retries=5 \
    --log-opt loki-batch-size=400 \
    nginx:latest

关键参数说明：

loki-url: Loki 服务端点
loki-retries: 发送失败时的重试次数
loki-batch-size: 日志批次大小

全局默认配置

如需让所有新容器默认使用 Loki 日志驱动，可修改 Docker 的 daemon.json 配置文件：

{
  "log-driver": "loki",
  "log-opts": {
    "loki-url": "http://loki:3100/loki/api/v1/push",
    "loki-batch-size": "400",
    "loki-external-labels": "cluster=prod,zone=us-east"
  }
}

修改后需重启 Docker 服务使配置生效。

重要提示：在 daemon.json 中，所有选项值必须为字符串格式，即使是数字或布尔值也需要用引号包裹。

Swarm 和 Compose 配置

在 Docker Swarm 或 Compose 环境中，可以直接在 YAML 文件中配置日志驱动：

version: "3.7"
services:
  web:
    image: nginx:latest
    logging:
      driver: loki
      options:
        loki-url: "http://loki:3100/loki/api/v1/push"
        loki-external-labels: "service=nginx"

部署后，服务日志将自动发送到 Loki。

标签系统详解

Loki 使用标签对日志进行索引和查询。Docker 驱动默认添加以下标签：

filename: 日志在磁盘上的存储路径
host: 生成日志的主机名
对于 Swarm 服务：swarm_stack, swarm_service
对于 Compose 服务：compose_project, compose_service

自定义标签可通过多种方式添加：

loki-external-labels: 静态标签
labels: 容器标签
env: 环境变量
日志处理管道

日志处理管道

Loki 提供了强大的日志处理管道功能，可以在日志发送前进行处理：

logging:
  driver: loki
  options:
    loki-url: "http://loki:3100/loki/api/v1/push"
    loki-pipeline-stages: |
      - regex:
          expression: '(level|lvl|severity)=(?P<level>\w+)'
      - labels:
          level:

这个例子配置了两个处理阶段：

使用正则表达式提取日志级别
将提取的级别作为标签

标签重命名

使用 Prometheus 风格的 relabel 配置可以重命名标签：

loki-relabel-config: |
  - action: labelmap
    regex: swarm_stack
    replacement: namespace
  - action: labelmap
    regex: swarm_(service)

这会将 swarm_stack 重命名为 namespace，swarm_service 重命名为 service。

完整配置选项参考

| 选项 | 必填 | 默认值 | 说明 | |------|------|--------|------| | loki-url | 是 | 无 | Loki 服务端点 | | loki-external-labels | 否 | container_name={{.Name}} | 额外标签 | | loki-timeout | 否 | 10s | 发送超时时间 | | loki-batch-wait | 否 | 1s | 批次等待时间 | | loki-batch-size | 否 | 1048576 | 批次大小限制 | | loki-retries | 否 | 10 | 最大重试次数 | | loki-pipeline-stages | 否 | 无 | 日志处理管道 | | loki-relabel-config | 否 | 无 | 标签重命名配置 | | no-file | 否 | false | 禁用本地日志文件 | | max-size | 否 | -1 | 日志文件大小限制 | | max-file | 否 | 1 | 保留日志文件数量 |