qtoggle/grafana

开源可观测性与数据可视化平台

镜像概述

该镜像是一个开源的可观测性和数据可视化平台，旨在帮助用户收集、分析和可视化来自多种数据源的监控指标、日志和追踪数据。通过灵活的配置和丰富的可视化能力，实现对系统性能、业务指标的实时监控与分析。

核心功能与特性

• 开源免费：基于开源协议分发，支持自由使用、修改和二次开发
• 可组合架构：模块化设计，支持灵活扩展和定制，适应不同场景需求
• 多数据源兼容：支持Prometheus、InfluxDB、Elasticsearch、MySQL等多种主流数据存储
• 丰富可视化选项：提供折线图、柱状图、热力图、仪表盘等多种图表类型
• 告警机制：支持基于指标阈值的告警规则配置，支持邮件、Slack等多种通知方式
• 仪表盘管理：支持仪表盘的创建、保存、导出、导入和共享，便于团队协作

使用场景与适用范围

• 系统监控：服务器、容器、云服务等基础设施的性能指标监控
• 应用性能监控：应用程序响应时间、错误率等关键指标分析
• 业务数据分析：用户活跃度、交易量等业务指标可视化
• 日志集中分析：结合日志数据源实现日志检索与可视化
• DevOps实践：CI/CD流程中的构建、部署状态监控
• IoT数据监控：物联网设备传感器数据实时可视化

使用方法与配置说明

快速启动

通过以下命令快速部署容器：

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

访问 http://localhost:3000 即可打开平台界面，默认登录凭据：

• 用户名：admin
• 密码：admin（首次登录需强制修改）

数据持久化配置

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

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

其中 observability-data 为持久化数据卷，存储仪表盘配置、用户数据等信息。

环境变量配置

通过环境变量自定义平台配置，常用参数：

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

示例：

bash
docker run -d -p 3000:3000 --name observability-platform \
  -e GF_SECURITY_ADMIN_PASSWORD=SecurePass123 \
  -e GF_USERS_ALLOW_SIGN_UP=false \
  -v observability-data:/var/lib/grafana \
  grafana/grafana

Docker Compose部署

创建 docker-compose.yml 文件：

yaml
version: '3'
services:
  observability-platform:
    image: grafana/grafana
    container_name: observability-platform
    ports:
      - "3000:3000"
    volumes:
      - observability-data:/var/lib/grafana
    environment:
      - GF_SECURITY_ADMIN_PASSWORD=SecurePass123
      - GF_USERS_ALLOW_SIGN_UP=false
      - GF_SERVER_ROOT_URL=http://monitor.example.com
    restart: unless-stopped

volumes:
  observability-data:

执行 docker-compose up -d 启动服务。

注意事项

• 生产环境建议配置HTTPS，可通过反向代理（如Nginx）实现
• 根据监控规模调整容器资源限制（CPU/内存）
• 定期备份持久化数据卷，防止数据丢失
• 遵循最小权限原则配置容器运行用户