[AIX Solaris HP-UX Linux Windows][z/OS]

对 WebSphere 插件配置跟踪

通过配置跟踪,可以定义要从环境中收集的跟踪信息。

关于此任务

对 Web 服务器配置跟踪,以便从环境中收集特定级别的日志。这些日志将记录在标准插件日志文件 plugins_root/logs/web_server_name/http_plugin.log 中。有关插件日志记录的更多信息,请参阅有关 WebSphere® 插件属性的信息。

在插件中存在两类处理:请求处理和控制处理。请求处理由处理 HTTP 请求或者来自源服务器的 HTTP 响应所需的所有逻辑组成。控制处理是所有未归入请求处理类别的处理。例如,为了发现路由信息而与 REST 服务进行的所有通信都被视为控制处理。

对于跟踪设置,以下优先顺序层次结构适用:
  • 缺省跟踪层次结构
    1. 如果已设置缺省跟踪规范,那么将使用控制跟踪规范。
    2. 如果未设置缺省跟踪规范,那么将使用 NOTICE 跟踪级别。
  • 请求跟踪层次结构
    1. 如果规则与请求匹配,那么将使用此规则的跟踪规范。
    2. 如果规则与请求不匹配,并且设置了 DefaultRequestTraceSpec 属性,那么将使用 DefaultRequestTraceSpec 属性中指定的跟踪规范。
    3. 如果规则与请求不匹配,并且未设置 DefaultRequestTraceSpec 属性,但设置了控制跟踪规范,那么将使用控制跟踪规范。
    4. 如果未设置这些规范中的任何一个,那么将使用 NOTICE 跟踪级别。

使用子表达式构建器,可以通过 AND、OR、NOT 和括号分组来根据子表达式构建复杂的规则条件。您应用更改时,规则构建器将对规则进行验证,如果找到未配对的括号以及不支持的逻辑运算符,那么将发出警报。

操作数是运行时用来使规则与作业匹配的分类规则的组成部分。例如,如果指定协议类型等于 HTTP,那么运行时将搜索协议类型为 HTTP 的作业。以下列表包括了供选择的操作数:

表 1. HTTP 请求操作数
操作数 语法 描述

虚拟主机

virtualhost

这是请求的虚拟主机目标,用于将 Web 应用程序配置到特定主机名。

虚拟端口

numeric

这是请求的虚拟端口目标,用于将 Web 应用程序配置到特定端口。

URI

uri

统一资源标识

帮助您标识请求路径:如果 URL 为 http://host:port/path?p1=v1,那么路径为 path

用户标识

userid 返回发送请求的已认证用户的用户标识。

组标识

groupingid 返回发送请求的已认证用户的组名列表。

请求查询参数名

queryparm$<name> 头名称和值。
例如,表达式 queryparm$timezone='EST' 对请求进行测试,以确定该请求是否包含名为 timezone 且值为 EST 的 HTTP 查询参数。要测试查询参数是否存在,请使用下列其中一种格式:
queryparm$timezone IS NOT NULL 
queryparm$timezone IS NULL

请求头名称

header$<name> 头名称和值。
例如,表达式 header$Host='localhost' 对请求进行测试,以确定其中是否包含值为 localhost 的 HTTP 主机头。要测试主机头是否存在,请使用下列其中一个表达式:
header$Host IS NOT NULL 
header$Host IS NULL

Cookie 头名称

cookie$<name> Cookie 名称。
例如,表达式 cookie$My_Cookie_Name='My_Cookie_Value' 对请求进行测试,以确定其中是否包含名为 My_Cookie_Name 且值为 My_Cookie_Value 的 Cookie。要测试特定 Cookie 是否存在,请使用下列其中一个表达式:
cookie$MyCookieName IS NOT NULL 
cookie$MyCookieName IS NULL

HTTP 方法

HTTPMethod 请求的 HTTP 方法。可能的值为 POST、GET、PUT 和 DELETE。

客户机主机

clienthost 标准客户机主机名。此值是因特网协议 (IP) 命令主机名。此操作数不支持数字运算符,例如 >、>=、< 和 <=

客户机 IPV4

clientipv4 这是使用因特网协议 V4 (IPv4) 点分四段地址类型 n.n.n.n 的客户机 IP 地址。

客户机 IPV6

clientipv6 因特网协议 V6 (IPv6) 128 位地址类型 x:x:x:x:x:x:x:x,遵循客户端计算机的请求评论 1924 (RFC 1924)。

服务器主机

serverhost 服务器的标准主机名。此操作数不支持数字运算符,例如 >、>=、< 和 <=

服务器 IPV4

serveripv4 这是使用 IPv4 点分四段地址类型 n.n.n.n 的服务器计算机 IP 地址。

服务器 IPV6

serveripv6 IPV6 128 位地址类型 x:x:x:x:x:x:x:x,遵循服务器计算机的 RFC 1924。

端口

port 这是用于接收请求的侦听端口。

协议

protocol 这是用于传输请求的通信协议。当前支持的协议是 HTTP、HTTPS、SOAP 和 SOAPS。

时间

time

用于定义必须接受某个特定请求的日期以及当日时间。两个可选字段分别是 StartTimeEndTime。如果在定义的窗口外接收到请求,那么不会处理该请求。

“开始时间”和“结束时间”字段都具有以下格式:dayOfWeek/dayOfMonth/month/year::hour:minute:second

例如,2007 年 4 月 11 日星期四下午 1:03:45 指定为:

Thu/11/Apr/2007::13:03:45

任何字段都可以使用值为 * 的通配符。

例如,每个月的第一天指定为 */1

dayofWeek 值为 Sun、Mon、Tue、Wed、Thu、Fri 和 Sat,dayOfMonth 值的范围是 1 到 31。

month 值是表示 12 个月的非数字值:Jan、Feb、Mar、Apr、May、Jun、Jul、Aug、Sep、Oct、Nov 和 Dec。

year 值由年份的 4 个数字组成。例如,2007。

hour 值是一天中的某个小时(采用 24 小时制)。例如,上午 8 点表示为 ::8。minutesecond 是范围为 0 到 59 的整数。

使用正斜杠 (/) 来分隔日期参数,使用双冒号 (::) 来分隔小时参数,并使用冒号 (:) 来分隔当日时间参数。使用了 time 操作数的整条规则的布尔结果确定所执行的路由操作。

百分比

percentage$<val> percentage 操作数对固定百分比的时间求值为 true

例如,percentage$50 对平均 50% 的时间求值为 true

递增

rampup$<startTime>$<completionTime>

  

rampup 操作数对可变百分比的时间求值为 true。它在 <startTime> 之前始终求值为 false,在 <completionTime> 之后始终求值为 true。从 <startTime><completionTime> 的时间内,它求值为 true 的百分比呈线性增长。

<startTime><completionTime> 的格式为 day/month/year::hour:min:sec

其中,day 是一个月中的第几天,month 是 12 个月份之一(Jan、Feb、Mar、Apr、May、Jun、Jul、Aug、Sep、Oct、Nov 和 Dec),year 是四位数的年份,hour 是两位数的小时(采用 24 小时制),min 是两位数的分钟值,而 sec 是两位数的秒值。

例如,

rampup$01/Jan/2007::08:00:00$01/Jan/2007::17:00:00 从 2007 年 1 月 1 日上午 8 点开始偶尔求值为 true,之后概率逐渐提高,直到完成时间(同一天的下午 5 点)之后始终求值为 true

根据选择的运算符,为您要创建的子表达式输入值。所有运算符的求值结果都是布尔值。运算符不区分大小写:ANDAnD 等同。

表 2. 跟踪规范运算符
运算符 描述
忽略大小写相等 (EQUALSIGNORECASE) 忽略大小写相等运算符。忽略字符串的大小写。'ABC' EQUALSIGNORECASE 'abc' 为 true。('ABC' = 'abc') 为 false。
不等于 (< >) 不等于运算符表示操作数值与您输入的值不相等。
包含于 (IN)
  • 对于 string IN list of strings,如果第一个字符串与第二个字符串完全匹配(区分大小写),那么求值结果为 true。例如:
    • 'adrian' in ('keith','eric','kalyan','david', 'adrian and etc') 为 false。
    • 'adrian' in ('tom','adrian') 为 true。
    • 'adrian' in ('Tom','Adrian') 为 false。
  • integer IN list of integers
    • 1 in (1,2,3,4,5) 为 true。
    • 6 in (1,2,3,4,5) 为 false。
类似 (LIKE)

此运算符表示针对字符串操作数值的模式匹配。值必须在期望开始进行模式匹配的位置包含通配符 (%)。

例如,表达式:
host LIKE %blanca
与单词 blanca 以及任何其他以 blanca 结尾的单词匹配,而表达式:
host LIKE %blanca
与单词 blanca 以及任何其他以 blanca 开头的单词匹配。表达式:
host LIKE %blanca
与单词 blanca 以及任何嵌入了 blanca 标记的单词匹配。
忽略大小写类似 (LIKEIGNORECASE) 此运算符表示针对字符串操作数值的模式匹配。忽略字符串的大小写。
非空 (IS NOT NULL) 对查询进行的验证表明所请求的参数存在。
并置 (+) 此运算符将 'abc'+'def' 求值为 'abcdef'
类似包含于 (LIKEIN) 此运算符表示,对于 string likein (string1, string2, string3,...),如果 likein 前面的字符串与一个或多个字符串 (stringN) 匹配,那么求值结果为 true。
为空 (IS NULL) 对查询进行的验证表明所请求的参数不存在。用于对具有 NULL 值的操作数进行测试。
等于 (=) 等于运算符表示区分大小写的匹配。
大于 (>) 求值为标准逻辑结果。
大于或等于 (>=) 求值为标准逻辑结果。
小于 (<) 求值为标准逻辑结果。
小于或等于 (<=) 求值为标准逻辑结果。
介于 (BETWEEN) AND 配合使用以选择一个值范围,含第一个值(下限值)和最后一个值(上限值)。这两个运算符共同对数字值和日期值执行运算。

过程

结果

您已对 WebSphere 插件配置跟踪。

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



时间戳记图标 最近一次更新时间: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twve_plugintrace
文件名:twve_plugintrace.html