Skip to main content
本页是 Log Trace Comparator 工具的完整检查点和场景标签参考。如果工具页面上的简短图例不够用,或者您不确定某个结果是否为真实问题,请阅读本页。

​
结果卡片的构成

每个日志或工作表都有各自的卡片:
  • 文件/工作表名称:格式为 filename.xlsx → SheetName,因此在同时上传多个文件或工作表时,可以清楚地看出每个结果来自哪个文件或工作表。
  • 结论徽章:ALL CHECKS PASSED、REVIEW RECOMMENDED 或 FAILED CHECKS FOUND。请参阅主工具页面上的图例。
  • 场景标签:自动检测交易类型或场景,例如 Vend denied 或 Multivend。完整列表见下文。
  • 跟踪条:每个检查点一个圆点,顺序与下文列出的检查点顺序相同。颜色图例位于工具页面上。
  • 修复建议框:当某个检查点出现警告或失败时显示,包含具体建议以及指向相关文档页面的 “Learn more” 链接。
  • 证据行:该检查点所依据的确切日志行,因此您无需手动查找。

​
场景标签

工具会根据日志中的模式,为每个结果标记所检测到的场景:

​
9 个检查点

每个结果都会经过相同的 9 个检查点,这些检查点分为四个类别,与工具页面上跟踪条的顺序一致。每一行说明检查点检查的内容以及各结论的含义: 在运行这九个检查点之前,工具会先检查输入内容是否像 Marshall 日志。如果未找到任何预期标记,工具会在此停止,并仅报告一个 File format check 结果,标记为 “Not a recognized Marshall log”。该徽章表示文件未被识别为日志,而不是日志本身有问题。请确认您上传的是正确的文件或工作表,并且它不是封面页或备注工作表。

​
是真实问题还是误报?

该工具只是快速的初步筛查,不能取代专业判断。在向您的 Nayax 集成人员报告问题之前,请检查以下列表:
  • 工作表或测试名称是否表明这是有意的行为,例如 timeout、idle、stress 或 cancel? 时间或售货结果上的警告或失败,可能正是该测试要演示的内容。
  • 这是信息会话吗? 在信息会话中,“Vend denied” 是正确结果,而非缺陷。工具已能识别这种情况并将其标记为通过,但仍值得再次确认。
  • 唯一失败的检查点是否是 Response timing,而其他所有检查点都通过了? 这很可能是一次等待,而非真实问题。
  • 是否有修复建议框? 阅读其内容并点击 “Learn more” 链接。它会说明该行为对于该协议是否正常,或者是否需要在您的实现中修复。
  • 工作表是否被识别为日志? 如果您看到 “Not a recognized Marshall log”,请确认您上传了正确的工作表,并且它不是元数据或备注工作表。
如有任何疑问,请打开证据行,在原始日志中结合完整上下文阅读该确切日志行。 下面是一个实际示例。多会话、始终空闲流程的认证文件中可能包含一项名为 “24 hours in idle mode” 的测试,该测试仅在 Response timing 上失败,有 4 个间隔超过阈值。这不是缺陷:这正是该测试的目的。正确的做法是忽略该失败,或在运行比对前调高时间阈值,而不是将其作为问题报告。

​
导出报告或重新开始

查看完结果后,页脚中提供两个操作:
  • Download report (.txt):下载所有结果的完整文本摘要,包括详细信息和建议。可用于附加到支持工单,或发送给您的 Nayax 集成人员。
  • Clear all:清除所有文件和结果,以开始新的检查。
“Clear all” 无法撤销。如果您想保留当前结果的副本,请先下载报告。

​
已知限制

在将结果视为最终结论之前,请牢记以下几点:
  • 工具只检测每种类型的第一个请求,例如第一个 Vend 请求。在包含数十笔连续交易的日志中(例如压力测试),详细信息仅针对第一笔交易,而不是每一笔交易。
  • Response timing 检查点无法区分有意的等待和真实问题,需要人工判断,请参阅上一节。
  • 所有逻辑都基于从真实示例中提取的文本模式。如果 SDK 更改了现有消息的措辞,检查点可能会漏检。
  • 工具绝不会将数据发送到任何地方。所有分析都在浏览器中本地进行。只有 “Learn more” 链接会连接互联网,而且只有在您点击时才会连接。

​
另请参阅

Log Trace Comparator

工具本身,包含简短介绍和结果图例。