十年匠心定制 · 商业建站与技术教学双线并行 咨询热线:400-886-1026 service@lmnt.cn
ARTICLE DETAIL

资讯详情

深耕网站建设与运营推广的一线实战洞察。

VeighNa Elite Trader 钉钉实时通知功能配置指南:Webhook 机器人接入与策略日志推送

VeighNa Elite Trader 钉钉实时通知功能配置指南:Webhook 机器人接入与策略日志推送 VeighNa Elite Trader 钉钉实时通知功能配置指南Webhook 机器人接入与策略日志推送【免费下载链接】vnpy基于Python的开源量化交易平台开发框架项目地址: https://gitcode.com/vnpy/vnpy导读本文基于 VeighNa 开源量化交易平台的官方文档系统讲解 VeighNa Elite Trader 的钉钉实时通知功能从钉钉自定义机器人Webhook 接入的创建、Token 与密钥获取到全局配置窗口中【钉钉】三项参数的填写最终实现程序运行过程中核心系统日志、CTA 策略模块日志、组合策略模块日志以及期权策略模块日志实时推送到指定钉钉群聊。读完本文你将掌握一套完整、可复现的移动端消息告警方案在无法盯盘时也能第一时间掌握策略运行与系统状态。该功能对应官方文档 docs/elite/extension/elite_dingtalk.md属于 VeighNa Elite 智能交易扩展能力的一部分其姊妹篇飞书通知可参考 docs/elite/extension/elite_feishu.md。功能概述VeighNa Elite Trader 在全局配置窗口中提供了钉钉消息通知功能。用户只需完成两步配置钉钉侧创建机器人、VeighNa Elite Trader 侧填写参数即可在钉钉会话中实时收到以下四类日志消息核心系统日志程序启动、接口连接、引擎运行等关键事件CTA 策略模块日志策略初始化、启动、停止、委托与成交等组合策略模块日志Portfolio Strategy 相关运行信息期权策略模块日志Option Strategy 相关运行信息。该功能的定位是“实时告警通道”策略在无人值守时段产生的重要日志不再只停留在本机日志组件与文件中而是被推送至移动端钉钉群聊方便用户随时随地掌握运行状态。官方文档说明见 docs/elite/info/elite_trader.md其中明确指出钉钉通知启动后程序运行过程中的核心系统日志、CTA 策略模块日志等均会发送到 Token 对应的钉钉会话中。钉钉侧配置创建 Webhook 自定义机器人钉钉实时通知基于钉钉群的【自定义机器人】通过 Webhook 接入自定义服务实现。请在手机端或桌面端钉钉中按以下步骤操作创建群聊启动钉钉创建一个群聊也可以复用已有的群聊但建议使用专门用于接收交易通知的群避免消息混杂。进入群设置点击群聊右上角的设置图标。找到机器人入口在弹出的群设置界面下滑点击【机器人】设置。添加自定义机器人在弹出的界面中点击【添加机器人】然后在机器人选项中选择【自定义】通过 Webhook 接入自定义服务机器人。填写机器人信息在弹出的添加机器人窗口中输入自定义的机器人名字并选择要发送消息的群。勾选【加签】并复制密钥务必勾选【加签】选项即安全设置中的“加签”此时可点击【复制】按钮复制出密钥Secret妥善保存。完成创建点击【完成】按钮即可成功添加机器人配置。添加完成后钉钉会弹出设置 Webhook 的窗口其中 Webhook 地址形如https://oapi.dingtalk.com/robot/send?access_tokenxxxxxxxxxxxxxxxx请复制access_token之后的一串 Token 内容这是 VeighNa Elite Trader 侧【Token】参数需要填写的值。注意若创建时忘记复制密钥和 Token无需重新创建机器人。可点击群聊右上角的设置图标选择【机器人】在“本群的机器人”部分选中已添加的机器人在弹出的【配置】窗口中即可重新找到密钥和 Token 信息。VeighNa Elite Trader 侧配置全局配置窗口启动 VeighNa Elite Trader 并完成登录后点击菜单栏上的【配置】按钮弹出【全局配置】窗口在其中的【钉钉】部分进行配置参数填写内容说明启动选择【是】控制是否运行钉钉消息通知功能设为【是】True后运行过程中的核心系统日志、CTA 策略模块日志等均会发送到 Token 对应的钉钉会话Token填入钉钉设置 Webhook 窗口时复制的 Token 内容对应钉钉软件中某一具体聊天会话的令牌需在钉钉会话中添加【自定义机器人】基于 Webhook 接入自定义服务后在弹出的对话框中获取密钥填入钉钉添加机器人勾选【加签】选项时复制的密钥用于对发送到钉钉的消息进行加密签名同样需要在添加机器人时弹出的对话框中获取三个参数缺一不可若未勾选【加签】或密钥填写错误钉钉服务端将因签名校验失败而拒绝消息若 Token 错误或缺失消息将无法路由到正确的群聊。需要说明的是该全局配置在开源社区版 VeighNa Trader 中对应的配置文件为 vnpy/trader/setting.py其中记录了log.active、log.level、log.console、log.file等日志相关默认参数。钉钉通知作为 VeighNa Elite 的扩展能力其“启动/Token/密钥”三项参数在 Elite Trader 的全局配置界面中填写并由程序持久化到本地配置。务必保证【日志】配置中的“启动”保持开启——若日志引擎被关闭log.active设为 False钉钉通知将失去消息来源。接收消息哪些日志会被推送VeighNa Elite Trader 与钉钉均配置完毕后程序运行过程中以“$”结尾即过滤普通日志后的关键日志的日志消息就会被推送到配置 Token 对应的钉钉群聊会话中。这里有两个关键约定需要理解“$”后缀约定只有消息文本以“$”字符结尾的日志才属于需要实时推送的核心日志。普通日志如常规的行情处理、调试信息不会触发推送从而避免钉钉群被无关消息刷屏。这一约定是 Elite 扩展在日志引擎之上实现的过滤机制。日志级别过滤VeighNa 底层日志引擎会按级别过滤日志。从源码结构看日志级别体系定义于 vnpy/trader/object.py 的LogData数据对象包含msg与level字段级别默认INFO级别阈值由全局设置中的“日志级别”控制DEBUG/INFO/WARNING/ERROR/CRITICAL 五级对应 10/20/30/40/50。日志级别低于阈值设置时会被忽略因此若希望更完整地接收通知可将日志级别适当调低如设为 DEBUG 对应的 10。推送成功的典型形态是钉钉群聊中不断出现来自机器人的卡片或文本消息内容为策略/系统关键日志每条消息对应程序运行过程中的一次重要事件方便用户在手机上实时跟踪。常见问题排查收不到任何钉钉消息依次检查 ①【钉钉】启动是否为【是】② Token 是否与 Webhook 地址中access_token后内容完全一致③ 密钥是否与创建机器人时复制的加签密钥一致④ 程序是否产生了以“$”结尾的核心日志若长时间无关键事件可能本身就没有消息产生。消息被钉钉拒收多为加签密钥错误或未勾选【加签】请回到机器人【配置】窗口核对密钥并确认创建时确实勾选了【加签】选项。只收到部分模块日志钉钉推送范围覆盖核心系统日志、CTA 策略模块日志、组合策略模块日志与期权策略模块日志未加载对应策略应用模块时自然不会有相应模块的日志产生。希望同时使用飞书通知VeighNa Elite 同样提供飞书实时通知【飞书】配置部分参数为启动/URL/密钥配置方式与钉钉类似可参考 docs/elite/extension/elite_feishu.md。总结钉钉实时通知是 VeighNa Elite Trader 提供给用户的轻量级消息告警方案钉钉侧只需创建一个勾选【加签】的自定义 Webhook 机器人并保存 Token 与密钥程序侧只需在全局配置的【钉钉】部分填写启动/Token/密钥三项参数即可让核心系统日志与三大策略模块的关键日志以“$”结尾的消息实时直达手机钉钉群聊。该功能与 docs/elite/info/elite_trader.md 中描述的全局配置体系一脉相承是搭建无人值守量化交易环境时性价比极高的补充环节。【免费下载链接】vnpy基于Python的开源量化交易平台开发框架项目地址: https://gitcode.com/vnpy/vnpy创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表