Skip to Content
金蝶与旺店通协同方案监控与日志看板

概述

监控看板为运维和管理人员提供系统运行的全局视角,涵盖实时仪表盘、同步日志查询、异常告警和操作审计四大模块。所有数据基于同步引擎的推送记录自动生成,无需手动维护。


仪表盘概览

仪表盘是管理后台的首页,提供系统运行状态的实时概览。

核心指标卡片

仪表盘顶部展示 4 个核心指标卡片:

指标数据来源说明
今日同步总量当日同步日志显示成功 / 失败 / 跳过的数量,点击可跳转到日志详情
24 小时成功率最近 24 小时日志折线图展示每小时的成功率趋势,低于 95% 时标红告警
待重试任务状态为 pending_retry 的记录点击跳转到待重试队列,可手动触发重试
最近异常时间最新一条失败日志显示距今多久发生异常,超过 1 小时无异常则显示「运行正常」

仪表盘布局

Rendering diagram…

仪表盘数据每 30 秒自动刷新,无需手动刷新页面。所有数值均为实时计算。


同步日志查看器

日志字段

每条同步日志包含以下字段:

字段说明示例
源系统单据来源kingdee / wdt
源单号源系统中的单据编号STK000001234
业务类型同步的业务流类型transfer_out / sales_order / refund
目标系统推送目标wdt / kingdee
目标组织推送到的组织编码org_b
目标单号目标系统生成的单号WDT20260612001
推送状态当前处理状态success / failed / pending_retry / skipped
错误信息失败原因金蝶 API 返回: 凭证已过期
重试次数已重试次数05
创建时间首次推送时间2026-06-12 14:30:22
更新时间最后一次状态变更时间2026-06-12 14:30:25

筛选器

日志查看器支持多维度筛选:

筛选维度类型说明
业务类型下拉选择调拨推送 / 销售回传 / 退款回传 / 路由拆分 / 采购汇总
推送状态下拉选择全部 / 成功 / 失败 / 待重试 / 跳过
目标组织下拉选择按已有组织筛选
日期范围日期选择器起止日期,默认最近 7 天
源单号搜索文本输入支持模糊搜索

日志详情

点击日志条目可展开详情面板:

  • 请求载荷:推送到目标系统的完整 JSON 数据
  • 响应结果:目标系统返回的原始响应
  • 重试历史:每次重试的时间、错误信息
  • 关联单据:同一源单触发的其他推送记录(如一张调拨单生成 3 张旺店通单据)

日志导出

支持将筛选后的日志导出为 CSV 文件,包含所有字段。导出上限 10,000 条,超出时提示缩小筛选范围。


异常监控与告警

异常分级

系统将同步异常分为三个等级:

等级触发条件处理方式通知方式
Warning单次推送失败自动重试(指数退避:1s → 2s → 4s → 8s → 16s)仅仪表盘显示
Error重试 5 次仍失败标记为「需人工介入」,等待运维处理站内通知 + Webhook
Critical适配器认证失败 / 目标系统不可达立即暂停该适配器所有业务流站内通知 + Webhook + 短信(可配置)

告警通知

站内通知

  • 管理后台顶部导航栏显示未读告警数量(红色角标)
  • 点击进入告警列表,按时间倒序展示
  • 告警详情包含:异常类型、受影响业务流、源单号、错误信息、发生时间
  • 确认处理后标记为「已读」

Webhook 通知

支持配置企业微信或钉钉 Webhook,推送格式:

{ "msgtype": "markdown", "markdown": { "content": "## ⚠️ 同步异常告警\n\n**等级**:Error\n**业务类型**:销售出库回传\n**源单号**:WDT20260612001\n**错误信息**:金蝶 API 返回: 凭证已过期\n**时间**:2026-06-12 14:30:22\n\n请登录管理后台处理" } }

告警规则配置

管理员可在「告警设置」页面配置以下规则:

规则默认值可调整范围
单小时失败率阈值10%5% – 50%
连续失败次数阈值5 次3 – 20 次
告警静默期15 分钟5 – 60 分钟
Webhook 地址支持配置多个
告警接收人全部管理员可指定特定管理员

操作时间线

时间线展示

管理后台首页底部展示最近 50 条操作记录,按时间倒序排列:

记录类型示例
配置变更张三 修改了组织 org_b 的金蝶凭证
审批操作管理员李四 批准了路由规则 route_003 的变更
用户操作管理员李四 创建了操作员王五
系统事件同步引擎检测到金蝶 API 认证失败,已暂停销售回传业务流
手动同步张三 手动触发了源单 STK000001234 的重新推送

筛选与搜索

  • 按操作类型筛选:配置变更 / 审批 / 用户管理 / 系统事件 / 手动操作
  • 按操作人筛选
  • 按时间范围筛选
  • 支持关键词搜索

数据报表

报表类型

报表维度图表说明
同步量日报按小时柱状图今日每小时成功/失败数量
同步量周报按天折线图最近 7 天每日同步总量和成功率
同步量月报按天折线图最近 30 天每日同步总量和成功率
业务类型分布按类型饼图各业务类型的推送占比
目标组织分布按组织柱状图各目标组织的推送量和成功率
异常趋势按天折线图最近 30 天每日异常数量趋势

报表导出

所有报表支持导出为以下格式:

格式用途
CSV数据分析、Excel 处理
PDF打印归档、发送给管理层

报表数据基于同步日志实时计算,无需额外数据采集。导出 PDF 时自动包含图表截图和数据表格。


运维操作

手动重试

对于标记为「需人工介入」的失败记录,运维人员可以在日志详情中点击「手动重试」:

  1. 系统检查源单据是否仍然有效(源系统中是否还存在)
  2. 如有效,使用最新配置重新推送
  3. 重试结果记录在同步日志中

适配器健康检查

仪表盘提供适配器连通性状态:

适配器检查方式检查频率
金蝶 API调用轻量级查询接口验证认证每 5 分钟
旺店通 API调用店铺信息接口验证认证每 5 分钟

适配器状态在仪表盘以绿(正常)/ 黄(延迟)/ 红(不可达)三色展示,红色状态自动触发 Critical 告警。

最后更新