Docker之Grafana部署
Docker之Grafana部署:可视化监控数据展示
核心部署命令
docker run -d \
--name grafana \
-p 3000:3000 \
--privileged=true \
-e TZ=Asia/Shanghai \
-v /home/grafana/data:/var/lib/grafana \
grafana/grafana:10.2.2
参数详解
参数 | 说明 | 必要性 |
---|---|---|
-p 3000:3000 | 映射Web访问端口 | 必选 |
--privileged | 解决插件安装权限问题 | 可选(建议生产环境细化权限) |
-e TZ=Asia/Shanghai | 设置时区为上海 | 中文环境建议 |
-v /home/grafana/data | 持久化存储仪表盘配置 | 强烈建议 |
grafana/grafana:10.2.2 | 指定稳定版本 | 避免使用latest |
快速配置指南
1. 初始访问
- 访问地址:
http://服务器IP:3000
- 默认账号:admin/admin
- 首次登录需修改密码
2. 添加数据源(Prometheus)
- 左侧菜单 → Configuration → Data sources
- 选择Prometheus
关键配置项:
URL: http://prometheus服务器IP:9090 # Prometheus服务地址 Access: Server (Default)
- 点击Save & test验证连接
3. 导入仪表盘
- 左侧菜单 → Dashboards → Import
输入仪表盘ID:
- Linux监控仪表盘:
16098
- Windows监控仪表盘:
10467
- Linux监控仪表盘:
- 选择对应的Prometheus数据源
- 点击Import完成导入
生产环境建议
1. 安全加固
# 启用HTTPS(需提前准备证书)
-v /path/to/certs:/etc/grafana/certs
-e GF_SERVER_PROTOCOL=https
-e GF_SERVER_CERT_FILE=/etc/grafana/certs/grafana.crt
-e GF_SERVER_CERT_KEY=/etc/grafana/certs/grafana.key
2. 性能优化
# 限制资源使用
--memory=2g --cpus=1
3. 备份策略
# 定期备份数据目录
tar -czvf grafana_backup_$(date +%Y%m%d).tar.gz /home/grafana/data
常用管理命令
# 查看运行日志
docker logs -f grafana
# 安装插件(如报警插件)
docker exec -it grafana grafana-cli plugins install grafana-image-renderer
# 重启服务
docker restart grafana
版本升级流程
- 停止旧容器:
docker stop grafana
- 备份数据:
cp -r /home/grafana/data /backup/grafana_data
启动新版本:
docker run -d \ --name grafana_new \ -p 3000:3000 \ -v /home/grafana/data:/var/lib/grafana \ grafana/grafana:新版本号
- 验证数据迁移
常见问题解决
Q:忘记admin密码?
# 重置为admin/admin
docker exec -it grafana grafana-cli admin reset-admin-password admin
Q:仪表盘显示"No data"?
- 检查Prometheus数据源配置
- 验证Prometheus的target是否正常
- 确认时间范围选择正确
Q:插件安装失败?
# 添加--plugin-admin-external-management参数
docker run ... -e GF_PLUGINS_ALLOW_LOADING_UNSIGNED_PLUGINS=plugin-id ...
通过这种部署方式,将获得:
- 版本稳定的可视化监控平台
- 开箱即用的专业仪表盘
- 可扩展的数据分析能力
- 企业级的数据持久化保障
提示:定期在Grafana官网探索新仪表盘(https://grafana.com/grafana/dashboards/)