日期/时间条目始终按照浏览器的本地时区和日期格式设置进行本地化显示,因此即使浏览到托管在不同时区的服务器,显示的时间戳也反映本地时间。
搜索和过滤日志
每个日志页面选项卡的顶部都有一个搜索栏,你可以使用它来搜索该页面上的所有日志。点击漏斗图标可打开上下文相关的过滤器部分,每种日志类型都有不同的选项。例如,如下图所示,“消息”选项卡具有针对跟踪消息头、时间、端口类型、工作区、端口 Id 和状态的过滤器。
REST 的消息。

跟踪消息头
知行之桥 支持使用额外的可搜索元数据(跟踪消息头)作为在消息选项卡中过滤结果的额外方式。你可以通过多种方式添加跟踪消息头:- 系统设置 > 高级页面的高级设置部分中的跟踪消息头字段允许你提供以逗号分隔的自定义消息头名称列表。
- 某些端口(如 X12)在高级选项卡中具有设置,可让你选择跟踪某些消息头,如 ISA08。
- XML Map 端口允许你右键单击一个元素,并将其作为跟踪消息头添加到输出消息。
-
ArcScript 中的
_message项允许你通过_message.trackedheader:HeaderName语法设置跟踪消息头。要查看使用_message的其他示例,请阅读 知行之桥消息。
- 在消息选项卡中展开消息
- 打开消息详情页面
- 查看端口的交易选项卡
消息日志
消息选项卡提供消息通过工作流的完整过程洞察,其中可能包含许多交易。你可能经常需要查看收到的消息发生了什么,此功能可以让你看到消息在工作流中传递时的完整情况。 消息表包含消息的完整列表。默认情况下,列表按最新消息列排序,但你可以点击任意列名按该列排序。它显示以下详细信息:- 最新消息——消息的最新文件名,附带与此消息相关的最后一次活动的时间戳。点击此链接可打开窗口以预览消息内容,并可选择下载、复制或格式化。
- 工作流开始和最后处理——消息来源的端口 Id,以及处理与该消息相关交易的最后一个端口的端口 Id。点击端口 Id 可在工作流设计器中打开端口配置页面。
-
状态——消息的状态。选项为:
- Success
- Warning
- Error
- Pending
- Skipped
- 总处理时间——消息在工作流中进行处理所花费的时间



- 消息 Id
- 消息产生的时间
- 与消息关联的跟踪消息头列表
- 与消息关联的其他消息头列表(未跟踪)
- 与消息状态相关的消息。例如,如果状态为 Error,则卡片会在摘要中显示导致此状态的错误消息。
诊断交易错误
交易失败时,你可以使用为 知行之桥 配置的 AI 模型分析失败原因,并获得可能的原因和后续步骤建议。分析只会在你手动启动时运行,知行之桥 从不自动诊断交易。诊断错误需要 AI 提供商。开始之前,请在系统设置 > 高级页面的 AI 设置部分中配置一个 AI 提供商。
开始诊断
任何失败交易的错误消息下方都会显示诊断错误链接。你可以在以下位置找到它:失败消息的消息工作流页面(从消息选项卡打开)、在消息选项卡中展开失败消息时显示的消息详细信息卡片,以及端口的交易选项卡。
-
点击诊断错误链接,打开错误诊断窗口。窗口左侧显示错误消息。

- 点击诊断错误按钮开始分析。
查看诊断结果
诊断结果显示在窗口右侧,分为以下几个部分(并非每次诊断都会显示所有部分):
诊断使用的数据
知行之桥 会将失败交易的相关信息发送到你在 AI 设置中配置的 AI 提供商。它不会发送消息内容或消息头。发送的信息包括:- 交易记录及其详细日志
- 端口的设置、工作流、证书和近期活动
- 相关的请求日志、应用程序日志和服务日志
- 以下类型端口的身份和贸易伙伴配置:AS2、AS3、AS4、OFTP、GISB、RNIF、PIP、PEPPOL、X12、EDIFACT、TRADACOMS、VDA、SFTP Server、FTP Server、TCP Server 和 OpenPGP
诊断错误是只读操作。知行之桥 不会根据诊断结果应用修复、回滚更改或修改任何配置。AI 生成的诊断结果可能不正确,因此在更改配置之前,请先核实建议的原因和修复步骤。请查看 AI 提供商的数据处理条款,确认将这些信息发送给该提供商符合你所在组织的要求。
SLA 日志
SLA 选项卡存储在各个端口上配置的每个 SLA 的信息。它包括 SLA 关联的工作区信息,以及状态信息和该状态剩余的时间。它显示以下详细信息:- 端口 Id——每个定义了 SLA 的端口 Id
- 工作区——关联工作区的名称
- 上一个状态——先前的 SLA 状态(例如 OK)
- 当前状态——当前 SLA 状态(例如 At Risk),以及 SLA 再次更改状态前的剩余时间(例如变为 In Violation)
日志选项卡
日志选项卡包含五组日志:应用程序、自动化、访问、审计和个人设置。默认情况下,每个表都包含今日日志的摘要计数以及所有日志的总计数。应用程序日志还会将相似条目归入模式。点击每个部分中的查看全部链接,可在窗口中填充该类别的完整日志列表。在这里,你可以搜索、过滤和下载日志。应用程序日志
应用程序日志记录处理过程中发生的任何应用程序级错误以及对应用程序资源发出的任何请求。这里的错误消息有助于为特定交易的错误提供上下文。 使用此选项卡验证外部贸易伙伴的 Web 请求是否已成功路由到 知行之桥 工作流中的端口。当应用程序在公共端点接收到 Web 请求时,它会尝试根据消息头(例如 AS2 标识符)将消息路由到特定端口。如果某个错误阻止应用程序成功路由消息,则此错误会显示在应用程序选项卡上。 为了让你快速发现重复出现的问题和高频活动,知行之桥 会将相似的应用程序日志条目归入_模式_,如下图所示。模式表示一组结构相同的消息,其中每条消息的可变部分(例如 ID、计数和任务名称)会替换为<*> 通配符。例如,消息 Stopped task [CheckIntegrityTask] 和 Stopped task [PortHealthCheckTask] 都会归入模式 Stopped task <*>。

- 计数——匹配该模式的日志条目数
- 趋势(时间段)——显示该模式随时间出现频率的迷你趋势图
- 级别——模式的日志级别(例如 Info)
- 模式模板——共享的消息结构,其中可变值显示为
<*> - 首次出现——匹配该模式的最早条目的时间戳
- 日期/时间——事件的时间戳
-
级别——日志级别。查看消息列中的信息以了解详细信息。选项为:
- None——不记录事件
- Error——处理过程中遇到的错误信息
- Warning——处理过程中遇到的警告信息
- Info——有关处理的一般信息,包括任何错误和警告(如果适用)
- Debug——成功和失败流程的详细调试信息
- Trace——成功和失败流程的详细跟踪信息(如果需要将日志发送给 知行软件 支持,此级别很有用)
日志记录级别 Debug 和 Trace 可能会记录敏感信息,包括文件信息和 SSL 证书。尽管密码等敏感详细信息会被屏蔽,但在将这些日志共享到组织外部之前,你应检查其中是否包含敏感信息。 - 资源——生成消息的资源
- 消息——消息文本
- 实例 Id——事件发生的机器
自动化日志
自动化日志记录自动化服务对每个端口所做的决策:端口是否到期运行、是否已触发、跳过的原因,以及运行是成功、失败还是在未接收到任何消息的情况下完成。使用这些日志可以确认计划运行的端口确实执行了轮询,即使该次轮询没有产生消息,也没有出现错误。 自动化日志与应用程序日志相互独立,因此这些条目不会出现在应用程序日志中。自动化部分和完整页面都显示以下详细信息:- 日期/时间——条目的时间戳
- 级别——条目的严重程度:Debug、Info 或 Error
- 端口——条目所对应的端口和工作区。点击端口名称可打开其配置页面。
- 操作——条目涉及的自动化操作:接收、定时发送、检查待处理或服务(适用于整个端口而非单个操作的服务级决策)
- 决策——自动化服务做出的决策(详情请参阅决策表)
- 下次运行时间——当条目涉及计划评估时,端口下一次计划运行的时间
- 原因——对该决策的文字描述
- 实例 Id——写入该条目的 知行之桥 实例
决策
每个条目都具有以下决策之一:
在 Debug 级别下,还会记录服务级的已锁定决策(没有到期运行时端口锁不可用),以及检查待处理操作的已触发决策。
已触发可以可靠地确认某次运行已经启动。调度程序一旦发现有到期的运行就会推进计划,因此仅凭一次到期评估并不能证明实际发生了什么。知行之桥 只会在工作进程启动后才写入已触发,并将每个未能启动的到期操作记录为已锁定或未开始。
日志级别
自动化条目遵循每个端口自身的日志级别设置(位于端口的高级选项卡),而不是应用程序日志级别。你可以只为单个端口获取自动化详细信息,而无需提高整个应用程序的日志级别。 无论处于哪个级别,运行结果都会被记录。成功、无消息和失败描述的是已经执行的运行,因此会无条件写入。提高级别并不能揭示运行是否成功,因为这些结果始终会被记录;它揭示的是运行为何没有发生:- Error 会增加无许可证和未开始。
- Info 会增加已触发、退避,以及到期运行被阻止时的已锁定。
- Debug 会增加每个决策背后的评估,包括未到期和已处理。
保留
每日清理会删除超过七天的自动化日志条目;如果清理选项中的周期值更短,则按该值删除。知行之桥 还会将该表限制在约 100,000 个条目。由于此限制由每日清理执行,表中的条目数可能会短暂超出该限制。访问日志
访问日志记录对应用程序提供的端点发出的请求条目。这包括 API 请求、公开公共端点的端口(例如 Webhook),以及与接收数据相关的公共端点(例如 public.rst)。它显示以下详细信息:- 日期/时间——交易的时间戳
- 方法——使用的 HTTP 方法
- URL——URL
- 用户——发出请求的已认证用户。如果发出请求的用户是匿名用户,则此条目为空。
- 用户类型——发出请求的用户的账户类型:标准用户、单点登录、Active Directory、LDAP 或服务。每种类型都以不同的图标显示。有关更多信息,请参阅用户类型。
- 远程 IP——发出请求的 IP 地址
- 实例 Id——为请求提供服务的实例 Id
审计日志
审计日志存储对应用程序配置所做的每个更改。这包括创建端口、配置端口、更新个人设置等所有操作。它显示以下详细信息:- 日期/时间:配置更改的时间戳
- 操作:所做更改的类型。选项为:
- GET
- POST
- PUT
- MERGE
- PATCH
- 资源:管理控制台(作为管理和配置应用程序的典型界面的 Web UI)或系统 API(可用于管理和配置应用程序的基于 REST 的 API)。
- 消息:对更改的详细文字描述,包括受影响的资源、被修改的具体字段或设置,以及修改前后的值
- 用户:进行更改的用户
- 用户类型:进行更改的用户的账户类型:标准用户、单点登录、Active Directory、LDAP 或服务。每种类型都以不同的图标显示。有关更多信息,请参阅用户类型。
个人设置日志
个人设置日志记录已配置通信个人设置中的活动。这包括文件传输、协议级事件,以及 AS2、AS4 和 SFTP Server 等个人设置的服务器活动。它显示以下详细信息:- 日期/时间——活动的时间戳
- 端口——涉及的端口 Id
- 文件——用于打开个人设置日志文件的链接
- 状态——操作的状态。选项为 Complete、In Progress