[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

統一資源識別碼 (URI)

有助於您識別要求的路徑:如果 URL 是 http://host:port/path?p1=v1,則路徑是 path

使用者 ID

userid 傳回傳送要求之已鑑別使用者的使用者 ID。

群組 ID

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 用戶端的 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

用來定義必須接受特定要求的日期和時刻。有兩個選用欄位: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> 百分比運算元會將固定的時間百分比評估為 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

表 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