SuperAPI AI 工具集

scrapfly-alerting

通用与其它

查看项目

更新于 10-16 00:20

技能介绍

用途:为 Scrapfly 账户的项目指标设置基于阈值的告警,例如“抓取成功率低于 95% 持续 10 分钟时通知我”。可监控指定域名、项目或产品,也可查看、暂停、恢复和测试已有告警。

主要能力:指标覆盖成功率、封禁率、错误数、成本、延迟等;支持 gt、lt、gte、lte、eq、neq 比较符;可配置持续窗口(sustained_minutes,1–1440)、评估窗口、无数据策略、重复通知间隔和恢复窗口。通知渠道包括 email、webhook(带 HMAC-SHA256 签名)和 inapp。告警状态含 ok、pending、triggered、recovering、no_data、snoozed。

使用方式:三种调用路径共享同一后端与状态机。MCP 提供 monitoring_get_metrics、alert_metric_families、alert_preview、alert_create、alert_update、alert_delete、alert_snooze、alert_unsnooze、alert_test 等工具,写操作需 confirm=true。CLI 使用 scrapfly alert 子命令,如 scrapfly alert metric-families、scrapfly alert preview --metric scrape.success_rate --comparator lt --threshold 95 --sustained-minutes 10 --range-minutes 1440、scrapfly alert create --name "Scrape Success Rate Low" --metric scrape.success_rate --comparator lt --threshold 95 --sustained-minutes 10 --channel email:ops@example.com。REST 使用 POST /alert?key=scp-live-... 等端点。

推荐流程:先获取账户基线,再列出合法 metric_id,然后用 alert_preview 对历史数据回放验证阈值,最后两步创建(先 dry-run 再 confirm)。

限制:需要 Enterprise 计划和有效 API 密钥(scp-live-...)。不要臆造阈值或 metric_id;project_uuid 不能填 account_id,否则报 ERR::ALERT::PROJECT_NOT_FOUND。常见错误还包括 UNKNOWN_METRIC、INVALID_DIMENSIONS、INVALID_THRESHOLD、INVALID_SUSTAINED_WINDOW、CHANNEL_UNREACHABLE、EVAL_TIMEOUT 等。具体价格与更多细节暂未提供。