sebbo2002/fhem-log2db

FHEM日志解析与数据库推送工具镜像

镜像概述

本Docker镜像包含一个轻量级命令行工具，专门用于解析FHEM（一款智能家居自动化系统）生成的日志文件，并将解析后的日志条目批量推送至指定数据库，实现FHEM日志数据的结构化存储与后续分析。

核心功能与特性

• 日志解析：支持FHEM标准日志格式解析，提取关键事件、时间戳、设备状态等信息
• 数据库集成：支持主流关系型数据库（如MySQL、PostgreSQL等）的数据推送
• 轻量高效：命令行运行模式，资源占用低，适合后台定时任务执行
• 配置灵活：通过环境变量或配置文件自定义日志路径、数据库连接参数等

使用场景

• FHEM智能家居系统的日志数据持久化存储
• 基于FHEM日志的设备状态分析与统计
• 智能家居系统运行状态监控与问题排查
• 与第三方数据分析平台集成的前置数据处理

使用方法

基本运行方式

通过docker run命令直接运行工具，需指定必要的数据库连接参数和日志文件路径：

bash
docker run --rm \
  -v /path/to/fhem/logs:/app/logs \  # 挂载本地FHEM日志目录
  -e DB_HOST=your-db-host \          # 数据库主机地址
  -e DB_PORT=5432 \                  # 数据库端口
  -e DB_USER=db-user \               # 数据库用户名
  -e DB_PASSWORD=db-password \       # 数据库密码
  -e DB_NAME=fhem_logs \             # 目标数据库名称
  -e LOG_PATH=/app/logs/fhem.log     # 容器内日志文件路径
  fhem-log-parser:latest

环境变量配置

Docker Compose配置示例

yaml
version: '3'
services:
  fhem-log-parser:
    image: fhem-log-parser:latest
    volumes:
      - /opt/fhem/log:/app/logs
    environment:
      - DB_HOST=db
      - DB_PORT=5432
      - DB_USER=fhem_user
      - DB_PASSWORD=secure_password
      - DB_NAME=fhem_logs
      - LOG_PATH=/app/logs/fhem-$(date +%Y-%m-%d).log
      - PARSE_INTERVAL=30
    depends_on:
      - db

  db:
    image: postgres:14
    environment:
      - POSTGRES_USER=fhem_user
      - POSTGRES_PASSWORD=secure_password
      - POSTGRES_DB=fhem_logs
    volumes:
      - postgres_data:/var/lib/postgresql/data

volumes:
  postgres_data:

注意事项

1. 确保挂载的日志目录具有读权限，容器内用户需能访问日志文件
2. 首次运行前需确保目标数据库已存在，工具不会自动创建数据库
3. 日志文件需符合FHEM标准格式（通常包含时间戳、设备名称、事件类型等字段）
4. 对于大日志文件，建议通过PARSE_INTERVAL配置定时增量解析，避免性能问题