I registri fungono da strumenti di prima linea per il debug delle applicazioni AEM in AEM as a Cloud Service, ma dipendono dalla registrazione adeguata nell’applicazione AEM implementata.
Tutte le attività di registro per il servizio AEM di un dato ambiente (Author, Publish/Publish Dispatcher) sono consolidate in un unico file di registro, anche se i pod diversi all’interno di tale servizio generano le istruzioni di registro.
Gli ID dei pod vengono forniti in ogni istruzione di registro e consentono di filtrare o fascicolare le istruzioni di registro. Gli ID pod sono nel formato di:
cm-p<PROGRAM ID>-e<ENVIRONMENT ID>-aem-<author|publish>-<POD NAME>
cm-p12345-e56789-aem-author-abcdefabde-98765
I Cloud Service AEM non supportano i file di registro personalizzati, ma la registrazione personalizzata.
Per i registri Java da rendere disponibili in AEM as a Cloud Service (tramite Cloud Manager o CLI ADOBE I/O), le istruzioni di registro personalizzate devono essere scritte nel error.log
. Registri scritti in registri denominati personalizzati, ad esempio example.log
, non sarà accessibile da AEM as a Cloud Service.
I registri possono essere scritti in error.log
utilizzo di una proprietà di configurazione Sling LogManager OSGi nel file org.apache.sling.commons.log.LogManager.factory.config~example.cfg.json
file.
{
...
"org.apache.sling.commons.log.file": "logs/error.log"
...
}
I servizi di authoring e pubblicazione AEM forniscono i registri del server di runtime AEM:
aemerror
è il registro degli errori Java (disponibile all’indirizzo /crx-quickstart/logs/error.log
nell’SDK per AEM (avvio rapido locale). Di seguito sono riportati i livelli di registro consigliati per i logger personalizzati per tipo di ambiente:
DEBUG
WARN
ERROR
aemaccess
elenca le richieste HTTP al servizio AEM con i relativi dettagliaemrequest
elenca le richieste HTTP effettuate al servizio AEM e la relativa risposta HTTPSolo il Dispatcher di pubblicazione dell’AEM fornisce il server web Apache e i registri di Dispatcher, in quanto questi aspetti esistono solo nel livello di pubblicazione dell’AEM e non nel livello di creazione dell’AEM.
httpdaccess
elenca le richieste HTTP effettuate al server web Apache/Dispatcher del servizio AEM.httperror
elenca i messaggi di registro dal server web Apache e fornisce assistenza per il debug dei moduli Apache supportati, come mod_rewrite
.
DEBUG
WARN
ERROR
aemdispatcher
elenca i messaggi di registro provenienti dai moduli di Dispatcher, inclusi il filtraggio e la trasmissione dei messaggi dalla cache.
DEBUG
WARN
ERROR
Adobe Cloud Manager consente di scaricare i registri, per giorno, tramite l’azione Scarica registri di un ambiente.
Questi registri possono essere scaricati e ispezionati tramite qualsiasi strumento di analisi dei registri.
Adobe Cloud Manager supporta l’accesso ai registri AEM as a Cloud Service tramite CLI ADOBE I/O con Plug-in di Cloud Manager per CLI Adobe I/O.
In primo luogo, configurare l’Adobe I/O con il plug-in di Cloud Manager.
Assicurati di aver identificato l’ID del programma e l’ID dell’ambiente pertinenti e utilizza list-available-log-options per elencare le opzioni di registro utilizzate per tail o scaricare log.
$ aio cloudmanager:list-programs
Program Id Name Enabled
14304 Program 1 true
11454 Program 2 true
11502 Program 3 true
$ aio config:set cloudmanager_programid <PROGRAM ID>
$ aio cloudmanager:list-environments
Environment Id Name Type Description
22295 program-3-dev dev
22310 program-3-prod prod
22294 program-3-stage stage
$ aio cloudmanager:list-available-log-options <ENVIRONMENT ID>
Environment Id Service Name
22295 author aemaccess
22295 author aemerror
22295 author aemrequest
22295 publish aemaccess
22295 publish aemerror
22295 publish aemrequest
22295 dispatcher httpdaccess
22295 dispatcher httpderror
22295 dispatcher aemdispatcher
Adobe I/O CLI consente di visualizzare i registri in tempo reale da AEM as a Cloud Service utilizzando tail-logs comando. La coda è utile per osservare l’attività di registro in tempo reale mentre le azioni vengono eseguite nell’ambiente as a Cloud Service dell’AEM.
$ aio config:set cloudmanager_programid <PROGRAM ID>
$ aio cloudmanager:tail-logs <ENVIRONMENT ID> <SERVICE> <NAME>
Altri strumenti per riga di comando, ad esempio grep
può essere utilizzato insieme a tail-logs
per isolare le dichiarazioni di registro di interesse, ad esempio:
$ aio cloudmanager:tail-logs 12345 author | grep com.example.MySlingModel
… visualizza solo le istruzioni di registro generate da com.example.MySlingModel
o contengono quella stringa.
Adobe I/O CLI consente di scaricare i registri dall’AEM as a Cloud Service utilizzando download-logs). Questo fornisce lo stesso risultato finale del download dei registri dall’interfaccia utente web di Cloud Manager, con la differenza che download-logs
Il comando consolida i registri tra giorni, in base al numero di giorni richiesti per i registri.
$ aio config:set cloudmanager_programid <PROGRAM ID>
$ aio cloudmanager:download-logs <ENVIRONMENT> <SERVICE> <NAME> <DAYS>
I registri in AEM as a Cloud Service hanno più pod che scrivono istruzioni di registro in essi. Poiché più istanze AEM scrivono nello stesso file di registro, è importante comprendere come analizzare e ridurre i disturbi durante il debug. Per spiegare, le seguenti operazioni aemerror
viene utilizzato lo snippet di registro:
01.01.2020 12:00:00.000 [cm-p12345-e56789-aem-author-abcdefg-1111] *DEBUG* [qtp2078364989-269] com.example.components.impl.ExampleModelImpl Preparing to collect resources
01.01.2020 12:00:01.002 [cm-p12345-e56789-aem-author-abcdefg-2222] *WARN* [qtp40782847611-87] com.example.services.impl.ExampleServiceImpl Unable to resolve resource [ /content/example ] to a resource. Aborting.
01.01.2020 12:00:02.003 [cm-p12345-e56789-aem-author-abcdefg-1111] *ERROR* [qtp2078364989-269] com.example.components.impl.ExampleModelImpl Unable to collect any resources
Utilizzando gli ID del pod, il punto dati dopo la data e l’ora, i registri possono essere fascicolati dal pod o dall’istanza AEM all’interno del servizio, facilitando la tracciatura e la comprensione dell’esecuzione del codice.
Pod cm-p12345-e56789-aem-author-abcdefg-1111
01.01.2020 12:00:00.000 [cm-p12345-e56789-aem-author-abcdefg-1111] *DEBUG* [qtp2078364989-269] com.example.components.impl.ExampleModelImpl Preparing to collect resources
01.01.2020 12:00:02.003 [cm-p12345-e56789-aem-author-abcdefg-1111] *ERROR* [qtp2078364989-269] com.example.components.impl.ExampleModelImpl Unable to collect any resources
Pod cm-p12345-e56789-aem-author-abcdefg-2222
01.01.2020 12:00:01.002 [cm-p12345-e56789-aem-author-abcdefg-2222] *WARN* [qtp2078364989-269] com.example.services.impl.ExampleServiceImpl Unable to resolve resource [ /content/example ] to a resource. Aborting.
Le linee guida generali di Adobe sui livelli di registro per l’ambiente AEM as a Cloud Service sono:
DEBUG
DEBUG
WARN
ERROR
Impostando il livello di registro più appropriato per ogni tipo di ambiente con AEM as a Cloud Service, i livelli di registro vengono mantenuti nel codice
…e quindi richiedono una distribuzione per cambiare.
Un’alternativa all’impostazione di livelli di registro Java statici noti per ogni ambiente consiste nell’utilizzare l’AEM Cloud Service come livello di variabili specifiche per l’ambiente per parametrizzare i livelli di log, consentendo la modifica dinamica dei valori tramite Adobe I/O di CLI con il plug-in Cloud Manager.
A tal fine, è necessario aggiornare le configurazioni OSGi di registrazione per utilizzare segnaposto di variabili specifici per l’ambiente. Valori predefiniti per i livelli di registro deve essere impostato come da Adobe di raccomandazioni. Ad esempio:
/apps/example/config/org.apache.sling.commons.log.LogManager.factory.config~example.cfg.json
{
...
"org.apache.sling.commons.log.names": ["com.example"],
"org.apache.sling.commons.log.level": "$[env:LOG_LEVEL;default=DEBUG]"
...
}
Questo approccio presenta aspetti negativi che devono essere presi in considerazione:
Le variabili specifiche dell’ambiente non funzionano per le configurazioni del server web Apache o del registro di Dispatcher, in quanto non sono configurate tramite la configurazione OSGi.