设置 z/OS Connect 文件系统记录器拦截器

文件系统记录器拦截器允许 z/OS Connect 用户将请求信息记录在文件系统文件中。

关于此任务

配置 zosConnect-1.0zosConnect-1.2 功能部件时此功能可用并且需要配置。

表 1. 所生成日志文件中的条目的描述
条目 描述
DateTime 记录器拦截器在服务调用前计算的日期和时间
ThreadID 在其下处理服务请求的线程的标识
UserName 对其处理请求的用户名
RequestID z/OS Connect 生成的请求跟踪标识
RemoteAddress 发起该请求的客户机或发送该请求的上一个代理的因特网协议 (IP) 地址
LocalAddress 在其上接收该请求的接口的因特网协议 (IP) 地址
MessageType 标识有效内容是来自请求还是响应
MessageSize 有效内容的字符大小
MessageData 请求或响应有效内容
*****************************************************************************
ServerName: com.ibm.ws.zos.connect.interceptor.logger.fs
*****************************************************************************
DateTime:2015-07-19_12-14-02 | ThreadId:47 | UserName:Fred | RequestID:0000000000000001000000000000000000000000000000 | 
RemoteAddress:127.0.0.1 | LocalAddress:127.0.0.1
MessageType:REQUEST
MessageSize:27
MessageData:{"payload":"HELLO_SERVICE"}

DateTime:2015-07-19_12-14-02 | ThreadId:47 | UserName:Fred | RequestID:0000000000000001000000000000000000000000000000 | 
RemoteAddress:127.0.0.1 | LocalAddress:127.0.0.1
MessageType:RESPONSE
MessageSize:26
MessageData:{"payload":"HELLO_CALLER"}

过程

  1. 以全局方式配置 fileSystemloggerInterceptor 元素。
    <fileSystemloggerInterceptor id="globalFileSystemLogger" logName="globalLog_%SERVERNAME%"/>
    <zosConnectInterceptors id="globalInterceptorList" interceptorRef="globalFileSystemLogger" />
    <zosConnectManager globalInterceptorsRef="globalInterceptorList/>

    在此示例中,所有 z/OS Connect 服务请求记录在名为 globalLog_myServer1_yyyy-MM-dd_HH_mm_ss_SSS.log 的文件中,其中 myServer1 是服务器的名称。唯一必需配置元素是 logName 属性定义。配置元素接受 %SERVERNAME% 字符串,创建日志时此字符串将替换为服务器的名称。缺省日志文件位置为 ${server.output.dir}/logs/zosConnect。有关可用配置属性和缺省值的更多信息,请参阅 z/OS Connect 1.0z/OS Connect 1.2 的文档。

    还可对特定服务配置 fileSystemloggerInterceptor 元素。
     <fileSystemloggerInterceptor id="serviceYFileSystemLogger" 
                                     logName="service1Log" 
                                     logPath="/zosConnect/logs"
                                     logOption="RESPONSE"
                                     maxPayloadSize="30720"/>
    <zosConnectInterceptors id="serviceYInterceptorList" interceptorRef="serviceYFileSystemLogger" />
    <zosConnectService serviceName="serviceY" serviceRef="serviceY" interceptorsRef="serviceYInterceptorList"/>
    <usr_myService id="serviceY"/>

    在此示例中,所有 z/OS Connect 服务请求记录在 /zosConnect/logs 路径中的名为 service1Log_yyyy-MM-dd_HH_mm_ss_SSS.log 的文件中。日志路径为标准路径。将仅记录以 serviceY 为目标的所有传入请求的响应数据。因为最大 JSON 有效内容配置为 30,720 个字符,所以超过 30,720 个字符的任何 JSON(响应)有效内容将截断为所配置最大有效内容大小。

  2. (可选)配置 bufferedLoggingbufferSize 属性定义以启用缓冲日志记录。缺省缓冲区大小为 8 千字节。缓冲区变满时,缓冲区中的所有记录将清仓至磁盘。如果考虑性能并且能够接受发生故障时丢失未清仓记录,那么使用缓冲日志记录是适当的。
     <fileSystemloggerInterceptor id="globalFileSystemLogger" 
                                     logName="globalLog_%SERVERNAME%"
                                     bufferedLogging="true"
                                     bufferSize="16384"/>
  3. (可选)配置 rollOffLogPolicy 属性。此策略指示活动日志文件达到指定大小或缺省文件大小(50 兆字节)时,将创建新文件。自创建活动日志文件后指定时间或缺省时间(24 小时)到期后,也可能会创建新文件。在以下示例中,将在文件大小达到 16 千字节时创建新文件。命名模式相同: globalLog_myServer1_yyyy-MM-dd_HH_mm_ss_SSS.log。所创建日志文件的名称之间的差别在于创建给定文件时使用的时间戳记:
    <fileSystemloggerInterceptor id="globalFileSystemLogger" 
                                     logName="globalLog_%SERVERNAME%"
                                     rollOffLogPolicy="SIZE"
                                     rollOffLogPolicySize="16384"/>

用于指示主题类型的图标 任务主题

文件名:twlp_zconnect_file_sys_log_int.html