victronenergy/venus-influx-loader

Venus Grafana 镜像文档

镜像概述

Venus Grafana镜像是Victron Energy为Venus能源管理系统开发的Grafana集成解决方案，旨在提供便捷的能源数据可视化与监控能力。通过该镜像，用户可快速部署Grafana，并与Venus系统集成，实现太阳能、电池、逆变器等能源设备数据的集中展示与分析。

核心功能和特性

• Grafana集成：内置Grafana服务，支持折线图、柱状图、仪表图等多种数据可视化图表
• Venus数据对接：优化的数据源配置，可直接从Venus能源管理系统获取实时及历史能源数据
• 预设监控仪表板：包含针对Venus系统的预设仪表板，覆盖发电量、用电量、电池状态等关键能源指标
• 灵活配置：支持自定义数据源、仪表板和告警规则，满足个性化监控需求

使用场景和适用范围

• Venus能源管理系统用户：适用于已部署Victron Energy Venus系统的个人或企业用户
• 太阳能系统监控：用于监控太阳能光伏系统的发电量、效率及性能分析
• 电池储能系统：监控电池充放电状态、SOC（荷电状态）、健康状况等指标
• 家庭/商业能源管理：帮助用户可视化能源消耗模式，优化能源使用效率

使用方法和配置说明

前提条件

• 已部署Victron Energy Venus系统，且网络可与Grafana容器通信
• 安装Docker和Docker Compose（推荐）

快速启动（Docker Run）

bash
docker run -d --name venus-grafana -p 3000:3000 docker.xuanyuan.run/victronenergy/venus-grafana

注：基础启动命令，实际使用需根据GitHub仓库说明配置必要的环境变量

Docker Compose配置示例

yaml
version: '3'
services:
  venus-grafana:
    image: docker.xuanyuan.run/victronenergy/venus-grafana
    container_name: venus-grafana
    ports:
      - "3000:3000"  # Grafana Web界面端口
    environment:
      - VENUS_HOST=your_venus_system_ip  # Venus系统IP地址
      - GF_SECURITY_ADMIN_PASSWORD=your_admin_password  # Grafana管理员密码
    volumes:
      - grafana_data:/var/lib/grafana  # 持久化Grafana数据
    restart: unless-stopped

volumes:
  grafana_data:

配置说明

环境变量

• VENUS_HOST：Venus系统的IP地址或主机名，用于建立数据连接
• GF_SECURITY_ADMIN_PASSWORD：Grafana管理员密码，首次登录时使用
• 其他Grafana标准环境变量可参考https://grafana.com/docs/grafana/latest/setup-grafana/configure-docker/

数据持久化

通过挂载/var/lib/grafana目录，可确保Grafana配置、仪表板和数据在容器重启后不丢失。

注意事项

• 详细配置指南、预设仪表板导入方法及高级功能，请参考官方GitHub仓库：https://github.com/victronenergy/venus-grafana
• 确保Venus系统与Grafana容器之间的网络连通性，必要时配置防火墙规则以允许数据通信