mradmin/grafana

Grafana Docker镜像文档

镜像概述和主要用途

Grafana是一款开源的数据分析与可视化平台，该Docker镜像封装了Grafana服务，提供开箱即用的时间序列数据监控、可视化和告警功能。通过Web界面（默认端口3000），用户可连接多种数据源（如Prometheus、InfluxDB、MySQL等），创建自定义仪表盘，监控系统指标、业务数据或IoT设备状态，并配置告警规则及时响应异常。

核心功能和特性

• 多数据源支持：兼容Prometheus、InfluxDB、PostgreSQL、MySQL、Elasticsearch等数十种数据源
• 丰富可视化选项：提供折线图、柱状图、热力图、仪表盘等多种图表类型，支持自定义布局
• 告警系统：支持基于指标阈值的告警规则，可通过邮件、Slack、Webhook等方式推送通知
• 数据持久化：通过挂载数据卷保存grafana.db数据库文件，确保配置、仪表盘和历史数据不丢失
• 用户权限管理：支持多用户、组织和角色配置，实现精细化权限控制
• 插件扩展：支持安装第三方插件扩展功能，如自定义数据源、图表类型等

使用场景和适用范围

• IT系统监控：服务器、容器、云资源等基础设施指标监控
• 业务数据可视化：销售数据、用户活跃度等业务指标实时展示
• IoT设备监控：传感器数据采集与可视化分析
• DevOps流程：CI/CD pipeline状态监控、应用性能指标追踪
• 科研数据展示：实验数据实时可视化与趋势分析

使用方法和配置说明

基本运行命令

通过以下命令启动Grafana容器，映射端口并持久化数据：

bash
sudo docker run -d -i -t \
  -v /grafana/grafana.db:/var/lib/grafana/grafana.db \  # 挂载数据卷持久化数据库
  -p 3000:3000 \  # 映射容器3000端口到主机3000端口
  --name grafana \  # 指定容器名称
  grafana/grafana  # 使用官方Grafana镜像

参数说明：

• -d：后台运行容器
• -i：保持标准输入打开
• -t：分配伪终端
• -v /grafana/grafana.db:/var/lib/grafana/grafana.db：将主机/grafana/grafana.db文件挂载到容器内Grafana数据库路径，实现数据持久化
• -p 3000:3000：端口映射，主机3000端口对应容器3000端口（Grafana默认Web端口）

Docker Compose配置示例

创建docker-compose.yml文件，简化部署和管理：

yaml
version: '3'
services:
  grafana:
    image: docker.xuanyuan.run/grafana/grafana
    container_name: grafana
    restart: always  # 容器退出时自动重启
    ports:
      - "3000:3000"
    volumes:
      - /grafana/grafana.db:/var/lib/grafana/grafana.db  # 数据持久化
      - /grafana/plugins:/var/lib/grafana/plugins  # 可选，挂载插件目录
    environment:
      - GF_SECURITY_ADMIN_PASSWORD=admin123  # 设置管理员密码
      - GF_USERS_ALLOW_SIGN_UP=false  # 禁用用户注册
    networks:
      - monitoring  # 可选，加入自定义网络

networks:
  monitoring:

启动命令：docker-compose up -d

关键配置参数

环境变量

通过-e参数或environment配置项设置Grafana运行参数：

• GF_SECURITY_ADMIN_PASSWORD：管理员密码（默认用户名admin，首次登录需修改）
• GF_USERS_ALLOW_SIGN_UP：是否允许用户注册（默认true）
• GF_SERVER_HTTP_PORT：修改Web服务端口（默认3000）
• GF_DATABASE_TYPE：数据库类型（默认sqlite3，即grafana.db文件）

数据卷挂载

除核心数据库文件外，可挂载以下目录实现更多配置持久化：

• /var/lib/grafana/plugins：插件目录，存放自定义插件
• /etc/grafana/grafana.ini：Grafana主配置文件
• /var/log/grafana：日志目录

访问与使用

容器启动后，通过浏览器访问 http://<主机IP>:3000，使用管理员账号（默认admin/admin，首次登录需修改密码）登录，之后可：

1. 添加数据源（左侧菜单"Configuration > Data Sources"）
2. 创建仪表盘（左侧菜单"+ > Dashboard"）
3. 配置告警规则（仪表盘编辑页面"Alert"选项卡）

停止与更新

• 停止容器：docker stop grafana
• 重启容器：docker restart grafana
• 更新镜像：docker pull docker.xuanyuan.run/grafana/grafana后重新启动容器（需确保数据卷已挂载，避免数据丢失）