DiscordChatExporter + Prometheus Prometheus+ Grafana Grafana + TOML config+ Updo+ Slack

监控数据导出 Prometheus 并接入 Grafana 仪表盘与 webhook 告警

✓ 支持长期指标存储✓ 告警自动识别格式化 ✕ 需自行搭建 Prometheus/Gra✕ 告警渠道限于 webhook 形式

方案简介

这套配方利用 Updo 的输出与告警能力,把网站可用性监控数据接入可观测性生态:运行时可以选择交互式 TUI、纯文本或 JSON 结构化日志,并可导出到 Prometheus,从而在 Grafana 中构建仪表盘并实现指标的长期存储;同时 Updo 支持桌面通知与 webhook 告警,Slack 与 Discord 会被自动检测并格式化。适合已经在使用 Prometheus/Grafana 技术栈、希望把命令行级站点监控沉淀为长期指标与团队告警的运维场景。

组成与分工

  • Updo:监控数据与告警的生产者,提供 TUI/JSON/Prometheus 输出与 webhook 推送
  • Prometheus:接收 Updo 导出的指标,负责长期存储
  • Grafana:基于 Prometheus 数据构建仪表盘展示
  • Slack:webhook 告警接收渠道之一,消息自动格式化
  • Discord:webhook 告警接收渠道之一,消息自动格式化
  • TOML 配置文件:复杂多目标场景下统一声明 webhook 等全局设置

前置要求

安装 Updo:

brew install owloops/tap/updo

其他安装方式包括安装脚本、AUR、Nix、Docker 与 go install(需 Go 1.27+)。使用 Prometheus/Grafana 仪表盘需自备这两套服务;webhook 告警需要目标服务的 webhook URL,例如 Slack 的 incoming webhook。

实施步骤

1. 安装并跑通基础监控

updo monitor https://example.com

2. 选择输出形态

交互式 TUI 为默认;需要留存日志时使用 JSON 结构化输出并重定向:

updo monitor --log --count 10 https://example.com > output.json

或使用纯文本简单模式:

updo monitor --simple --count 10 https://example.com

3. 接入 webhook 告警

直接传入 Slack webhook URL:

updo monitor --webhook-url "https://hooks.slack.com/services/YOUR/WEBHOOK" https://example.com

4. 多目标场景用 TOML 配置

在配置文件 global 段统一设置 webhook:

[global]
refresh_interval = 5
timeout = 10
webhook_url = "https://hooks.slack.com/services/YOUR/WEBHOOK"
only = ["Google", "API"]

然后运行:

updo monitor --config example-config.toml

5. 接入 Prometheus 与 Grafana

启用 Prometheus 导出后,将指标接入你的 Prometheus 抓取配置,再在 Grafana 中创建仪表盘实现长期存储与可视化。

使用与配置要点

日常使用要点:

  • --log:开启 JSON 结构化日志,配合 > output.json 留档
  • --simple:脚本化/无终端场景用纯文本输出
  • --webhook-url / --webhook-header:配置告警接收端与自定义请求头
  • Slack 与 Discord 的 webhook 会被自动检测并格式化,无需额外模板配置
  • --only, --skip:在多目标配置下过滤要监控的目标

验证成功:Slack/Discord 频道收到格式化的告警消息,Grafana 仪表盘出现 Updo 指标,即说明链路打通。

注意事项与常见问题

  • CLI 标志方式下 webhook URL 等设置对全部目标全局生效;要按目标区分配置必须使用 TOML 文件
  • README 完整内容在 GitHub 仓库,配置文件部分展示为示例(example-config.toml),实际字段以仓库为准
  • Prometheus 导出的具体抓取配置细节 README 未展开,需要参考仓库完整文档

优缺点

  • ✓ 支持长期指标存储
  • ✓ 告警自动识别格式化
  • ✕ 需自行搭建 Prometheus/Gra
  • ✕ 告警渠道限于 webhook 形式

出处

本方案挖掘自开源项目 Owloops/updo,方案内容与实施命令均来自其 README 原文。

方案出处
Owloops/updo:Uptime monitoring CLI tool with alerting and advanced settings
1150 star Uptime monitoring CLI tool with alerting and advanced settings

本方案由真实开源项目挖掘整理,实施命令均来自其 README 原文,安装使用请遵循项目开源协议。