Bitnami Grafana Loki 镜像文档

镜像概述和主要用途

Grafana Loki 是一个水平可扩展、高可用的多租户日志聚合系统，专为云原生环境设计。它采用"标签化日志"模式，优化了存储和查询效率，支持实时日志处理和持久化到对象存储。Bitnami 提供的 Grafana Loki 镜像将其打包为容器化应用，简化了在 Kubernetes 或独立 Docker 环境中的部署和管理，适用于开发、测试及生产环境。

核心功能和特性

• 水平可扩展性：通过分布式架构支持节点动态扩缩容，适应日志量增长
• 高可用性：多副本部署和数据冗余机制，确保服务持续可用
• 多租户支持：基于标签的租户隔离，确保日志数据安全隔离
• 高效存储：采用压缩和索引优化，降低存储成本，支持持久化到对象存储（如S3、GCS）
• 实时处理：支持实时日志尾随和即时查询
• Grafana 集成：原生支持 Grafana 可视化，提供统一的日志与监控体验
• 低资源占用：相比传统日志系统，降低了索引开销和内存占用

使用场景和适用范围

• 云原生环境日志聚合：Kubernetes 集群中容器日志的集中收集与分析
• 多租户平台监控：SaaS 平台或多团队环境下的日志隔离与管理
• 大规模日志处理：高流量应用的日志存储与查询（如电商、支付系统）
• 监控与可观测性体系：与 Prometheus、Grafana 联动构建完整可观测性平台
• 开发与测试环境：快速部署日志系统，支持应用调试和问题排查

详细的使用方法和配置说明

前提条件

• Docker 20.10+ 或 Kubernetes 1.23+（若使用 Helm 部署）
• Helm 3.8.0+（若使用 Helm 部署）
• 对象存储服务（如 AWS S3、Google GCS）或兼容 S3 的存储（如 MinIO）（生产环境必需）

Docker 快速部署

基本运行命令

docker run -d \
  --name grafana-loki \
  -p 3100:3100 \
  -e LOKI_CONFIG_FILE=/opt/bitnami/grafana-loki/conf/loki.yaml \
  bitnami/grafana-loki:latest

挂载自定义配置文件

docker run -d \
  --name grafana-loki \
  -p 3100:3100 \
  -v $(pwd)/loki.yaml:/opt/bitnami/grafana-loki/conf/loki.yaml \
  bitnami/grafana-loki:latest

Docker Compose 示例

version: '3.8'

services:
  loki:
    image: bitnami/grafana-loki:latest
    container_name: grafana-loki
    ports:
      - "3100:3100"  # HTTP API 端口
      - "9095:9095"  # gRPC 端口
    environment:
      - LOKI_CONFIG_FILE=/opt/bitnami/grafana-loki/conf/loki.yaml
      - LOG_LEVEL=info
    volumes:
      - ./loki.yaml:/opt/bitnami/grafana-loki/conf/loki.yaml
      - loki-data:/bitnami/grafana-loki  # 持久化数据目录（仅建议开发环境）
    restart: unless-stopped

volumes:
  loki-data:

Helm 部署（Kubernetes）

快速安装

helm install my-loki oci://registry-1.docker.io/bitnamicharts/grafana-loki

自定义安装（禁用内置 Memcached，使用外部对象存储）

helm install my-loki oci://registry-1.docker.io/bitnamicharts/grafana-loki \
  --set memcached.enabled=false \
  --set externalMemcached.host=my-memcached-host \
  --set externalMemcached.port=11211 \
  --set loki.configuration.storage_config.azure.account_name=myaccount \
  --set loki.configuration.storage_config.azure.account_key=mykey \
  --set loki.configuration.storage_config.azure.container_name=loki-data

配置文件说明

Loki 配置通过 loki.yaml 文件定义，支持全局配置及各组件（分发器、压缩器、摄取器等）的精细化设置。示例配置片段：

auth_enabled: false

server:
  http_listen_port: 3100
  grpc_listen_port: 9095

limits_config:
  retention_period: 72h
  max_query_length: 72h

storage_config:
  azure:
    account_name: "myaccount"
    account_key: "mykey"
    container_name: "loki-data"

schema_config:
  configs:
    - from: 2023-01-01
      store: azure
      object_store: azure
      schema: v13
      index:
        prefix: index_
        period: 24h

配置文件需挂载到容器内 /opt/bitnami/grafana-loki/conf/loki.yaml 路径，或通过 Helm 参数 loki.configuration 注入。

环境变量配置

通过环境变量可覆盖默认配置，常用变量如下：

持久化说明

限制说明

生产环境必须使用对象存储（如 S3、GCS、Azure Blob）。本地文件系统仅建议用于开发/测试，此时查询功能受限（依赖摄取器内存缓存）。

数据存储路径

容器内数据存储路径为 /bitnami/grafana-loki（主要用于摄取器临时数据），可通过持久卷（PV）挂载持久化。生产环境中，长期数据需配置对象存储后端（见配置文件 storage_config 部分）。

核心配置参数

全局参数

Loki 通用参数

组件参数（Compactor/Ingester 等）

外部依赖参数

⚠️ 重要通知：Bitnami 镜像变更说明

自 2025 年 8 月 28 日起，Bitnami 公共镜像仓库将升级为 Bitnami Secure Images 计划，主要变更：

1. 安全镜像开放：首次向社区用户提供安全优化版镜像（硬化配置、减小攻击面）。
2. 非硬化镜像逐步废弃：Debian 基础的非硬化镜像将从免费 tier 中逐步移除，仅保留 latest 标签（用于开发）。
3. 旧镜像迁移：所有现有镜像（含历史版本标签，如 2.50.0）将迁移至 docker.io/bitnamilegacy 仓库，不再更新。

生产环境建议：采用 Bitnami Secure Images，获取长期支持、CVE 透明度及企业级安全加固。

参考链接

• Grafana Loki 官方文档
• Bitnami Grafana Loki 镜像仓库
• Bitnami Secure Images 计划