代理伺服器工具(proxy.jar)

代理伺服器充當在客戶機和伺服器之間中繼請求的中間伺服器。 代理伺服器跟蹤所有客戶端與伺服器的交互,並輸出整個TCP通信的日誌。 這可讓您不需存取主伺服器,即可精確監視目前的情況。

您可以在適當的安裝資料夾中找到代理伺服器:

  • <cq_install_path>/opt/helpers/proxy.jar
  • <crx_install_path>/opt/helpers/proxy.jar

您可以使用代理伺服器來監視所有客戶端與伺服器的交互,而不管基礎的通信協定如何。 例如,您可以監視下列通訊協定:

  • 網頁的HTTP
  • HTTPS用於安全網頁
  • 電子郵件的SMTP
  • 用於用戶管理的LDAP

例如,您可以在通過TCP/IP網路通信的任何兩個應用程式之間定位代理伺服器;例如網頁瀏覽器和AEM。 這可讓您監控要求AEM頁面時的確切情況。

啟動代理伺服器工具

此工具可在AEM安裝程式的/opt/helpers資料夾中找到。 要啟動它,請鍵入:

java -jar proxy.jar <host> <remoteport> <localport> [options]

選項

  • q(安靜模式) 不會將請求寫入主控台視窗。如果您不想減緩連線速度,或將輸出記錄到檔案(請參閱 — logfile選項),請使用此選項。
  • b(二進位模式) 如果您要在流量中尋找特定位元組組合,請啟用二進位模式。輸出將包含十六進位和字元輸出。
  • t(時間戳記記錄項目) 向每個記錄輸出新增時間戳記。時間戳記以秒為單位,因此可能不適合檢查單一請求。 如果您使用代理伺服器的時間較長,則可使用它查找在特定時間發生的事件。
  • logfile( <filename> 寫入日誌檔案) 將客戶端伺服器對話寫入日誌檔案。此參數也可在安靜模式下運作。
  • i( <numindentions> 新增縮排) 每個作用中的連線都會縮排,以提高可讀性。預設為16個層級。 (proxy.jar 1.16版中的新功能)。

使用代理伺服器工具

下列案例說明了可以使用代理伺服器工具的一些用途:

檢查Cookie及其值

下列記錄項目範例顯示自代理啟動以來第6個連線上開啟之用戶端傳送的所有Cookie及其值:

C-6-#000635 -> [Cookie: cq3session=7e39bc51-ac72-3f48-88a9-ed80dbac0693; Show=ShowMode; JSESSIONID=68d78874-cabf-9444-84a4-538d43f5064d ]

檢查標題及其 值以下日誌條目示例顯示伺服器能夠建立保持活動連接,並且內容長度標題已正確設定:

S-7-#000017 -> [Connection: Keep-Alive ]
...
S-7-#000107 -> [Content-Length: 124 ]

檢查「保留」是否有效

「保留 」表示客戶端重新使用與伺服器的連接來傳輸多個檔案(頁碼、圖片、樣式表等)。若不保持運作,用戶端必須為每個請求建立新連線。

檢查保持活動是否有效:

  1. 啟動代理伺服器。
  2. 要求頁面。
  • 如果保持活動正常運作,連線計數器的連線數不應超過5到10個。
  • 如果「保活」不起作用,則連接計數器會迅速增加。

查找丟失的請求

如果您在複雜的伺服器設定(例如防火牆和Dispatcher)中遺失請求,可以使用Proxy伺服器來找出請求遺失的位置。 如果是防火牆:

  1. 在防火牆之前啟動代理
  2. 在防火牆後啟動另一個代理
  3. 使用這些項目可了解請求的深入程度。

請求掛起

如果您不時遇到掛起的請求:

  1. 啟動proxy.jar。
  2. 等待或將訪問日誌寫入檔案 — 每個條目都有時間戳。
  3. 當請求開始掛起時,您可以查看已開啟的連接數,以及哪個請求導致了問題。

日誌消息的格式

proxy.jar產生的記錄項目皆具有下列格式:

[timestamp (optional)] [<b>C</b>lient|<b>S</b>erver]-[ConnectionNumber]-[BytePosition] ->[Character Stream]

例如,網頁的請求可能如下所示:

C-0-#000000 -> [GET /author/prox.html?CFC_cK=1102938422341 HTTP/1.1 ]
  • C表示此項目來自用戶端(這是網頁的要求)
  • 0是連接號(連接計數器從0開始)
  • ​# 00000位元組資料流中的偏移。 這是第一個條目,因此偏移為0。
  • [GET <?>] 是請求的內容,在其中一個HTTP標題(url)的範例中。

當連線關閉時,會記錄下列資訊:

C-6-Finished: 758 bytes (1.0 kb/s)
S-6-Finished: 665 bytes (1.0 kb/s)

這顯示在第6個連接上以平均速度在客戶端和伺服器之間傳遞的位元組數。

日誌輸出的示例

我們將審核一個簡單模板,該模板在請求時生成以下代碼:

<html>
  <head>
    <title>Welcome</title>
  </head>
  <body>
    Welcome to Playground<br>
    <img src="/logo.gif">
  </body>
</html>

如果AEM在localhost:4303上運行,請按如下方式啟動代理伺服器:

java -jar proxy.jar localhost 4303 4444 -logfile test.log

您可以在沒有代理伺服器的情況下存取伺服器(),但如果您透過存取,代理伺服器將記錄通訊。 開啟瀏覽器並存取使用上述範本建立的頁面。 之後,查看記錄檔。

注意

在proxy.jar 1.14版之前,一個連接的日誌項不會同步,這意味著一個客戶端/伺服器連接的日誌項不必按正確的順序進行。 代理伺服器的較新版本(>=1.14)不存在此問題。

開始時,會將下列資訊寫入記錄檔:

starting proxy for localhost:4303 on port 4444
using logfile: C:\CQUnify355default\opt\helpers\test.log

在請求主HTML頁面的第一個連接(0)的開頭列出了以下標題欄位:

C-0-#000000 -> [GET /author/prox.html?CFC_cK=1102936796533 HTTP/1.1 ]
C-0-#000053 -> [Accept: image/gif, image/x-xbitmap, image/jpeg, image/pjpeg, application/vnd.ms-powerpoint, application/vnd.ms-excel, application/msword, appl]
C-0-#000194 -> [ication/x-shockwave-flash, */* ]
C-0-#000227 -> [Accept-Language: de-ch ]
C-0-#000251 -> [Accept-Encoding: gzip, deflate ]
C-0-#000283 -> [User-Agent: Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.0) ]
C-0-#000347 -> [Host: localhost:4444 ]

客戶端請求保持連接,以便伺服器可以通過同一連接發送多個檔案:

C-0-#000369 -> [Connection: Keep-Alive ]

代理伺服器是驗證Cookie是否已正確設定的好工具。 在此,我們看到:

  • cq3session cookie由AEM產生
  • 顯示模式切換CFC生成的cookie
  • 名為JSESSIONID的cookie;如果未使用<%@ page session="false" %>顯式關閉,則JSP會自動建立此選項:
C-0-#000393 -> [Cookie: Show=ShowMode; cq3session=3bce15cf-1575-1b4e-8ea6-0d1a0c64738e; JSESSIONID=4161a56b-f193-d748-88a5-e09c5ff7ef2a ]
C-0-#000514 -> [ ]
S-0-#000000 -> [HTTP/1.0 200 OK ]

伺服器會在請求後關閉連線0。 無法保持生命,因為請求帶有問號。 這表示伺服器無法傳回快取版本,因此無法判斷此時的內容長度,這是保持連線所需的長度。

S-0-#000017 -> [Connection: Close ]
S-0-#000036 -> [Server: Communique Servlet Engine/3.5.5 ]
S-0-#000077 -> [Content-Type: text/html;charset=iso-8859-1 ]
S-0-#000121 -> [Date: Tue, 14 Dec 2004 09:46:44 GMT ]
S-0-#000158 -> [Set-Cookie: JSESSIONID=4161a56b-f193-d8-88a5-e09c5ff7ef2a;Path=/author ]
S-0-#000232 -> [ ]

在此,伺服器會開始在連線0上傳送HTML程式碼:

S-0-#000234 -> [<html> ]
S-0-#000242 -> [.<head> ]
S-0-#000251 -> [..<title>Welcome</title> ]
S-0-#000277 -> [.</head> ]
S-0-#000287 -> [.<body> ]
S-0-#000296 -> [..Welcome to Playground<br> ]
S-0-#000325 -> [..<img src="/author/logo.gif"> ]
S-0-#000357 -> [.</body> ]
S-0-#000367 -> [</html>]

HTML檔案提供後,連線0會立即關閉:

C-0-Finished: 516 bytes (0.0 kb/s)
S-0-Finished: 374 bytes (0.0 kb/s)

現在,連線1的輸出會開始,而連線1會下載HTML程式碼中的影像:

C-1-#000000 -> [GET /author/logo.gif HTTP/1.1 ]
C-1-#000031 -> [Accept: */* ]
C-1-#000044 -> [Referer: http://localhost:4444/author/prox.html?CFC_cK=1102936796533 ]
C-1-#000114 -> [Accept-Language: de-ch ]
C-1-#000138 -> [Accept-Encoding: gzip, deflate ]
C-1-#000170 -> [User-Agent: Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.0) ]
C-1-#000234 -> [Host: localhost:4444 ]

同樣地,客戶端請求保持連接:

C-1-#000256 -> [Connection: Keep-Alive ]
C-1-#000280 -> [Cookie: Show=ShowMode; cq3session=3bce15cf-1575-1b4e-8ea6-0d1a0c64738e; JSESSIONID=4161a56b-f193-d748-88a5-e09c5ff7ef2a ]
C-1-#000401 -> [ ]
S-1-#000000 -> [HTTP/1.0 200 OK ]

對於連接1,伺服器可提供保持活動,因為影像是靜態的,因此是已知的內容長度。

S-1-#000017 -> [Connection: Keep-Alive ]
S-1-#000041 -> [Server: Communique Servlet Engine/3.5.5 ]
S-1-#000082 -> [Content-Type: image/gif ]

伺服器在連接1上返回影像的內容長度:

S-1-#000107 -> [Content-Length: 124 ]
S-1-#000128 -> [Date: Tue, 14 Dec 2004 09:46:44 GMT ]
S-1-#000165 -> [ ]

現在已建立內容長度,伺服器會在連線1傳送影像資料:

S-1-#000167 -> [GIF87a..........................,.......
...I....0.A..8......YDA.W...1..`i.`..6...Z...$@.F..)`..f..A.....iu.........$..;]

達到保持活動逾時後,連接1也會關閉:

S-1-Finished: 291 bytes (0.0 kb/s)
C-1-Finished: 403 bytes (0.0 kb/s)

上述範例相對簡單,因為兩個連線會依序發生:

  • 首先,伺服器會傳回HTML程式碼
  • 接著瀏覽器會要求影像並開啟新連線

實際上,頁面可能會針對影像、樣式表、JavaScript檔案等產生許多平行請求。 這表示記錄檔具有重疊的並行開啟連線項目。 在此情況下,我們建議使用選項 — i來改善可讀性。

本頁內容