설명서AEM 6.5사용 안내서

프록시 서버 도구(proxy.jar) proxy-server-tool-proxy-jar

Last update: Wed Mar 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

프록시 서버는 클라이언트와 서버 간 요청을 중계하는 중간 서버 역할을 합니다. 프록시 서버는 모든 클라이언트-서버 상호 작용을 추적하고 전체 TCP 통신의 로그를 출력합니다. 이렇게 하면 주 서버에 액세스하지 않고도 진행 중인 상황을 정확하게 모니터링할 수 있습니다.

프록시 서버는 해당 설치 폴더에서 찾을 수 있습니다.

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

기본 통신 프로토콜에 관계없이 프록시 서버를 사용하여 모든 클라이언트-서버 상호 작용을 모니터링할 수 있습니다. 예를 들어 다음 프로토콜을 모니터링할 수 있습니다.

  • 웹 페이지에 대한 HTTP
  • 보안 웹 페이지용 HTTPS
  • 전자 메일 메시지용 SMTP
  • 사용자 관리를 위한 LDAP

예를 들어 웹 브라우저와 AEM과 같은 TCP/IP 네트워크를 통해 통신하는 두 애플리케이션 사이에 프록시 서버를 배치할 수 있습니다. 이렇게 하면 AEM 페이지를 요청할 때 정확히 어떤 일이 발생하는지 모니터링할 수 있습니다.

프록시 서버 도구 시작 starting-the-proxy-server-tool

이 도구는 AEM 설치의 /opt/helpers 폴더에서 찾을 수 있습니다. 시작하려면 다음을 입력합니다.

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

옵션 options

  • q(자동 모드) 콘솔 창에 요청을 쓰지 않습니다. 연결 속도를 늦추지 않으려는 경우 또는 출력을 파일에 기록하는 경우 사용합니다(-logfile 옵션 참조).
  • b(바이너리 모드) 트래픽에서 특정 바이트 조합을 찾고 있는 경우 이진 모드를 활성화합니다. 출력에는 16진수 및 문자 출력이 포함됩니다.
  • t(타임스탬프 로그 항목) 각 로그 출력에 타임스탬프를 추가합니다. 타임스탬프는 초 단위이므로 단일 요청을 확인하는 데 적합하지 않을 수 있습니다. 프록시 서버를 장기간 사용하는 경우 특정 시간에 발생한 이벤트를 찾을 때 사용합니다.
  • logfile <filename> (로그 파일에 쓰기) 클라이언트-서버 대화를 로그 파일에 기록합니다. 이 매개 변수는 자동 모드에서도 작동합니다.
  • i <numindentions> (들여쓰기 추가) 각 활성 연결은 가독성을 높이기 위해 들여쓰기됩니다. 기본값은 16 레벨입니다. proxy.jar 버전 1.16의 새로운 기능

프록시 서버 도구 사용 uses-of-the-proxy-server-tool

다음 시나리오는 프록시 서버 도구를 사용할 수 있는 몇 가지 목적을 보여 줍니다.

쿠키 및 쿠키 값 확인

다음 로그 항목 예제는 프록시 시작 이후 열린 여섯 번째 연결에서 클라이언트가 보낸 모든 쿠키와 값을 보여 줍니다.

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

머리글 및 해당 값 확인 다음 로그 항목 예는 서버가 keep-alive 연결을 만들 수 있고 컨텐츠 길이 헤더가 제대로 설정되었음을 보여 줍니다.

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

Keep-Alive가 작동하는지 확인

Keep-Alive 는 클라이언트가 서버에 대한 연결을 다시 사용하여 여러 파일(페이지 코드, 그림, 스타일 시트 등)을 전송하는 것을 의미합니다. keep-alive가 없으면 클라이언트는 각 요청에 대해 새 연결을 설정해야 합니다.

keep-alive가 작동하는지 확인하려면:

  1. 프록시 서버를 시작합니다.
  2. 페이지를 요청합니다.
  • keep-alive가 작동하는 경우 연결 카운터는 5~10개의 연결을 넘지 않아야 합니다.
  • keep-alive가 작동하지 않으면 연결 카운터가 빠르게 증가합니다.

손실 요청 찾기

방화벽 및 Dispatcher와 같은 복잡한 서버 설정에서 요청이 손실된 경우 프록시 서버를 사용하여 요청이 손실된 위치를 확인할 수 있습니다. 방화벽이 있는 경우:

  1. 방화벽 전 프록시 시작
  2. 방화벽 후에 다른 프록시 시작
  3. 요청을 처리하는 데 사용할 수 있습니다.

요청 중단

요청이 때때로 중단되는 경우:

  1. proxy.jar를 시작합니다.
  2. 각 항목에 타임스탬프가 있는 파일에 액세스 로그를 기다리거나 씁니다.
  3. 요청이 걸리기 시작하면 열려 있는 연결 수와 문제를 일으키는 요청을 확인할 수 있습니다.

로그 메시지 형식 the-format-of-log-messages

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)

이 값은 여섯 번째 연결에서 평균 속도로 클라이언트와 서버 사이에 전달된 바이트 수를 보여 줍니다.

로그 출력의 예 an-example-of-log-output

요청 시 다음 코드를 생성하는 간단한 템플릿을 검토하십시오.

<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

서버에 액세스할 수 있습니다(localhost:4303프록시 서버가 없지만 을 통해 액세스하는 경우 localhost:4444프록시 서버는 통신을 기록합니다. 브라우저를 열고 위의 템플릿으로 만든 페이지에 액세스합니다. 그런 다음 로그 파일을 확인합니다.

NOTE
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 ]

클라이언트가 keep-alive 연결을 요청하므로 서버는 동일한 연결을 통해 여러 파일을 전송할 수 있습니다.

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

프록시 서버는 쿠키가 제대로 설정되었는지 확인하는 데 유용한 도구입니다. 여기에서 다음을 볼 수 있습니다.

  • AEM에서 생성한 cq3session 쿠키
  • cfc에서 생성한 표시 모드 전환 쿠키
  • jsessionid라는 쿠키. <%@ 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을 닫습니다. 요청에 물음표가 있으므로 Keep-alive를 수행할 수 없습니다. 즉, 서버가 캐시된 버전을 반환할 수 없으므로 Keep-Alive 연결에 필요한 콘텐츠 길이를 결정할 수 없습니다.

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>]

연결 0은 HTML 파일이 제공된 직후에 닫힙니다.

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

이제 HTML 코드에 포함된 이미지를 다운로드하는 연결 1에 대한 출력이 시작됩니다.

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 ]

클라이언트가 다시 Keep-alive 연결을 요청합니다.

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의 경우 이미지가 정적이어서 콘텐츠 길이가 알려져 있으므로 서버에서 keep-alive를 제공할 수 있습니다.

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.........$..;]

keep-alive 시간 제한에 도달하면 연결 1도 닫힙니다.

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

위의 예는 두 연결이 순차적으로 발생하므로 비교적 간단합니다.

  • 먼저 서버가 HTML 코드를 반환합니다.
  • 그러면 브라우저가 이미지를 요청하고 새 연결을 엽니다

실제로 페이지는 이미지, 스타일 시트, JavaScript 파일 등에 대한 많은 병렬 요청을 생성할 수 있습니다. 즉, 로그에 병렬 열린 연결의 겹치는 항목이 있습니다. Adobe 이 경우 가독성을 향상시키려면 -i 옵션을 사용하는 것이 좋습니다.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2