![[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 | 統一資源識別碼 (URI) 有助於您識別要求的路徑:如果 URL 是 http://host:port/path?p1=v1,則路徑是 path。 |
使用者 ID |
userid | 傳回傳送要求之已鑑別使用者的使用者 ID。 |
群組 ID |
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 | 用戶端的 IP 位址,使用「網際網路通訊協定」第 4 版帶點四段式位址類型 n.n.n.n。 |
用戶端 IPV6 |
clientipv6 | 「網際網路通訊協定」第 6 版 (IPv6) 128 位元位址類型 x:x:x:x:x:x:x:x,後面跟著用戶端電腦的 Request for Comments 1924 (RFC 1924)。 |
伺服器主機 |
serverhost | 伺服器的完整主機名稱。這個運算元不支援數值運算子,例如 >, >=, <, <=。 |
伺服器 IPV4 |
serveripv4 | 伺服器電腦的 IP 位址,使用 IPv4 帶點四段式位址類型 n.n.n.n。 |
伺服器 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> | 百分比運算元會將固定的時間百分比評估為 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 是 4 位數的年份,hour 是 24 小時制的 2 位數小時,min 是 2 位數的分鐘值,sec 是 2 位數的秒鐘值。例如, 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 搭配使用,以選取一個值範圍,且第一個(低)值和最後一個(高)值都包含在內。當一起使用時,可用來處理數字和日期值。 |