Version 25.1.9222

• 访问日志
• 应用程序日志
• 交易日志
  • 搜索日志
  • 添加自定义头部
• Web 服务器日志
• 调试日志
• 审计日志

知行之桥包含几个部分独立的日志：交易日志，应用程序日志、访问日志和审计日志。这些日志都可以在应用界面的 状态 页查看。每部分日志都以单独的表的形式存储在单个应用程序数据库中。

访问日志

访问日志记录了由公共接口发起的 web 请求。包含了所有对 AS2 和 AS4 接口发起的请求（/pub/Receive.rsb）和任何 API 调用（内置系统 API 和任何使用 API 端口自定义的 API）。

访问日志可以用来验证外部交易伙伴的 web 请求是否到达托管应用程序的 web 服务器。如果交易伙伴尝试使用基于 HTTP 的协议（AS2，AS4 等）发送消息但是该请求没有出现在访问日志中，这就表示该消息没有到达应用程序 web 服务器。这表明可能存在着基本的连接错误，例如防火墙干扰、错误的连接参数或者网络中断。

应用程序日志

应用程序日志记录了处理过程中，发生的任何应用程序级错误以及对应用程序资源的任何请求。应用程序日志中的错误信息可能有助于为特定交易的错误提供上下文。

应用程序日志可以用来验证外部交易伙伴的 web 请求是否成功路由到了知行之桥工作流中的端口。当应用程序在公共接口接收到一个 web 请求时，它将根据消息头尝试将消息路由到具体的端口（例如 AS2 Identifiers）。如果有错误阻止了消息的成功路由，错误信息将会在应用程序日志中出现。

交易日志

交易日志包括了所有有关输入／输出文件传输和数据传输端口本地处理的所有文件的详细信息。例如 AS2 交易日志包括了 HTTP 请求和响应报头，对 AS2 请求的 MDN 响应，以及所有通信错误。

交易日志包括应用程序处理每个文件时生成的单独一行的日志，每一行可以展开以下载日志文件。特定端口的传输信息也可以在该端口的输入和输出选项卡下找到。

交易日志包括成功和失败的交易。成功的交易将会有一个 “sent” 或 “received” 的 状态 ，失败的交易将会报告一个 “Error” 的状态。

搜索日志

在交易日志中进入搜索查询，将使用查询字符串与以下交易元数据进行匹配：

• 文件名
• 时间戳
• 端口名

例如，一个名称为 reports.csv 的文件被多个端口处理，搜索 “reports.csv” 将会显示与这个文件有关的多条交易记录。

自定义可检索标题

知行之桥支持在系统设置页面下的 高级设置 选项卡中添加附加的可搜索元数据。可以将可检索标题 字段设置为以逗号分隔的自定义头部名称列表，这些自定义的头部可以在交易日志中通过设置字符串为 “headername:value” 来搜索。

例如，如果 “AS2-From” 头部信息被添加到了 可检索标题 ，可以使用以下字符串来搜索 “AS2-From” 值为 “test” 的文件：

AS2-From:test

知行之桥将在工作流中处理文件时，添加元数据头部信息到文件，并且可以通过单击交易日志条目的文件名（在交易日志或特定端口的“输入／输出”中），在消息内容中查看这些头部信息。自定义头部可以通过使用知行之桥的脚本功能来添加到文件中，可以在专用的脚本端口，也可以在工作流中另一个的端口的事件脚本中添加。

高级搜索查询

高级搜索查询可以利用两个附加值：

• option
• header

option 值将搜索范围缩小到特定工作区或端口（option 的唯一有效值是“workspace”和“connectorid”）。 header 值搜索其中处理的消息包含特定标题名称和值对的事务。

高级搜索查询应使用以下语法：

[option:optionValue] [headerName:headerValue] [<剩余搜索文本>]

以下是遵循此语法的示例查询：

workspace:Dev customer_number:12345 test.csv

此查询将从工作区“Dev”返回涉及名为 “test.csv” 的文件的事务，其中文件/消息包含名为“customer_number”的消息头部，其值为 “12345”。

搜索语法使用以下逻辑来确定 option 和 header：如果搜索中的第一个术语包含冒号，则将其视为header或option；如果冒号左侧的值是“workspace”或“connectorid”，则被视为选项，否则被视为标题名称-值对。

添加自定义头部

ARCScript 可以用来在工作流中添加自定义头部。通过导航到系统设置页面，选择高级设置选项卡，然后在可检索标题 输入头部名，这些自定义头就可以在交易日志中检索到。

通过设置端口推送的文件项中的 Header:header_name 属性，可以在脚本的上下文中将自定义的头部信息添加到文件中。为了逻辑清晰，请从一个推送文件的脚本开始，将该文件作为输入文件的未修改版本。

<arc:set attr="outfile.FilePath" value="[FilePath]" />
<arc:push item="outfile" />

[FilePath] 变量解析为输入文件的完整路径（和文件名），所以这个脚本可以非常简单地使输出文件和输入文件相同。

以下对脚本的补充可以在推送文件之前在文件中增加自定义头部：

<arc:set attr="outfile.FilePath" value="[FilePath]" />
<arc:set attr="outfile.Header:myHeaderName" value="myValue" />
<arc:push item="outfile" />

如果在系统设置页面 高级设置 -> 可检索标题 添加 “myHeaderName”，那么在交易日志界面搜索 “myValue” 将会返回这个文件。

Web 服务器日志

知行之桥还包含了托管应用程序的底层 web 服务器的日志。这些日志仅在使用 windows 版内置 Web 服务器时适用。（当与其它 web 服务器托管时，请查阅该服务器的文档以获取服务器日志信息）

内置 web 服务器日志可以帮助诊断连接问题和与 web 服务器本身有关的配置问题。通过以下方式访问内置 web 服务器日志：

• 在 windows 的任务栏中右键单击知行之桥图标并选择 服务器选项
• 导航到内置 web 服务器界面的 “Other” 标签
• 勾选 “Write log to a file” 并且输入一个磁盘上的文件路径
• 设置日志详细程度，包括需要的日志等级，如有必要的话，设置日志轮换选项

当以服务启动时，应用程序会把 web 服务器日志写进应用程序安装目录下的 service.log 文件。

调试日志

部分端口在高级设置选项卡中，可设置交易日志的详细程度，这些详细的日志在调试的时候将会非常有帮助，并且在和 support@kasoftware.cn 请求技术支持时是十分必要的。

最常见的高级设置是 日志级别 。选择 “Debug”，每处理一个交易时，其它附加的信息会被添加到一个已经生成的日志中。

一些对外发送请求的端口还有 日志请求 设置。启用该设置时，如果有请求被发送到远端的服务器上，交易日志将会保留一份请求的副本，这对缩小任何接收服务器响应问题的范围很有帮助。

还有一些对远程系统发出查询的端口（比如 MySql 端口）有 Verbosity 设置。Verbosity 应该被设置到 1 到 5 之间（其中 5 为最详细，在大部分情况下推荐设置成该值）。

审计日志

知行之桥在审计日志中存储对应用程序配置的每个更改。包括所有的操作，例如创建端口、配置端口、更新个人设置等。

审计日志包括执行的更改、更改的时间戳以及用于进行更改的 资源 。 资源 指的是管理控制台（用作管理和配置应用程序的典型界面的 Web UI）和系统 API（可用于管理和配置应用程序的基于 REST 的 API）。

可以查询审计日志以执行应用程序配置的审计。