开源数据可视化与监控平台Grafana的主分支构建版本,供开发者测试最新功能、构建实时监控系统。
Grafana Docker镜像(开发版)
镜像概述和主要用途
Grafana Docker镜像(开发版)是基于Grafana OSS(开源版)master分支构建的Docker镜像,属于开发预览版本。该镜像包含Grafana最新开发进度的代码,旨在为开发人员和测试人员提供提前体验、测试未发布功能的环境,不建议用于生产部署。
核心功能和特性
核心功能
- 数据可视化:支持折线图、柱状图、饼图、热力图等多种图表类型,实现数据直观展示。
- 多数据源兼容:原生支持Prometheus、InfluxDB、Elasticsearch、MySQL等数十种主流数据源。
- 仪表盘管理:提供仪表盘创建、编辑、导入/导出功能,支持模板化和动态变量配置。
- 告警系统:支持基于指标阈值的告警规则配置,可集成邮件、Slack、Webhook等通知渠道。
开发版特性
- 基于Grafana OSS master分支最新代码构建,包含尚未发布的功能特性。
- 持续集成更新,反映最新开发进度和bug修复。
- 提供开发环境下的功能预览,支持提前验证新特性兼容性。
使用场景和适用范围
适用场景
- 开发环境:开发人员用于测试新功能、验证代码变更效果。
- 功能测试:QA团队在集成测试环境中验证未发布功能的功能完整性。
- 特性预览:技术团队评估即将发布的版本特性,规划适配方案。
不适用场景
- 生产环境:开发版镜像稳定性、兼容性未经过充分验证,可能存在未知bug或功能变更。
- 关键业务系统:数据可靠性和服务可用性无法得到保障。
使用方法和配置说明
快速启动
通过以下命令快速启动Grafana容器,默认绑定主机3000端口:
bashdocker run -d --name=grafana -p 3000:3000 docker.xuanyuan.run/grafana/grafana
参数说明
-d:后台运行容器。--name=grafana:指定容器名称为grafana。-p 3000:3000:将容器内3000端口(Grafana默认端口)映射到主机3000端口。grafana/grafana:使用Grafana官方开发版镜像(基于master分支构建)。
自定义配置
1. 修改默认管理员凭据
通过环境变量GF_SECURITY_ADMIN_PASSWORD自定义管理员密码:
bashdocker run -d \ --name=grafana \ -p 3000:3000 \ -e GF_SECURITY_ADMIN_PASSWORD="CustomPassword123" \ docker.xuanyuan.run/grafana/grafana
2. 持久化数据存储
通过挂载卷(Volume)持久化Grafana数据(如仪表盘配置、用户数据等):
bash# 创建数据卷(可选,也可直接挂载主机目录) docker volume create grafana-data # 启动容器并挂载数据卷 docker run -d \ --name=grafana \ -p 3000:3000 \ -v grafana-data:/var/lib/grafana \ # 挂载数据目录 grafana/grafana
3. 自定义端口
通过环境变量GF_SERVER_HTTP_PORT修改容器内Grafana服务端口,并映射到主机自定义端口:
bashdocker run -d \ --name=grafana \ -p 8080:8080 \ # 主机8080端口映射到容器8080端口 -e GF_SERVER_HTTP_PORT=8080 \ # 容器内服务端口设为8080 grafana/grafana
Docker Compose配置示例
创建docker-compose.yml文件,定义完整部署配置:
yamlversion: '3' services: grafana: image: docker.xuanyuan.run/grafana/grafana container_name: grafana restart: unless-stopped # 容器退出时自动重启(除非手动停止) ports: - "3000:3000" environment: - GF_SECURITY_ADMIN_PASSWORD=Admin@123 # 自定义管理员密码 - GF_SERVER_ROOT_URL=http://grafana.example.com # 配置根URL(如反向代理场景) - GF_LOG_LEVEL=info # 日志级别(debug/info/warn/error) volumes: - grafana-data:/var/lib/grafana # 持久化数据 - ./grafana.ini:/etc/grafana/grafana.ini # 挂载自定义配置文件(可选) volumes: grafana-data: # 声明数据卷
启动服务:
bashdocker-compose up -d
访问与登录
容器启动后,通过以下方式访问Grafana:
- 地址:
http://<主机IP或域名>:3000(默认端口,如修改则使用自定义端口) - 默认凭据:
- 用户名:
admin - 密码:默认
admin(如未自定义)或通过GF_SECURITY_ADMIN_PASSWORD设置的自定义密码
- 用户名:
配置参数说明
Grafana支持通过环境变量或配置文件(grafana.ini)自定义配置,常用环境变量如下:
| 环境变量键 | 说明 | 默认值 |
|---|---|---|
GF_SECURITY_ADMIN_USER | 管理员用户名 | admin |
GF_SECURITY_ADMIN_PASSWORD | 管理员密码 | admin |
GF_SERVER_HTTP_PORT | HTTP服务端口 | 3000 |
GF_SERVER_ROOT_URL | 服务根URL(用于反向代理、邮件通知等) | http://localhost:3000 |
GF_DATABASE_TYPE | 数据库类型(如sqlite3、mysql) | sqlite3 |
GF_LOG_LEVEL | 日志级别(debug/info/warn/error) | info |
Changelog
Grafana的版本更新和功能变更详情,请参考官方文档:
- https://grafana.com/docs/
- https://grafana.com/docs/grafana/latest/whatsnew/
注意事项
- 稳定性提示:开发版镜像基于master分支构建,可能包含未经过充分测试的代码,存在功能不稳定或兼容性问题。
- 数据安全:开发环境中建议定期备份持久化数据,避免因版本更新导致数据丢失。
- 生产替代:生产环境请使用https://hub.docker.com/r/grafana/grafana,并遵循官方部署最佳实践。
grafana 命名空间的其他可用镜像:
grafana/grafana
Grafana 监控和可视化平台,支持多种数据源和仪表板
grafana/loki
Grafana Loki 日志聚合系统,适合日志收集和查询
grafana/alloy
Grafana Alloy 遥测收集器,适合指标、日志和追踪数据收集
grafana/grafana-enterprise
Grafana Enterprise 企业版可视化平台,适合监控和数据分析
grafana/promtail
Promtail 日志收集器,Grafana 官方维护,适合 Loki 日志聚合
grafana/grafana-image-renderer
Grafana 图表图片渲染器,适合告警通知与报表导出
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 grafana-oss-dev 镜像标签
docker pull docker.xuanyuan.run/grafana/grafana-oss-dev:<标签>
DockerHub 原生拉取命令
docker pull grafana/grafana-oss-dev:<标签>
用户好评
来自真实用户的反馈,见证轩辕镜像的优质服务