Aller au contenu
DumbMonit

架构

Ce contenu n’est pas encore disponible dans votre langue.

DumbMonit 以单个容器的形式发布。容器内有一个 Rust 进程,负责提供 Web 界面和 API, 另有一个子进程(VictoriaMetrics),由该 Rust 进程启动并监管。配置和状态保存在 SQLite 中。

组件

Section titled “组件”
组件位置作用
服务器crates/server唯一的 Rust 二进制文件:HTTP API(axum)、身份验证、调度器、告警引擎、通知渠道、报告。
Web 界面web/SvelteKit 单页应用(Svelte 5、Tailwind 4、uPlot)。构建为静态文件,并通过 rust_embed 嵌入服务器二进制文件。
时间序列crates/server/src/tsdb/VictoriaMetrics 的批量写入器和查询代理。embedded.rs 启动并监管内置的 VictoriaMetrics 子进程(数据位于 /data/vm);也可以让 DUMBMONIT_VM_URL 指向外部实例。
配置和状态crates/server/src/db/带编号迁移的 SQLite:监控项、凭据、用户、规则、告警状态、静默、渠道。
采集器crates/collectors、crates/server/src/collectors/每种监控项或服务对应一个 Collector trait 的实现,并注册到 Registry 中。调度器只认识这个 trait。
共享类型crates/protoSample、Target、Credential、Collector trait 和 ProbeError,以及代理协议。
代理crates/agent推送主机指标的 Linux、macOS、FreeBSD 和 Windows 代理;它还可以充当中继,为远程站点运行采集器。
告警crates/server/src/alerting/规则、告警状态机、按父监控项抑制、静默、学习得到的基线。
通知crates/server/src/notify/渠道(聊天、推送、值班、电子邮件、webhook),由 catalog.rs 向界面描述。
密钥crates/server/src/crypto.rs使用 AES-256-GCM 加密存放在 SQLite 中的凭据和令牌;密钥来自 /data/secret.key 或 DUMBMONIT_SECRET。

数据流

Section titled “数据流”
 devices / services ──(SNMP, HTTP APIs, probes)──► collectors ┐
                                                              │ samples
 agents ──(push, per-machine token)──► /api/ingest ───────────┤
 relay agent (collectors run at a remote site) ───────────────┤
                                                              ▼
                                           tsdb writer (batched) ──► VictoriaMetrics
                                                                           │
 browser / scripts / assistants ◄─ /api/* ◄─ query proxy ◄─────────────────┘
                                   │
                                   └─► alerting engine ──► notify channels


 SQLite (config, users, alert state, silences) is read and written by the
 API, the scheduler and the alerting engine.
  1. 调度器按各自的间隔,通过采集器注册表运行每个已启用的监控项。代理和中继使用 每台机器独立的令牌,将测量数据推送到 /api/ingest。
  2. 采集器返回名为 dumbmonit_<kind>_*、带有 target 标签(监控项 id)的样本。 写入器将它们批量写入 VictoriaMetrics。
  3. 告警引擎根据已存储的序列评估规则。phase 是引擎的状态;effective_phase 是用户看到的状态(父监控项宕机时为 suppressed)。无法访问的监控项会触发告警; 配置错误会显示出来,但不会发送通知。
  4. 通知通过通知策略中配置的渠道发出。
  5. 界面和任何脚本都通过 /api/* 读取所有内容;API 没有私有的另一半。

扩展点

Section titled “扩展点”
  • 新增一种监控项,就是一个 Collector 实现加一次 Registry::register 调用。 界面表单由 GET /api/collectors 生成。
  • 新增通知渠道,就是一个发送器加上 notify/catalog.rs 中的一个条目;界面根据 GET /api/notify/kinds 渲染表单。
  • 只需要配置文件的 SNMP 设备无需编写 Rust:在 profiles/ 下放一个 YAML 文件即可。

构建说明请参阅开发,信任边界请参阅安全模型。