MinIO 服务日志与监控实战：日志配置、Webhook、事件通知、Prometheus+Grafana 可视化全流程指南

本文旨在系统讲解如何为 MinIO 服务配置日志、事件通知、审计日志推送，以及构建完整的 Prometheus + Grafana 监控体系，适用于有一定基础的 MinIO 使用者、架构师或运维工程师。

---

一、服务日志管理

1.1 服务日志目录配置

我们可以通过环境变量 MINIO_LOG_DIR 来指定 MinIO 服务的日志目录，例如：

MINIO_LOG_DIR=/var/log/minio

1.2 使用 Docker Compose 启动 MinIO 实例

以下是一个基于 docker-compose 的 MinIO 实例配置：

services:
  minio2:
    image: quay.io/minio/minio
    container_name: minio2
    ports:
      - "19000:9000"
      - "19001:9001"
    volumes:
      - ~/minio2/data:/data
      - ~/minio2/log:/var/log/minio
    environment:
      MINIO_LOG_DIR: "/var/log/minio"
    command: server /data --console-address ":9001"
    restart: unless-stopped

日志将存储在容器内的 /var/log/minio 路径，并映射到宿主机的 ~/minio2/log 目录。

1.3 验证日志生效

执行以下命令启动服务并检查日志输出：

docker compose up -d
cat ~/minio2/log/minio*.log

如输出如下内容，说明日志配置生效：

{
   
   "level":"INFO","time":"2025-08-04T08:39:25Z","message":"MinIO Object Storage Server"}

---

二、审计日志配置

2.1 环境变量方式配置

MINIO_AUDIT_WEBHOOK_ENABLE_first="on"