Come utilizzare lo strumento Proxy Server

ATTENZIONE

AEM 6.4 ha raggiunto la fine del supporto esteso e questa documentazione non viene più aggiornata. Per maggiori dettagli, consulta la nostra periodi di assistenza tecnica. Trova le versioni supportate qui.

Il server proxy funge da server intermedio che inoltra le richieste tra un client e un server. Il server proxy tiene traccia di tutte le interazioni client-server e genera un registro dell'intera comunicazione TCP. Questo consente di monitorare esattamente ciò che accade, senza dover accedere al server principale.

È possibile trovare il server proxy nell'installazione AEM qui:

crx-quickstart/opt/helpers/proxy-2.1.jar

È possibile utilizzare il server proxy per monitorare tutte le interazioni client-server, indipendentemente dal protocollo di comunicazione sottostante. Ad esempio, puoi monitorare i seguenti protocolli:

HTTP per pagine web
HTTPS per pagine web sicure
SMTP per i messaggi e-mail
LDAP per la gestione degli utenti

Ad esempio, è possibile posizionare il server proxy tra due applicazioni che comunicano tramite una rete TCP/IP; Ad esempio, un browser web e AEM. Questo ti consente di monitorare esattamente ciò che accade quando richiedi una pagina CQ.

Avvio dello strumento Proxy Server

Avvia il server sulla riga di comando:

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

Parametri

<host>

Questo è l'indirizzo host dell'istanza CRX a cui desideri connetterti. Se l'istanza si trova nel computer locale, allora sarà localhost.

<remoteport>

Questa è la porta host dell'istanza CRX di destinazione. Ad esempio, l'impostazione predefinita di una nuova installazione AEM è 4502 e il valore predefinito per una nuova istanza di authoring AEM installata è 4502.

<localport>

Questa è la porta del computer locale a cui desideri connetterti per accedere all'istanza CRX tramite il proxy.

Opzioni

-q (modalità silenziosa)

Non scrive l'output nella finestra della console. Utilizzalo se non desideri rallentare la connessione o se registri l'output in un file (vedi opzione -logfile ).

-b(modalità binaria)

Se cerchi combinazioni di byte specifiche nel traffico, abilita la modalità binaria. L'output conterrà quindi l'output esadecimale e di caratteri.

-t (voci del registro di marca temporale)

Aggiunge una marca temporale a ogni output di log. La marca temporale è in secondi, pertanto potrebbe non essere adatta per il controllo di singole richieste. Utilizzalo per individuare gli eventi che si sono verificati in un momento specifico se utilizzi il server proxy per un periodo di tempo più lungo.

-logfile <filename>(scrivi nel file di registro)

Scrive la conversazione client-server in un file di registro. Questo parametro funziona anche in modalità silenziosa.

-i <numIndentions>(aggiungere un rientro)

Ogni connessione attiva presenta un rientro per una migliore leggibilità. Il valore predefinito è 16 livelli. Questa funzione è stata introdotta con proxy.jar version 1.16.

Formato del registro

Le voci di registro prodotte da proxy-2.1.jar hanno tutti il seguente formato:

[timestamp (optional)] [Client|Server]-[ConnectionNumber]-[BytePosition] ->[Character Stream]

Ad esempio, una richiesta per una pagina Web potrebbe avere il seguente aspetto:

C-0-#000000 -> [GET /author/prox.html?CFC_cK=1102938422341 HTTP/1.1 ]

C indica che questa voce proviene dal client (è una richiesta per una pagina Web)
0 è il numero di connessione (il contatore di connessione inizia da 0)
#00000 l'offset nel flusso di byte. Questa è la prima voce, quindi l'offset è 0.
[GET <?>] è il contenuto della richiesta, nell’esempio di una delle intestazioni HTTP (url).

Quando una connessione viene chiusa, vengono registrate le seguenti informazioni:

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

Mostra il numero di byte passati tra client ( C) e il server ( S) al 6° collegamento e alla velocità media.

Esempio di output di log

Ad esempio, considera una pagina che produce il seguente codice quando richiesto:

Esempio

Ad esempio, considera un documento HTML molto semplice situato nella directory archivio all'indirizzo

/content/test.html

accanto a un file immagine situato in

/content/test.jpg

Il contenuto test.html è:

<html>
<head>
    <title>Test</title>
</head>
<body>
    Test<br>
    <img src="test.jpg">
</body>
</html>

Supponendo che l'istanza AEM sia in esecuzione su localhost:4502 avviamo il proxy in questo modo:

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

È ora possibile accedere all’istanza CQ/CRX tramite il proxy in localhost:4444 e tutte le comunicazioni tramite questa porta vengono registrate in test.log.

Se ora guardiamo l'output del proxy, vedremo l'interazione tra il browser e l'istanza AEM.

All'avvio il proxy emette quanto segue:

starting proxy for localhost:4502 on port 4444
using logfile: <some-dir>/crx-quickstart/opt/helpers/test.log

Quindi apriamo un browser e accediamo alla pagina di test:

http://localhost:4444/content/test.html

e vediamo il browser fare una GET richiesta per la pagina:

C-0-#000000 -> [GET /content/test.html HTTP/1.1 ]
C-0-#000033 -> [Host: localhost:4444 ]
C-0-#000055 -> [Connection: keep-alive ]
C-0-#000079 -> [User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_7_4) AppleWebKit/536.11 (KHTML, like Gecko) Chrome/20.0.1132.57 Safari/536.11 ]
C-0-#000212 -> [Accept: text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8 ]
C-0-#000285 -> [Accept-Encoding: gzip,deflate,sdch ]
C-0-#000321 -> [Accept-Language: en-US,en;q=0.8 ]
C-0-#000354 -> [Accept-Charset: ISO-8859-1,utf-8;q=0.7,*;q=0.3 ]
C-0-#000402 -> [Cookie: login-token=179ba6bd-e0a7-4909-a965-e11c7f2bc2fc%3a618bd8a8-fbaf-43c5-827d-c84c62248c5e_22ee860cc9036fee%3acrx.default%3b21148fb0-eb6c]
C-0-#000543 -> [-43c9-a2b9-c8d40618d8ae%3ad87a3d1a-5e9a-4d5a-bab1-0ee60ad6d8df_d0e4ddce0fcd84b6%3acrx.default%3b5cb95227-ea51-47bf-850b-68ad1dfd7297%3af3bbb6]
C-0-#000684 -> [59-7913-4285-8857-832c087bafd5_c484727d3b3665ad%3acrx.default; ys-cq-siteadmin-tree=o%3Awidth%3Dn%253A240%5EselectedPath%3Ds%253A/content ]
C-0-#000824 -> [ ]

L’istanza AEM risponde con il contenuto del file test.html:

S-0-#000000 -> [HTTP/1.1 200 OK ]
S-0-#000017 -> [Connection: Keep-Alive ]
S-0-#000041 -> [Server: Day-Servlet-Engine/4.1.24  ]
S-0-#000077 -> [Content-Type: text/html;charset=utf-8 ]
S-0-#000116 -> [Content-Length: 104 ]
S-0-#000137 -> [Date: Mon, 16 Jul 2012 11:23:38 GMT ]
S-0-#000174 -> [Last-Modified: Mon, 16 Jul 2012 11:19:27 GMT ]
S-0-#000220 -> [ ]
S-0-#000222 -> [<html>]
S-0-#000229 -> [<head>]
S-0-#000236 -> [    <title>Test</title>]
S-0-#000260 -> [</head> ]
S-0-#000269 -> [<body>]
S-0-#000276 -> [ Test<br>]
S-0-#000286 -> [    <img src="test.jpg">]
S-0-#000311 -> [</body>]
S-0-#000319 -> [</html>]

Utilizzo del server proxy

Gli scenari seguenti illustrano alcuni degli scopi per cui è possibile utilizzare il server proxy:

Verifica la presenza di cookie e dei relativi valori

L'esempio seguente della voce di registro mostra tutti i cookie e i relativi valori inviati dal client alla sesta connessione aperta dall'avvio del proxy:

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

Verifica delle intestazioni e dei relativi valori

L’esempio seguente mostra che il server è in grado di effettuare una connessione keep-alive e che l’intestazione della lunghezza del contenuto è stata impostata correttamente:

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

Verifica del funzionamento di Keep Alive

Keep-alive è una funzionalità di HTTP che consente a un client di riutilizzare la connessione TCP al server per effettuare più richieste (per il codice della pagina, immagini, fogli di stile e così via). Senza mantenere in vita, il cliente deve stabilire una nuova connessione per ogni richiesta.

Per verificare se keep-alive funziona:

Avvia il server proxy.
Richiedi una pagina.
Se keep-alive funziona, il contatore di connessione non deve mai superare 5-10 connessioni.
Se keep-alive non funziona, il contatore di connessione aumenta rapidamente.

Ricerca di richieste perse

Se perdi le richieste in un'impostazione server complessa, ad esempio con un firewall e un dispatcher, puoi utilizzare il server proxy per scoprire dove la richiesta è stata persa. In caso di firewall:

Avviare un proxy prima di un firewall
Avvia un altro proxy dopo un firewall
Utilizza questi per vedere quanto tempo arrivano le richieste.

Gestione delle richieste

Se si verificano richieste appese di tanto in tanto:

Avvia il proxy.
Attendi o scrivi il log di accesso in un file con ogni voce con una marca temporale.
Quando la richiesta inizia ad essere sospesa, puoi vedere quante connessioni erano aperte e quale richiesta causa problemi.