opentokix/grafana

镜像概述

本镜像提供完整的graphite/grafana监控技术栈，集成了go-carbon（碳数据存储）、graphite-web（数据查询与展示）和grafana（可视化仪表盘）组件，可快速部署用于指标数据的收集、存储和可视化分析。

注意：存在新版本镜像 opentokix/gografana，但该版本尚未经过测试，建议使用当前稳定版本。

核心功能与特性

• 组件集成：包含go-carbon（高效碳数据存储）、graphite-web（数据查询接口）和grafana（可视化平台）
• 数据持久化：支持将数据（包括grafana插件、仪表盘等）持久化到主机目录
• 即开即用：无需复杂配置，快速部署完整监控栈
• 插件支持：可通过命令行安装grafana插件扩展功能

使用场景

• 服务器性能指标监控
• 应用程序运行状态跟踪
• 系统资源使用率可视化
• 快速搭建临时或生产环境的监控系统

使用方法

拉取镜像

bash
docker pull docker.xuanyuan.run/opentokix/grafana:latest

运行容器

非持久化运行（数据会丢失）

bash
docker run -p 2003:2003 -p 3000:3000 -d docker.xuanyuan.run/opentokix/grafana:latest

持久化运行（数据保存到主机）

将数据（包括grafana插件、仪表盘、graphite数据等）保存到主机的 /srv/metrics 目录：

bash
docker run -d -v /srv/metrics:/data -p 2003:2003 -p 3000:3000 docker.xuanyuan.run/opentokix/grafana:latest

安装Grafana插件

1. 进入运行中的容器：

   bash
   docker exec -it <containerID> /bin/bash
   

2. 执行插件安装命令（以 neocat-cal-heatmap-panel 为例）：

   bash
   grafana-cli --pluginsDir=/data/grafana/plugins plugins install neocat-cal-heatmap-panel
   

3. 重启容器或Grafana服务使插件生效：

   bash
   # 方式1：重启容器
   docker restart <containerID>
   
   # 方式2：容器内重启服务
   service grafana-server restart
   

发送指标数据

通过2003端口发送指标数据，格式为：

prefix.suffix value timestamp\n

（符合collectd/carbon标准格式）

Grafana初始配置

1. 访问Grafana：通过浏览器访问 http://<主机IP>:3000

2. 登录：默认用户名/密码为 admin/admin

3. 添加数据源：

   • 首次启动时需手动添加数据源
   • 选择Graphite数据源
   • 配置默认端点 localhost:8080
   • 其他参数保持默认设置

高级示例

仅持久化graphite的***数据到主机 /srv/graphite/whisper 目录：

bash
docker run -v /srv/graphite/whisper:/data/graphite/whisper,rw docker.xuanyuan.run/opentokix/grafana

更新说明

• 2017-11-23：修复数据持久化问题，确保实际保存数据（而非仅文档说明）。