一、miniboard介绍

1.1 miniboard简洁

• miniboard简介

miniboard是一款开源的、带有选项卡、正常运行时间监控和通知的轻量级仪表板。，可以通过GUI或yaml文件进行配置。

1.2 miniboard特点

• 提供实时监控和报警功能，及时发现和解决容器运行异常和网站服务故障；
• 支持自定义监控指标，可以根据业务需求设置特定的监控项；
• 采用轻量级的监控代理，减少对系统资源的占用；
• 支持多种部署方式，包括Docker部署和传统部署，提供灵活的选择；
• 提供可视化的仪表盘和报表，直观展示服务状态和性能指标；
• 提供友好的用户界面和操作流程，使新手也能轻松上手使用。

二、本地环境介绍

2.1 本地环境规划

本次实践为个人测试环境，操作系统版本为centos7.6。

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初始页

访问地址Lhttp://192.168.3.166:7985，将IP更换为自己服务器的IP地址，进入到miniboard初始页。如果外部客户端无法访问此页面，查看服务器是否关闭防火墙，如果是云服务器，则安全组需要放行对应的服务端口7985。如果在经常访问测试项目的浏览器上，可能会由于之前访问过相同的端口的服务造成访问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是一款非常实用的工具。