blackbelt/grafana

Grafana Docker镜像文档

镜像概述和主要用途

Grafana Docker镜像基于Alpine Linux构建，提供了一种强大且优雅的方式来创建、探索和分享仪表板及数据。该镜像旨在简化Grafana的部署流程，让用户能够快速搭建可视化监控和数据分析平台，支持与团队及全球用户共享数据洞察。

核心功能和特性

• 仪表板创建：提供直观的界面，支持自定义创建各类指标和分析仪表板
• 数据探索：强大的数据查询和分析功能，支持多种数据源集成
• 分享功能：支持将仪表板分享给团队成员或公开到全球
• 轻量级基础：基于Alpine Linux，镜像体积小，资源占用低
• 灵活配置：支持通过环境变量、配置文件等方式自定义Grafana设置

使用场景和适用范围

• 系统监控：服务器、应用程序、网络设备等基础设施监控
• 业务分析：销售数据、用户行为、业务指标等数据分析可视化
• 团队协作：跨团队共享监控数据和业务指标
• 开源项目：为开源项目提供数据可视化展示平台
• 科研分析：科研数据的可视化和共享

使用方法和配置说明

基本部署（docker run）

bash
docker run -d -p 3000:3000 --name grafana grafana/grafana

• -d：后台运行容器
• -p 3000:3000：将容器的3000端口映射到主机的3000端口（Grafana默认端口）
• --name grafana：指定容器名称为grafana
• grafana/grafana：使用官方Grafana镜像

数据持久化部署

为避免容器重启后数据丢失，建议挂载数据卷：

bash
docker run -d -p 3000:3000 --name grafana \
  -v grafana-data:/var/lib/grafana \
  grafana/grafana

• -v grafana-data:/var/lib/grafana：将容器内的/var/lib/grafana目录挂载到名为grafana-data的卷，实现数据持久化

Docker Compose配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  grafana:
    image: grafana/grafana
    container_name: grafana
    ports:
      - "3000:3000"
    volumes:
      - grafana-data:/var/lib/grafana
    restart: unless-stopped

volumes:
  grafana-data:

启动命令：docker-compose up -d

环境变量配置

可通过环境变量自定义Grafana配置，常用环境变量：

• GF_SECURITY_ADMIN_PASSWORD：设置管理员密码
• GF_USERS_ALLOW_SIGN_UP：是否允许用户注册（true/false）
• GF_SERVER_HTTP_PORT：修改HTTP服务端口
• GF_DATABASE_TYPE：数据库类型（默认sqlite3）

示例：设置管理员密码

bash
docker run -d -p 3000:3000 --name grafana \
  -e GF_SECURITY_ADMIN_PASSWORD=secretpassword \
  grafana/grafana

访问Grafana

部署完成后，通过浏览器访问 http://localhost:3000，使用默认账号（用户名：admin，密码：admin）登录，首次登录会提示修改密码。