Salta ai contenuti
DumbMonit

常见问题

Questi contenuti non sono ancora disponibili nella tua lingua.

我忘记了密码

Section titled “我忘记了密码”

先问一下另一位管理员:在设置 → 用户中,对你的账户点击 编辑可以设置一个新密码并显示一次,同一行的重置两步验证 可以清除让你被锁在外面的第二因素。这是最常见的解决办法——一个 有两个管理员账户的实例永远不需要用到本页其余的内容。

当没有任何人能够登录,又没有恢复邮箱时:在 docker-compose.yml 中用 DUMBMONIT_RESET_PASSWORD=1 启动一次服务器:

    environment:
      DUMBMONIT_RESET_PASSWORD: "1"

然后执行 docker compose up -d。

启动时会移除每一个账户和每一个会话,界面会再次显示 /setup。 创建第一个管理员,然后删除该行后再次执行 docker compose up -d。监控项、规则、渠道和单点登录设置不受影响。

添加监控项后没有数据

Section titled “添加监控项后没有数据”

请等待一分钟:首次探测会按监控项的间隔运行(默认 60 秒),写入 每 5 秒(DUMBMONIT_FLUSH_INTERVAL_SECS)到达 VictoriaMetrics。 然后:

  1. 打开监控项页面并点击立即探测。它会报告一次探测产生了多少 样本和序列,或给出确切的错误。
  2. 地址下方显示配置错误并附带错误信息,属于配置问题:错误的 社区名或密码、被拒绝的证书(启用”接受无法验证的证书”)、 缺失的能力。这会被显示出来,但不会触发告警。
  3. 显示不可达且没有错误信息,意味着监控项完全没有应答。对于 SNMP,错误的社区名看起来与监控项关机完全一样,因为监控项根本 不会对此作出应答。请检查社区名、SNMP 是否已启用,以及监控项 是否允许服务器的地址访问。
  4. 检查容器能否访问该监控项:Docker 网络和防火墙通常是常见原因。

Ping 显示”配置错误”

Section titled “Ping 显示”配置错误””

Ping 监控需要一个 ICMP echo 套接字。容器在没有任何 capability 的情况下运行,因此 Compose 文件通过 dumbmonit 服务下的 net.ipv4.ping_group_range sysctl 允许这类套接字:请确认 sysctls: 这几行仍然存在,然后执行 docker compose up -d。 参见无需 capability 的 ICMP ping。

代理没有出现

Section titled “代理没有出现”
  • 安装程序会在启动服务之前先做一次测试推送,如果 URL 或令牌 有误,会给出明确的错误并停止。请修正 /etc/dumbmonit/agent.yaml 并重启 dumbmonit-agent。
  • 安装命令中的 URL 是你浏览器用来访问界面的那个地址。从被监控的 机器上,这个 URL 必须能够访问到服务器:在那台机器上执行 curl https://server:8080/api/health 就能说明问题。
  • 在反向代理之后,必须转发 /api/ingest,并允许最多 16 MB 的 请求体(nginx 中的 client_max_body_size 16m)。
  • journalctl -u dumbmonit-agent -f 会显示每一次被拒绝的推送。 令牌本身永远不会出现在日志中。
  • 一个被撤销的令牌会在下一次推送时使代理停止;请使用新令牌 重新运行安装程序。

参见Linux、macOS、FreeBSD 和 Windows 代理。

更改端口

Section titled “更改端口”

容器监听在 8080 上;主机端口是 docker-compose.yml 中映射的左侧。 修改它,然后执行 docker compose up -d:

    ports:
      - "8099:8080"

若要更改容器内部的端口,请设置 DUMBMONIT_BIND,例如 0.0.0.0:9000,并相应调整端口映射。

为什么规则写的是”warning”,告警却显示”Advisory”?

Section titled “为什么规则写的是”warning”,告警却显示”Advisory”?”

API 存储三种严重级别:info、warning、critical。界面用天气 简报的词汇来显示它们:Info(信息)、Advisory(提示)、 Warning(警告)。参见严重级别。

某条告警显示”Suppressed by parent”

Section titled “某条告警显示”Suppressed by parent””

该监控项有一个宕机(不可达,或其可用性检查失败)的父监控项,因此它自己的告警会被暂留而不发送。 修复父监控项之后,子监控项的告警会自行解决或触发,不会产生第二次 通知。参见依赖抑制。

“Unusual CPU” 从不触发

Section titled ““Unusual CPU” 从不触发”

这是一条季节性基线规则,对每个序列的最初 14 天都保持静默。在 这期间,它只会显示本来会触发的内容。参见 基线学习。

我能使用自己的 VictoriaMetrics 吗?

Section titled “我能使用自己的 VictoriaMetrics 吗?”

可以:将 DUMBMONIT_VM_URL 设置为其地址(http://host:8428), 内嵌的 VictoriaMetrics 就不会启动。每个指标都带有 dumbmonit_ 前缀,因此它可以与其他工具共享同一个实例。切换完成后, GET /api/health 会报告 victoria.embedded: false。

DumbMonit 需要能从互联网访问吗?

Section titled “DumbMonit 需要能从互联网访问吗?”

不需要。它会主动连接监控项和通知服务;除了代理之外没有任何东西 会回调它,而代理只需要能访问服务器的 URL。请把它保留在你的 局域网内或 VPN 之后;如果要公开它,请使用带有 TLS 的反向代理, 并设置 DUMBMONIT_COOKIE_SECURE=1。

有 API 令牌吗?

Section titled “有 API 令牌吗?”

有。设置 → API 与助手可以创建带有 read 或 write 范围的 dmt_… 令牌;在任何路由上以 Authorization: Bearer dmt_… 发送 即可,不需要 cookie 或 CSRF 请求头。同一个令牌也能通过 MCP 连接 一个助手。令牌永远不能管理账户、登录设置 或其他令牌。参见HTTP API 参考。