logzio/mysql-logs 镜像文档

镜像概述和主要用途

logzio/mysql-logs 是一个用于将 MySQL Server 或 AWS RDS MySQL 实例的日志通过 FileBeat 发送至 Logz.io 的 Docker 镜像。其核心功能是简化 MySQL 日志的收集与上传流程，帮助用户将数据库日志集中到 Logz.io 平台进行分析、监控与审计。

核心功能和特性

• 多场景支持：同时支持本地 MySQL 服务器日志和 AWS RDS MySQL 日志的收集与上传。
• 灵活配置：可自定义日志文件路径（错误日志、慢查询日志、通用日志），适配不同部署环境。
• Logz.io 集成：支持自定义 Logz.io listener 地址，确保日志数据高效传输。
• RDS 适配：通过 AWS 凭证（Access Key/Secret Key）安全访问 RDS 日志，支持配置同步间隔和区域。

使用场景和适用范围

适用于需要将 MySQL 日志集中管理并上传至 Logz.io 的场景，包括：

• 本地 MySQL 服务器的日志监控（如错误排查、性能分析、安全审计）。
• AWS RDS MySQL 实例的日志远程收集（无需直接访问 RDS 实例文件系统）。
• 数据库运维团队需通过 Logz.io 平台统一分析多环境 MySQL 日志的场景。

详细使用方法和配置说明

1. 本地 MySQL 日志收集

部署命令格式

bash
docker run -d --name logzio-mysql-logs \
  -e LOGZIO_TOKEN=VALUE \
  [-e LOGZIO_LISTENER=VALUE] \
  [-e MYSQL_ERROR_LOG_FILE=VALUE] \
  [-e MYSQL_SLOW_LOG_FILE=VALUE] \
  [-e MYSQL_LOG_FILE=VALUE] \
  -v 本地日志目录:/var/log/logzio \
  -v 本地MySQL日志目录:/var/log/mysql \
  logzio/mysql-logs:latest

环境变量说明

卷挂载说明

• -v 本地日志目录:/var/log/logzio：挂载本地目录用于存储 FileBeat 日志（如传输状态、错误日志）。
• -v 本地MySQL日志目录:/var/log/mysql：挂载本地 MySQL 日志所在目录，确保容器可读取日志文件。

部署示例

bash
docker run -d \
  --name logzio-mysql-logs \
  -e LOGZIO_TOKEN="YOUR_LOGZIO_TOKEN" \  # 替换为实际的Logz.io令牌
  -v /opt/logzio:/var/log/logzio \       # 本地存储FileBeat日志的目录
  -v /var/log/mysql:/var/log/mysql \     # 本地MySQL日志目录（需确保权限）
  --restart=always \                     # 容器异常时自动重启
  logzio/mysql-logs:latest

2. AWS RDS MySQL 日志收集

部署命令格式

bash
docker run -d --name logzio-mysql-logs \
  -e LOGZIO_TOKEN=VALUE \
  -e AWS_ACCESS_KEY=VALUE \
  -e AWS_SECRET_KEY=VALUE \
  -e RDS_IDENTIFIER=VALUE \
  [-e AWS_REGION=VALUE] \
  [-e LOGZIO_LISTENER=VALUE] \
  [-e RDS_ERROR_LOG_FILE=VALUE] \
  [-e RDS_SLOW_LOG_FILE=VALUE] \
  [-e RDS_LOG_FILE=VALUE] \
  [-e INTERVAL_SECONDS=VALUE] \
  -v 本地日志目录:/var/log/logzio \
  -v 本地临时目录:/var/log/mysql \
  logzio/mysql-logs:latest

环境变量说明

卷挂载说明

• -v 本地日志目录:/var/log/logzio：存储 FileBeat 日志（同本地 MySQL 场景）。
• -v 本地临时目录:/var/log/mysql：容器本地临时存储下载的 RDS 日志文件。

部署示例

bash
docker run -d \
  --name logzio-mysql-logs \
  -e LOGZIO_TOKEN="YOUR_LOGZIO_TOKEN" \          # 替换为实际的Logz.io令牌
  -e AWS_ACCESS_KEY="YOUR_AWS_ACCESS_KEY" \      # 替换为AWS访问密钥
  -e AWS_SECRET_KEY="YOUR_AWS_SECRET_KEY" \      # 替换为AWS密钥
  -e AWS_REGION="us-west-2" \                    # RDS实例所在区域（如非默认需指定）
  -e RDS_IDENTIFIER="my-rds-mysql-instance" \    # RDS实例标识符
  -e RDS_ERROR_LOG_FILE="error/mysql-error.log" \ # RDS错误日志路径（默认可不填）
  -e INTERVAL_SECONDS=30 \                       # 日志同步间隔30秒（默认60秒）
  -v /opt/logzio:/var/log/logzio \               # 本地存储FileBeat日志的目录
  -v /tmp/rds-logs:/var/log/mysql \              # 临时存储RDS日志的本地目录
  logzio/mysql-logs:latest

Logz.io 仪表板截图

部署后，可在 Logz.io 平台查看 MySQL 日志监控仪表板，示例如下：

!Logz.io MySQL 监控仪表板

关于 Logz.io

Logz.io 结合开源日志分析工具与行为学***智能，帮助用户精准定位关键信息，简化日志监控与问题排查流程。更多信息请访问 Logz.io 官网。