第三十八章 管理和监控Web网关 - 查看事件日志

使用 Web Gateway 管理页面主菜单中的查看事件日志选项来读取 Web Gateway 事件日志的内容。

当日志文件达到事件日志循环大小指定的容量时，它将被复制到 filename.old，其中 filename 是完整的原始文件名。如果“事件日志循环大小”为空（默认值），文件将不断增大，直至手动清除。要将所有日志保存在以日期和时间命名的文件中，请选择“默认参数”页面上的“保留所有日志文件”。每个日志条目都标有一个标头记录，该标头记录捕获日期、时间以及与生成日志条目的上下文有关的附加信息。

日志条目遵循 IRIS 实例用于其结构化日志记录功能的相同机器可读格式。这意味着您可以使用与分析 IRIS 实例日志相同的第三方工具来分析 Web Gateway 事件日志。为了提高效率，Web Gateway 事件日志使用多个与其他结构化日志相同的字段名称：when、level、event、pid 和 text。在“查看事件日志”页面上，显示文本和详细信息字段，但不显示其字段名称。但是，CSP.log 文件中可用的日志条目完全遵循名称-值对 (NVP) 格式。

以下是 CSP.log 中显示的 Web Gateway 事件日志条目的示例。 CSP.log 中的每个条目占用一行。但是，为了便于阅读，此示例分为多行（用 \ 字符标记）。

local-time="Thu Jul 21 11:39:20 2022" \
  wg-build="RT 2202.1825 (win32/apapi:srv=2.4.52/apr=1.7.0/apu=1.6.1/mpm=WinNT)" \
  wg-log-level=0 when="2022-07-21 15:39:20.831" level=WARNING event=WebGateway.SessionOpen \
  pid=17216 thread-id=2072 text="Warning" \
  details="A Connection between the Web Gateway and InterSystems IRIS has been found to be \
  closed (possibly as a result of an intermediary, such as a firewall, timing-out the TCP session)"

选择清除日志可清除事件日志中的所有当前条目。

日志可以按日期/时间升序（默认）或日期/时间降序显示。选择表单右上角的链接以反转显示顺序。此链接充当两种模式之间的切换。

最后，大多数浏览器无法以单一形式呈现超过 1MB 的日志数据。因此，当返回的日志数据量接近1MB时，Web Gateway将终止显示并提示输入下一页数据。请参阅表单左下角的“更多”链接。此外，表单右下角提供了一个顶部链接，使您可以快速返回到该系列中的第一个表单。

使用 HTTP 跟踪工具

HTTP 跟踪工具可通过“查看 HTTP 跟踪”选项访问。

跟踪窗口由两个主框架组成。左侧框架包含 Web 网关按时间处理的 HTTP 请求列表和唯一的请求 ID（由 Web 网关分配）。选择每个请求后，请求和响应数据将显示在右侧框架中。链接允许在请求和响应消息之间轻松导航。

注意：请注意，Web 网关报告的 HTTP 请求标头是重新构建的，因为托管 Web 服务器始终承担解析请求标头的责任。 Web 网关根据 Web 服务器提供的 CGI 环境变量重新组装完整的标头。但是，如果请求直接通过 NSD 组件传递（即有效绕过 Web 服务器），则记录的请求标头将逐字节与从客户端分派时相同。