![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[z/OS]](../images/ngzos.gif)
对 WebSphere 插件配置跟踪
通过配置跟踪,可以定义要从环境中收集的跟踪信息。
关于此任务
在插件中存在两类处理:请求处理和控制处理。请求处理由处理 HTTP 请求或者来自源服务器的 HTTP 响应所需的所有逻辑组成。控制处理是所有未归入请求处理类别的处理。例如,为了发现路由信息而与 REST 服务进行的所有通信都被视为控制处理。
- 缺省跟踪层次结构
- 如果已设置缺省跟踪规范,那么将使用控制跟踪规范。
- 如果未设置缺省跟踪规范,那么将使用 NOTICE 跟踪级别。
- 请求跟踪层次结构
- 如果规则与请求匹配,那么将使用此规则的跟踪规范。
- 如果规则与请求不匹配,并且设置了 DefaultRequestTraceSpec 属性,那么将使用 DefaultRequestTraceSpec 属性中指定的跟踪规范。
- 如果规则与请求不匹配,并且未设置 DefaultRequestTraceSpec 属性,但设置了控制跟踪规范,那么将使用控制跟踪规范。
- 如果未设置这些规范中的任何一个,那么将使用 NOTICE 跟踪级别。
使用子表达式构建器,可以通过 AND、OR、NOT 和括号分组来根据子表达式构建复杂的规则条件。您应用更改时,规则构建器将对规则进行验证,如果找到未配对的括号以及不支持的逻辑运算符,那么将发出警报。
操作数是运行时用来使规则与作业匹配的分类规则的组成部分。例如,如果指定协议类型等于 HTTP,那么运行时将搜索协议类型为 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 查询参数。要测试查询参数是否存在,请使用下列其中一种格式:
|
请求头名称 |
header$<name> | 头名称和值。
例如,表达式 header$Host='localhost' 对请求进行测试,以确定其中是否包含值为
localhost 的 HTTP 主机头。要测试主机头是否存在,请使用下列其中一个表达式:
|
Cookie 头名称 |
cookie$<name> | Cookie 名称。
例如,表达式 cookie$My_Cookie_Name='My_Cookie_Value' 对请求进行测试,以确定其中是否包含名为
My_Cookie_Name 且值为 My_Cookie_Value 的
Cookie。要测试特定 Cookie 是否存在,请使用下列其中一个表达式:
|
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 | 用于定义必须接受某个特定请求的日期以及当日时间。两个可选字段分别是 StartTime 和 EndTime。如果在定义的窗口外接收到请求,那么不会处理该请求。 “开始时间”和“结束时间”字段都具有以下格式: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。minute 和 second 是范围为 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。 |
根据选择的运算符,为您要创建的子表达式输入值。所有运算符的求值结果都是布尔值。运算符不区分大小写:AND 与 AnD 等同。
运算符 | 描述 |
---|---|
忽略大小写相等 (EQUALSIGNORECASE) | 忽略大小写相等运算符。忽略字符串的大小写。'ABC' EQUALSIGNORECASE 'abc' 为 true。('ABC' = 'abc') 为 false。 |
不等于 (< >) | 不等于运算符表示操作数值与您输入的值不相等。 |
包含于 (IN) |
|
类似 (LIKE) | 此运算符表示针对字符串操作数值的模式匹配。值必须在期望开始进行模式匹配的位置包含通配符 (%)。 例如,表达式:
与单词 blanca 以及任何其他以 blanca 结尾的单词匹配,而表达式:
与单词 blanca 以及任何其他以 blanca
开头的单词匹配。表达式:
与单词 blanca 以及任何嵌入了 blanca 标记的单词匹配。 |
忽略大小写类似 (LIKEIGNORECASE) | 此运算符表示针对字符串操作数值的模式匹配。忽略字符串的大小写。 |
非空 (IS NOT NULL) | 对查询进行的验证表明所请求的参数存在。 |
并置 (+) | 此运算符将 'abc'+'def' 求值为 'abcdef'。 |
类似包含于 (LIKEIN) | 此运算符表示,对于 string likein (string1, string2, string3,...),如果 likein 前面的字符串与一个或多个字符串 (stringN) 匹配,那么求值结果为 true。 |
为空 (IS NULL) | 对查询进行的验证表明所请求的参数不存在。用于对具有 NULL 值的操作数进行测试。 |
等于 (=) | 等于运算符表示区分大小写的匹配。 |
大于 (>) | 求值为标准逻辑结果。 |
大于或等于 (>=) | 求值为标准逻辑结果。 |
小于 (<) | 求值为标准逻辑结果。 |
小于或等于 (<=) | 求值为标准逻辑结果。 |
介于 (BETWEEN) | 与 AND 配合使用以选择一个值范围,含第一个值(下限值)和最后一个值(上限值)。这两个运算符共同对数字值和日期值执行运算。 |