![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[z/OS]](../images/ngzos.gif)
自訂日誌檔格式
當處理要求時,您可以建立規則集來指定要包含在日誌中的資料、顯示順序、用來過濾要包含哪些要求的條件式邏輯,以及日誌檔的數量和名稱。
自訂內容物件
規則集、規則和動作層次可以使用自訂內容。 規則決定執行日誌動作時所根據的條件。 表示式欄位用來決定要記載的要求和回應。 這個表示式利用標準 HTTP 語言運算元和 response.code 運算元,按 404 或 503 之類的 HTTP 回應碼來進行過濾。 例如,response.code = 200 會過濾回應碼 200 的所有回應。 HTTP 運算元 targetserver 用來顯示 WebSphere® Application Server 格式的要求所送往的伺服器。 HTTP 自訂日誌運算元 service.time 是將要求傳送到應用程式伺服器與從應用程式伺服器接收回應之間的時間範圍。 HTTP 自訂日誌運算元 response.time 是在 ODR 中接收要求與從 ODR 送出要求回應之間的時間範圍。 如需相關資訊,請閱讀 HTTP 自訂日誌運算元的相關資料。
規則優先順序決定了規則的評估順序。 當符合規則時,會發生特定日誌動作。 日誌動作有一個 continue 欄位。 當 continue 欄位設為 true 時,可以執行後續的日誌動作。 不過,如果將 continue 設為 false,一旦日誌動作完成之後,不會再執行任何後續的日誌動作。 請利用 manageODR.py Script 來建立 ODR 叢集及管理自訂記載。 如需相關資訊,請閱讀 manageODR.py Script。
規則集
- name
- 指定規則集的名稱。 (字串,必要)
- type
- 指定規則集的類型。(字串,HTTP 之類的通訊協定 ID)
- continueDefault
- 決定 continue 的預設值。(布林,必要)
- properties
- 選用
- rule
- 必要
規則
- name
- 指定規則的名稱。(字串,在規則集內是唯一的)
- priority
- 必要,整數(在規則集內是唯一的)
- expression
- 字串,必要。
- action
- 必要。
- properties
- 選用
動作
- name
- 指定動作的名稱。(字串,在規則內是唯一的)
- priority
- 選用,整數(在規則內是唯一的)。
- type
- 字串,必要,日誌
- value
- 必要。(字串,包含一連串的 logFormat,用 @ 區隔。例如:
value="custom01.log %a%z@custom02.log @(#) 10 1.7@(#)Z"
- continue
- 選用,布林。如果未設定,預設為 continueDefault 值,即:true 和 false。
- properties
- 選用
customProperties
- name
- 指定名稱自訂內容。(字串)
- value
- 必要。(字串)
- continue
- 選用,布林。如果未設定,預設為 continueDefault 值,即:true 和 false。
日誌動作格式
action value 屬性包含一組引數,指示日誌的檔名和格式。 如果要在 value 屬性中建立多個日誌,請用 @ 來區隔引數。 日誌動作的第一個引數是日誌檔的名稱,相對於 ODR 日誌目錄。 下列引數是用來指定要將什麼資訊放在日誌中的參數。 資料是依照參數的指定順序來顯示。
參數 | 說明 |
---|---|
%a | 遠端 IP 位址。 |
%A | 本端 IP - 位址。 |
%B | 傳送的位元組數,不包括 HTTP 標頭。 |
%b | 傳送的位元組數,不包括 HTTP 標頭。在 CLF 格式中,當沒有傳送任何位元組時,是 '-' 而不是零。 |
%{FOOBAR}C | 傳送到伺服器要求中的 Cookie 內容。 |
%{FOOBAR}i | Foobar 的內容:傳送到伺服器要求中的標頭行。 |
% I | 接收的位元組數,包括要求和標頭,不得為零。 |
%{FOOBAR}e | 針對 ODR 程序的 JVM 而指定之除錯引數 ("-D") FOOBAR 的內容。 |
%h | 遠端主機。 |
%H | 要求通訊協定 HTTP 或 HTTPS。 |
%m | 要求方法。 |
%{FOOBAR}o | 回覆中的 Foobar 內容,標頭行。 |
%O | 傳送的位元組數,包括標頭;數量不得為零。 |
%p | 處理要求的伺服器的標準埠。 |
%q | 當查詢字串存在時,含有 ? 字首的查詢字串。否則,便是空字串。 |
%r | 要求的第一行。 |
%R | 回應時間(毫秒)。在 ODR 和應用程式伺服器中花費的合併時間。 |
%s | 狀態、HTTP 回應碼,也就是 503、404 和 200。 |
%t | 時間,一般日誌格式時間格式,標準英文格式。 |
%{format}t | 採用 format 所提供之格式的時間,應該是 strftime(3) 格式。 有可能本地化。 |
%T | 處理要求所花的時間(毫秒)。 |
%U | 要求的 URL 路徑,不包括任何查詢字串。 |
%v | 處理要求的伺服器的標準 ServerName。 |
%z | 目的地 IP 位址。 |
%Z | 目的地伺服器名稱(Cell/節點/伺服器)。 |