vimagick/grafana

Grafana Docker 镜像文档

镜像概述

Grafana 是领先的开源应用，用于可视化大规模测量数据。作为将图像渲染器作为插件安装运行的替代方案，您可以使用 Docker 将其作为远程图像渲染服务运行。

核心功能和特性

• 强大的数据可视化能力，支持多种图表类型和数据源
• 支持远程图像渲染服务，可通过独立 Docker 容器部署
• 灵活的配置选项，通过环境变量自定义 Grafana 实例
• 数据持久化存储，通过卷挂载保存配置和数据
• 支持插件扩展，可安装各类可视化面板插件

使用场景和适用范围

适用于需要监控和可视化数据的各类场景，包括但不限于：

• IT 系统监控数据可视化
• 业务指标实时监控仪表盘
• 日志数据和性能指标分析
• IoT 设备数据采集与展示
• 适合开发人员、运维工程师和数据分析师使用

使用方法和配置说明

Docker Compose 配置

以下是完整的 docker-compose.yml 配置示例：

yaml
version: "3.8"

services:

  grafana:
    image: grafana/grafana
    ports:
      - "3000:3000"  # Grafana  Web 界面端口
    volumes:
      - ./data:/var/lib/grafana  # 数据持久化卷
    environment:
      - GF_SERVER_ROOT_URL=http://grafana.example.com:3000/  # 服务器根 URL
      - GF_SECURITY_ADMIN_USER=admin  # 管理员用户名
      - GF_SECURITY_ADMIN_PASSWORD=admin  # 管理员密码
      - GF_SMTP_ENABLED=true  # 启用 SMTP 邮件服务
      - GF_SMTP_HOST=smtp.gmail.com:587  # SMTP 服务器地址
      - GF_SMTP_USER=grafana@example.com  # SMTP 用户名
      - GF_SMTP_FROM_ADDRESS=grafana@example.com  # 发件人地址
      - GF_SMTP_PASSWORD=  # SMTP 密码
      - GF_USERS_ALLOW_SIGN_UP=false  # 禁用用户注册
      - GF_ALERTING_ERROR_OR_TIMEOUT=keep_state  # 警报错误或超时策略
      - GF_RENDERING_SERVER_URL=http://renderer:8081/render  # 渲染服务 URL
      - GF_RENDERING_CALLBACK_URL=http://grafana:3000/  # 渲染回调 URL
    restart: unless-stopped  # 重启策略

  renderer:
    image: grafana/grafana-image-renderer
    ports:
      - "8081:8081"  # 图像渲染服务端口
    environment:
      - ENABLE_METRICS=true  # 启用指标收集
      - BROWSER_TZ=Asia/Shanghai  # 浏览器时区设置
    restart: unless-stopped  # 重启策略

部署和启动步骤

1. 创建数据目录并设置权限：

   bash
   mkdir data
   chmod 777 data
   

2. 启动服务：

   bash
   docker-compose up -d
   

3. 进入 Grafana 容器安装插件（以世界地图面板为例）：

   bash
   docker-compose exec grafana bash
   grafana-cli plugins install grafana-worldmap-panel
   exit
   

4. 重启 Grafana 使插件生效：

   bash
   docker-compose restart
   

5. 验证服务是否正常运行：

   bash
   curl http://localhost:3000/
   

环境变量说明

Grafana 服务主要环境变量：

• GF_SERVER_ROOT_URL: Grafana 服务器的根 URL
• GF_SECURITY_ADMIN_USER: 管理员用户名
• GF_SECURITY_ADMIN_PASSWORD: 管理员密码
• GF_SMTP_*: SMTP 邮件服务相关配置
• GF_USERS_ALLOW_SIGN_UP: 是否允许用户注册
• GF_RENDERING_SERVER_URL: 远程渲染服务地址

图像渲染服务环境变量：

• ENABLE_METRICS: 是否启用指标收集
• BROWSER_TZ: 浏览器时区设置

更多配置选项可参考 Grafana 官方文档。