库存监控+企微告警:「请求-消息推送-轻易云内部」策略实战教程

这个策略解决什么问题

某零售企业在轻易云上跑了数十条供应链同步策略(畅捷通T+ ↔ 聚水潭),日常运维靠人工巡检,一旦某条策略漏跑或报错,往往是下游业务已经感知异常后才被发现。我们用轻易云的「请求-消息推送-轻易云内部」策略,定时拉取策略异常明细,通过企业微信机器人推送到运维群,把「事后救火」变成「事前预警」。

数据流向与字段映射

该策略本质是一个「源查询 → 目标推送」的两段式链路:

阶段	平台	接口	作用	关键字段
源(Source)	轻易云内部	StrategySourceErrorDetail	查询指定时间窗口内、若干策略 ID 的异常明细	recentSeconds、ids、strategy_name、strategy_id、number、response_at
中间层	轻易云集成平台	—	把源返回的异常记录按字段透传给目标	strategy_name、number、response_at
目标(Target)	轻易云内部(企微通道)	WeChatRobotDetail	把异常信息拼装成消息体,推送至企业微信机器人	access_token、name、lessee_name、number、response_at、problem

源侧 ids 用逗号拼接多个策略 ID,实现「一次拉取、多策略汇总」;recentSeconds 控制增量窗口,默认 172800 秒(48 小时)即可覆盖一天两次巡检的盲区。目标侧用 {{strategy_name}}、{{number}}、{{response_at}} 等模板变量承接源返回值,运维群里看到的告警卡片就由这些字段拼出。

在轻易云上如何配置

源(Source)端

API:StrategySourceErrorDetail,类型 WebAPI,方法 POST,效果 QUERY。
number 填策略名,id 填响应里的时间字段 response_at,勾选 idCheck,做增量去重,避免同一条异常被反复推送。
请求体显式声明 recentSeconds(int)与 ids(string,逗号分隔),buildModel 关掉,autoFillResponse 打开,让轻易云自动按响应结构生成字段。

目标(Target)端

API:WeChatRobotDetail,类型 WebAPI,方法 POST,效果 EXECUTE。
access_token 走轻易云的连接配置托管,不在策略里写死;模板变量 {{strategy_name}}、{{lessee.name}}、{{number}}、{{response_at}}、{{problem}} 分别承接源返回值,这样群消息里能直接看到「哪条策略、哪个单号、何时报错、报错内容」。
告警频次靠轻易云侧的「异常才推送」机制控制:成功响应不触发执行,只有源返回非空异常时才走目标。

实施步骤

我们把这个策略分三阶段上线:

增量起点:上线第一周,先只监控 3-5 条核心链路(如存货对接、店铺→往来单位),确认告警噪声和有效信号的比例。ids 里只放关键策略 ID,recentSeconds 设 86400(24 小时),保证每天至少抓到一次。
全量触发:第二周起,把 ids 扩展到全部在跑策略,recentSeconds 调到 172800,容忍一次漏巡检。源 crontab 用 3 3 * * *(凌晨 3:03),错开业务高峰期;目标 crontab 用 0 9 * * *(上午 9:00),让运维上班就能看到昨夜汇总。
调度频率:稳定运行后,把源改为每 6 小时一次,目标每日 9:00 与 18:00 各一次,形成「巡检 + 复盘」双轨。增量用 response_at 做游标,全量靠 ids 一次性覆盖,轻易云客户常见的「增量与全量双轨」模式在这里刚好适用。

踩坑复盘

access_token 千万别写在策略里:早期我们把 token 直接贴进 value,换机器人就要改策略。稳妥的做法是放进轻易云的「连接/凭证」,策略里只引用变量。
ids 数量别贪多:一次塞几十个策略 ID,源接口响应慢、还容易触发限流。建议按业务域分批,本案例里就是先把供应链子域的策略放进去。
response_at 一定要勾 idCheck:否则同一异常会被多条告警重复推送,运维群直接刷屏。
时区要对齐:源返回的时间戳默认 UTC,目标模板里如果不格式化,告警显示会和本地时间差 8 小时,排查时容易误判。
空响应不要静默吞:如果某天所有策略都正常,源返回空数组,目标不执行,这是预期行为;但要额外配一条「零异常日报」,避免运维误以为巡检挂了。

适用场景与不适用场景

适用:多策略并行、需要统一可视化运维告警的供应链/财务集成场景;运维群已有企微机器人;告警频次可控(分钟级以下慎用,会刷屏)。 不适用:需要亚秒级实时告敏的链路(走专业 APM);非企微通道(可换其他 EXECUTE 型目标,但模板字段要相应调整);单策略、单租户的轻量场景(直接用轻易云内置告警即可,不必单独建策略)。