Wodanio Loki 镜像文档

镜像概述和主要用途

Wodanio Loki 镜像是基于 grafana/loki:latest 构建的日志聚合系统镜像，用于实现容器化环境及分布式系统的日志收集、存储与查询。该镜像简化了 Loki 的部署流程，支持通过环境变量快速配置核心参数，适用于需要轻量级、高效日志管理方案的场景。

核心功能和特性

• 环境变量配置：支持通过环境变量灵活配置 Loki 核心参数，无需手动修改配置文件
• 数据保留管理：默认启用日志数据保留期控制，可自定义保留时长
• 标准兼容：基于*** Grafana Loki 最新版本构建，完全兼容 Loki 生态及相关工具（如 Promtail、Grafana）

使用场景和适用范围

• 容器化应用日志管理：收集 Docker、Kubernetes 等容器环境中的应用日志
• 微服务架构日志聚合：集中管理分布式微服务产生的分散日志
• 轻量级日志分析：适用于对日志存储和查询性能有要求的中小型系统

详细使用方法

1. 直接运行（Docker Run）

通过 docker run 命令启动容器，可通过 -e 参数指定环境变量配置：

bash
docker run -d \
  --name wodanio-loki \
  -p 3100:3100 \
  -e HTTP_LISTEN_PORT=3100 \
  -e RETENTION_DELETES_ENABLED=true \
  -e RETENTION_PERIOD=7d \
  wodanio/loki:latest

2. Docker Compose 部署

创建 docker-compose.yml 文件，配置如下：

yaml
version: '3'
services:
  loki:
    image: wodanio/loki:latest
    container_name: wodanio-loki
    ports:
      - "3100:3100"
    environment:
      - HTTP_LISTEN_PORT=3100          # HTTP 服务监听端口
      - RETENTION_DELETES_ENABLED=true # 启用数据保留期删除策略
      - RETENTION_PERIOD=7d            # 日志数据保留时长
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

配置说明

通过环境变量可配置以下核心参数：