本指南涵盖的内容
WatchZit 是一个免费、开源(AGPLv3)的网络和服务器监控系统:检查、保存多年历史的图表、触发器和通知、仪表板和报告,以及实时网络地图,全部集中在您自己服务器上的一个 Web 控制台中。本指南不逐项比较这两款产品,而是说明 WatchZit 开箱即用能做什么、哪些地方仍需您自行设置,以及它的限制在哪里。
您需要什么
- VMware、Proxmox VE 或 Hyper-V 上的一台虚拟机,2 个 CPU、2 GB 内存和 16 GB 磁盘——或一台带 PostgreSQL 13+ 的 64 位 Debian 12+、Ubuntu 22.04+、AlmaLinux 或 Rocky Linux 9+ 服务器。
- 对您想详细查看的路由器、交换机、打印机和 UPS 的 SNMP 读取权限(v2c community 或 v3 用户)。
- 对于服务器:要么有权安装小巧的 WatchZit 代理,要么有一个用于 SSH(Linux)或 WinRM(Windows)的用户。
安装并登录
从下载页面导入现成的虚拟设备——VMware 用 OVA,Proxmox VE 和 KVM 用 qcow2,Hyper-V(第 1 代)用 VHDX,或使用 ISO——或在您自己的 Linux 服务器上运行安装脚本:
curl -fsSL https://github.com/Max-Zit/watchzit/releases/latest/download/install.sh | sudo sh
脚本会安装 PostgreSQL、检查发布版本的签名、创建数据库,并打印控制台地址和设置令牌。打开 https://<server>:8443,输入设置令牌,创建第一个管理员,并用身份验证器应用设置双因素登录。默认情况下,控制台只响应私有网络。
找到设备
先在 设置 → SNMP 下创建一个 SNMP 配置文件(v2c 使用 community,或 v3 使用 SHA-2 和 AES)。然后进入 设备 → 发现,添加一个范围,例如 10.0.0.0/24(最大 /22)。WatchZit 会 ping 每个地址、尝试常用端口、用您的配置文件通过 SNMP 询问名称、描述和厂商,并查询 DNS 名称。勾选您需要的主机并点击 添加为设备:每台主机都会获得一个 ping 检查(ping 被屏蔽时为 TCP 检查)以及有响应的 SNMP 配置文件。
可以立即扫描,也可以每天或每周扫描。设置计划后,网络中新出现的主机会自动显示在列表中。
SNMP 自动读取的内容
当设备有 SNMP 配置文件时,SNMP 发现会列出它找到的内容;勾选要监视的项目即可。回环接口和没有链路的接口会被排除。返回的内容取决于设备类型:
- 交换机和路由器:带链路状态和流量的接口、CPU、内存和存储;每小时读取一次的 VLAN 及其带标记和不带标记的端口;VRRP 角色(主或备)。
- 打印机:墨粉、墨水、硒鼓和废粉盒,以百分比表示余量。
- UPS(UPS-MIB 或 APC PowerNet MIB):电池电量、剩余续航时间和负载。
- MikroTik:温度、电压、风扇和功率,各带其单位。
- 其他任何内容:任意数值 OID,作为单独的检查。
每个值都会被保存并绘制成图表:默认原始值保存 30 天,5 分钟值保存 90 天,每小时值保存两年(设置 → 测量数据)。
已经存在的触发器
新的控制台在 问题 → 触发器 下已经有监视所有设备的触发器:
| 触发器 | 何时触发 |
|---|---|
| 设备宕机 | 设备的所有检查失败持续 1 分钟(严重) |
| 检查失败 | 某个检查失败持续 1 分钟 |
| CPU 负载过高、内存将满 | 高于 90 % 持续 5 分钟 |
| 磁盘将满、磁盘已满 | 高于 90 % 和 97 % |
| 两周内磁盘将满 | 代理磁盘最近一周的趋势在 14 天内达到 98 % |
| 丢包率 | 高于 20 % 持续 5 分钟 |
| 证书快要过期、证书即将过期 | 少于 21 天,以及少于 7 天(严重) |
对于 SNMP 发现找到的内容,也有现成的触发器:打印机的 墨粉或墨水不足(低于 10 %)和 UPS 的 UPS 续航不足(低于 10 分钟)。您只需说明问题发送到哪里:在 设置 → 通知 下设置电子邮件、Slack、Microsoft Teams、Discord、Telegram、ntfy、PagerDuty、短信或签名的 webhook。
为减少干扰,请在设备上设置 依赖于——或打开一张地图,点击 依赖,然后点击 设置勾选的依赖,它会沿着线缆从路由器开始推导。当某个站点的路由器宕机时,您只会收到路由器的一个问题;它后面的设备只是不可达。维护窗口和确认处理其余情况。
无需猜测的阈值
固定阈值对磁盘来说很容易,但对流量、响应时间或连接数就很难——它们在周一早上很高,在周日晚上很低。WatchZit 为此提供两种触发器:
- 数值在该时段异常(自动学习) 不需要阈值。它从最近四周学习某个值在一周中每个小时的通常水平,当值偏离较远时——更高、更低或两者皆可——就会打开问题。灵敏度 决定偏离多远才算。它在有一周历史后开始比较,问题会给出该小时的通常值和正常范围。
- 数值将达到阈值(预测) 通过某个值最近一周的数据画一条直线,当这条线在您设定的天数内达到阈值时打开问题——例如十天后将满的磁盘、持续上升的温度。问题会给出当前值、每天的变化速度以及到达阈值的日期。
没有新数据 触发器会捕获停止提供值的检查,例如停止上报的代理或不再响应 SNMP 的设备。
服务器:使用代理或不使用代理
适用于 Windows(MSI)和 Linux(deb、rpm;x86-64 和 arm64)的 WatchZit 代理会上报 CPU、内存、每块磁盘、接口、您选择的服务、监视的进程、Hyper-V 虚拟机和 Docker 容器,并把 Windows 事件日志和 systemd 日志中的错误发送到 日志。它只建立一个到 8444 端口的出站连接,使用 代理 页面中的一次性代码(WZ1-…)注册,并从控制台自动更新。它的值会自动获得图表和内置触发器。
在不允许安装任何东西的地方,添加检查 通过 SSH 的 Linux(无代理) 或 通过 WinRM 的 Windows(无代理)。它们读取 CPU、内存、交换空间或页面文件、最满的磁盘和运行时间,值的名称与代理相同,因此同样的触发器和预测都能使用。指南通过 SSH 和 WinRM 无代理监控 Linux 和 Windows 服务器逐步说明了设置方法。
自动绘制的地图
WatchZit 每 15 分钟从设备读取各设备的连接位置:LLDP、CDP 和 MikroTik 邻居表、交换机的 MAC 地址表、端口描述以及保存的配置。在 地图 下添加一张地图,点击 编辑,放上几台设备并打开 建议的链路:它会列出线缆及其两端的端口。全部添加 会全部采用。打开 自动绘制 和 同时添加它们连接到的设备,地图就会不断添加新的链路及其后面的设备。自动排列 按线缆布局地图;保存 保留它。
在地图上,设备按状态着色,线缆按流量着色,并带有约 3,500 种真实设备型号的图片。对于墙面屏幕,设置 → 展示屏 会通过秘密链接全屏显示地图。指南MikroTik The Dude 的现代替代方案详细介绍了地图。
需要时再用模板
WatchZit 没有内置模板,对于基础监控也不需要它们:SNMP 发现和代理会自己找到接口、磁盘、CPU 和内存,内置触发器适用于所有设备。模板用于您自己的标准——例如在每台 Web 服务器上使用相同的网页、证书和 TCP 检查:
- 在 模板 下创建模板,选择它适用的设备类型,并添加其检查(ping、TCP、网页、TLS 证书、DNS 和 SNMP 检查)。
- 使用 应用到 将其应用到该类型的所有设备或某个组,或在某个设备页面上使用 应用模板。应用只会添加设备尚未有的检查,因此应用两次也没有害处。
- 勾选 自动应用到这些类型的新设备,之后手动或通过发现添加的设备会立即获得这些检查。
要一次处理多台设备,请筛选设备列表、勾选设备,并使用 更改所选: 设置组、SNMP 配置文件、依赖或模板。
仪表板、数据源、报告和 API
- 仪表板 显示图表、当前值、设备状态、未解决的问题和地图磁贴,每分钟刷新一次,适合墙面屏幕。
- 数据源(设置 → 数据源)把来自 PostgreSQL、MySQL/MariaDB、Microsoft SQL Server、Prometheus、InfluxDB 或 JSON 服务的时间序列带到图表和仪表板上,与 WatchZit 自己的值并列显示。
- 报告 显示每台设备在 7、30 或 90 天或一个月内的可用性,并支持按组设置 SLA 目标;可以每周或每月附带 CSV 通过电子邮件发送。
- Syslog 和 SNMP trap(设置 → Syslog 和 trap)以及 流量流(NetFlow v5/v9、IPFIX、sFlow)由同一台服务器接收。
- 带令牌的 REST API 可读取设备、检查、图表和问题,确认问题并计划维护。
WatchZit 不做什么
- 没有从其他监控系统导入的工具:设备来自发现、代理或手动添加,历史数据从您添加它们的那天开始。
- 没有内置模板。模板包含 ping、TCP、网页、证书、DNS 和 SNMP 检查;需要密码的检查按设备逐个添加。
- 没有运行您自己脚本的检查。您自己的值来自 SNMP OID、针对您自己服务的 JSON API 值 检查,或图表上的数据源。
- 自动学习的触发器需要历史数据:它们在一周后才开始比较,预测至少需要某个值六小时的数据。
- 无代理检查只涵盖基础内容(CPU、内存、交换空间或页面文件、最满的磁盘、运行时间)。每块磁盘、接口、服务、进程和日志都需要代理。
- 文档中的 API 用于读取数据、确认问题和计划维护;设备、检查和触发器在控制台中设置。
- 服务器运行在 Linux(x86-64)和 PostgreSQL 上,或作为虚拟设备运行。
在现有监控旁边运行 WatchZit
您不必在一天之内切换。WatchZit 运行在自己的虚拟机上,不会更改它所监视的设备上的任何内容,因此两套系统可以并行运行几周:
- 在单独的虚拟机上安装 WatchZit,并为它分配自己的只读 SNMP community 或 v3 用户,这样您可以区分它的查询,以后也能撤销它的访问权限。
- 从一个站点或一个组开始:发现它、设置依赖,并先把 WatchZit 的问题发送到测试渠道,而不是值班团队。
- 在服务器上与现有软件并行安装 WatchZit 代理,或使用无代理检查;代理只需要到 8444 端口的出站连接。
- 如果您的设备可以把 syslog、SNMP trap 或流量流发送到第二个目的地,请把 WatchZit 添加为其中之一(默认 UDP 514、162、2055 和 6343),而不是迁移过去。
- 用几周时间比较每个系统提出了哪些问题、哪些问题真正重要,然后再做决定。
下一步做什么
- 在功能页面查看 WatchZit 的全部功能,并在下载页面获取它。
- 无代理监视服务器:通过 SSH 和 WinRM 无代理监控 Linux 和 Windows 服务器。
- 监控 NAT 后面的站点:使用远程采集器监控分支机构。
- 完整参考是内置在控制台中的用户指南;请参见文档。
欢迎在 GitHub Discussions 提出问题和想法。企业可以从 MaxZit 获得商业支持(仅提供英文服务)。
Zabbix 是其所有者的商标。MaxZit 与 Zabbix 的所有者没有关联,也未获得其赞助或认可;此名称仅用于说明本指南的主题。