一、miniboard介绍
1.1 miniboard简洁
- miniboard简介
miniboard是一款开源的、带有选项卡、正常运行时间监控和通知的轻量级仪表板。，可以通过GUI或yaml文件进行配置。
1.2 miniboard特点
- 提供实时监控和报警功能，及时发现和解决容器运行异常和网站服务故障；
- 支持自定义监控指标，可以根据业务需求设置特定的监控项；
- 采用轻量级的监控代理，减少对系统资源的占用；
- 支持多种部署方式，包括Docker部署和传统部署，提供灵活的选择；
- 提供可视化的仪表盘和报表，直观展示服务状态和性能指标；
- 提供友好的用户界面和操作流程，使新手也能轻松上手使用。
二、本地环境介绍
2.1 本地环境规划
本次实践为个人测试环境，操作系统版本为centos7.6。
| hostname | IP地址 | 操作系统版本 | Docker版本 |
|---|---|---|---|
| jeven | 192.168.3.166 | centos 7.6 | 20.10.17 |
2.2 本次实践介绍
1.本次实践部署环境为个人测试环境，生产环境请谨慎；
2.在Docker环境下部署miniboard轻量级监控仪表板。三、本地环境检查
3.1 检查Docker服务状态
检查Docker服务是否正常运行，确保Docker正常运行。
[root@jeven ~]# systemctl status docker
● docker.service - Docker Application Container Engine
Loaded: loaded (/usr/lib/systemd/system/docker.service; enabled; vendor preset: disabled)
Active: active (running) since Tue 2023-12-19 13:51:24 CST; 18min ago
Docs: https://docs.docker.com
Main PID: 11579 (dockerd)
Tasks: 8
Memory: 136.4M
CGroup: /system.slice/docker.service
3.2 检查Docker版本
检查Docker版本
[root@jeven ~]# docker -v
Docker version 20.10.17, build 100c701
3.3 检查docker compose 版本
检查Docker compose版本，确保2.0以上版本。
[[root@jeven ~]# docker compose version
Docker Compose version v2.19.1
四、下载miniboard镜像
从docker hub拉取miniboard镜像
[root@jeven ~]# docker pull aceberg/miniboard
Using default tag: latest
latest: Pulling from aceberg/miniboard
c926b61bad3b: Already exists
e4a1524e1610: Pull complete
6db695a80bb5: Pull complete
15bfa03d27b5: Pull complete
Digest: sha256:b9ba93c61148b2e4232870fcf5fca5fa6c3046e20f5d8ec327f7b5cbafdcbd57
Status: Downloaded newer image for aceberg/miniboard:latest
docker.io/aceberg/miniboard:latest
五、部署miniboard
5.1 使用docker-cli部署miniboard
可以使用docker-cli方式快速部署miniboard监控仪表盘，本次实践使用以下步骤的docker compose方式部署。
docker run -d --name miniboard \
-e "TZ=Asia/Shanghai" \
-v ~/.dockerdata/miniboard:/data/miniboard \
-v /var/run/docker.sock:/var/run/docker.sock \ # Only needed to create panel from Docker containers (On Edit panels page)
-p 8849:8849 \
aceberg/miniboard
5.2 创建挂载目录
创建挂载目录/dataminiboard
mkdir -p /data/miniboard/data && cd /data/miniboard
5.3 创建miniboard容器
编辑docker-compose.yaml文件，使用docker compose方式创建miniboard容器
version: '3'
services:
miniboard:
image: aceberg/miniboard
container_name: miniboard
restart: always
ports:
- 7985:8849
volumes:
- /data/miniboard/data:/data/miniboard
- /var/run/docker.sock:/var/run/docker.sock
environment:
- TZ=Asia/Shanghai
5.4 创建miniboard容器
执行以下命令，快速创建miniboard容器.
[root@jeven miniboard]# docker compose up -d
[+] Running 2/2
⠿ Network miniboard_default Created 0.0s
⠿ Container miniboard Started 1.5s
5.5 检查miniboard容器状态
检查miniboard容器状态，确保miniboard容器正常启动。
[root@jeven miniboard]# docker compose ps
NAME COMMAND SERVICE STATUS PORTS
miniboard "./miniboard" miniboard running 0.0.0.0:7985->8849/tcp, :::7985->8849/tcp
5.6 检查miniboard容器运行日志
检查miniboard容器运行日志，确保miniboard服务正常启动。可以看到在容器日志中，已经成功监听到容器内的miniboard服务端口8849。
[root@jeven miniboard]# docker compose logs
miniboard | 2023/12/19 14:54:46 INFO: starting web gui with config /data/miniboard/config.yaml
miniboard | 2023/12/19 14:54:46 INFO: writing new Board file to /data/miniboard/board.yaml
miniboard | 2023/12/19 14:54:46 ===================================
miniboard | 2023/12/19 14:54:46 Web GUI at http://0.0.0.0:8849
miniboard | 2023/12/19 14:54:46 ===================================
miniboard | 2023/12/19 14:54:46 ERROR: SQL logic error: no such table: records (1)
miniboard | 2023/12/19 14:54:46 ERROR: SQL logic error: no such table: records (1)
六、访问署miniboard轻量级监控仪表板
6.1 访问miniboard初始页
6.2 系统设置
在菜单栏，选择“Config”，进入系统设置页面，可以设置服务端口、主题等。
七、miniboard的基本使用
7.1 编辑面板信息
点击编辑面板选项，进入面板编辑页面。
在下方的“Create panel from Docker API”选项中，设置仪表盘名称，选择确认。
勾选扫描选项，设置扫描间隔时间为5分钟，保存确认。
查看Docker-API获取的容器列表
修改容器的IP访问地址为本机服务器IP地址，这里是192.168.3.166。也可以新增其余监控项，例如再新增一条监控宿主机httpd的web服务。
7.2 新增tab标签分组
在tab管理页面，编辑tab名称，选择刚创建的面板，点击保存即可。
7.3 查看仪表板首页
查看此时的仪表板首页，发现刚才添加的监控项已经成功监控。
八、总结
Miniboard是一款轻量级监控仪表板工具，部署简单、使用方便。通过使用Docker进行快速部署，可以有效地节省服务器资源。Miniboard具有简洁的界面，能够清晰地显示监控项的状态。不仅可以监控宿主机上运行的Docker容器的状态，还可以监控网站的运行状态。对于个人服务器来说，Miniboard是一款非常实用的工具。
