Show Menu
ARGOMENTI×

Registrazione

AEM come Cloud Service è una piattaforma che consente ai clienti di includere codice personalizzato per creare esperienze univoche per la propria base di clienti. In questo senso, la registrazione è una funzione fondamentale per eseguire il debug e comprendere l'esecuzione del codice sullo sviluppo locale e gli ambienti cloud, in particolare l'AEM come un ambiente di sviluppo Cloud Service.
AEM livelli di registrazione e di registro vengono gestiti in file di configurazione memorizzati come parte del progetto AEM in Git e distribuiti come parte del progetto AEM tramite Cloud Manager. L'accesso AEM come Cloud Service può essere suddiviso in due set logici:
  • Registrazione AEM, che esegue la registrazione a livello di applicazione AEM
  • Registrazione Apache HTTPD Web Server/Dispatcher, che esegue la registrazione del server Web e di Dispatcher sul livello di pubblicazione.

Registrazione AEM

La registrazione a livello di applicazione AEM è gestita da tre registri:
  1. AEM registri Java, che eseguono il rendering delle istruzioni di registrazione Java per l'applicazione AEM.
  2. Registri di richieste HTTP, che registrano le informazioni sulle richieste HTTP e le risposte fornite da AEM
  3. Registri di accesso HTTP, quali informazioni di riepilogo del registro e richieste HTTP inviate da AEM
Le richieste HTTP servite dalla cache Dispatcher del livello di pubblicazione o dalla rete CDN upstream non vengono riportate in questi registri.

Registrazione Java AEM

AEM come Cloud Service fornisce l'accesso alle istruzioni di registro Java. Gli sviluppatori di applicazioni per AEM devono seguire le best practice generali di registrazione Java, registrare le relative istruzioni sull'esecuzione di codice personalizzato, ai seguenti livelli di registro:
Ambiente AEM Livello registro Descrizione Disponibilità dell'istruzione del registro
Sviluppo DEBUG Descrive cosa accade nell'applicazione. Quando la registrazione DEBUG è attiva, le istruzioni che forniscono un'immagine chiara delle attività che si verificano e tutti i parametri chiave che influenzano l'elaborazione vengono registrate.
  • Sviluppo locale
  • Sviluppo
Area di visualizzazione AVVISO Descrive le condizioni che possono diventare errori. Quando la registrazione WARN è attiva, vengono registrate solo le istruzioni che indicano i condizionatori che si stanno avvicinando alla sub-ottimizzazione.
  • Sviluppo locale
  • Sviluppo
  • Area di visualizzazione
Produzione ERRORE Descrive le condizioni che indicano un errore e che devono essere risolte. Quando la registrazione degli errori è attiva, vengono registrate solo le istruzioni che indicano gli errori. Le istruzioni del registro degli errori indicano un problema grave che dovrebbe essere risolto il prima possibile.
  • Sviluppo locale
  • Sviluppo
  • Area di visualizzazione
  • Produzione
Sebbene la registrazione Java supporti diversi altri livelli di granularità della registrazione, AEM come Cloud Service consiglia di utilizzare i tre livelli descritti in precedenza.
AEM livelli di registro vengono impostati per tipo di ambiente tramite la configurazione OSGi, che a sua volta si impegna per Git, e distribuiti tramite Cloud Manager per AEM come Cloud Service. Per questo motivo, è meglio mantenere le istruzioni di registro coerenti e ben note per i tipi di ambiente, al fine di garantire che i log disponibili tramite AEM come Cloud Service siano disponibili al livello di registro ottimale senza richiedere la ridistribuzione dell'applicazione con la configurazione aggiornata del livello di registro.
Esempio di output del registro
22.06.2020 18:33:30.120 [cm-p12345-e6789-aem-author-86657cbb55-xrnzq] *ERROR* [qtp501076283-1809] io.prometheus.client.dropwizard.DropwizardExports Failed to get value from Gauge
22.06.2020 18:33:30.229 [cm-p12345-e6789-aem-author-86657cbb55-xrnzq] *INFO* [qtp501076283-1805] org.apache.sling.auth.core.impl.SlingAuthenticator getAnonymousResolver: Anonymous access not allowed by configuration - requesting credentials
22.06.2020 18:33:30.370 [cm-p12345-e6789-aem-author-86657cbb55-xrnzq] *INFO* [73.91.59.34 [1592850810364] GET /libs/granite/core/content/login.html HTTP/1.1] org.apache.sling.i18n.impl.JcrResourceBundle Finished loading 0 entries for 'en_US' (basename: <none>) in 4ms
22.06.2020 18:33:30.372 [cm-p12345-e6789-aem-author-86657cbb55-xrnzq] *INFO* [FelixLogListener] org.apache.sling.i18n Service [5126, [java.util.ResourceBundle]] ServiceEvent REGISTERED
22.06.2020 18:33:30.372 [cm-p12345-e6789-aem-author-86657cbb55-xrnzq] *WARN* [73.91.59.34 [1592850810364] GET /libs/granite/core/content/login.html HTTP/1.1] libs.granite.core.components.login.login$jsp j_reason param value 'unknown' cannot be mapped to a valid reason message: ignoring

Formato registro
Data e ora 29.04.2020 21:50:13.398
AEM come ID nodo Cloud Service [cm-p1234-e5678-aem-author-59555cb5b8-q7l9s]
Livello registro DEBUG
Thread qtp2130572036-1472
Java, classe com.example.approval.workflow.impl.CustomApprovalWorkflow
Messaggio registro Nessun approver specificato, impostazione predefinita per [ gruppo di utenti di Creative Approvers ]

Registratori di configurazione

AEM registri Java sono definiti come configurazione OSGi, e quindi indirizzati AEM specifici come ambienti Cloud Service di utilizzando le cartelle in modalità di esecuzione.
Configurare la registrazione Java per i pacchetti Java personalizzati tramite le configurazioni OSGi per la fabbrica Sling LogManager. Esistono due proprietà di configurazione supportate:
OSGi, proprietà Configuration
Descrizione
org.apache.sling.commons.log.names
I pacchetti Java per i quali raccogliere le istruzioni di registro.
org.apache.sling.commons.log.level
Il livello di registro a cui registrare i pacchetti Java, specificato da org.apache.sling.commons.log.names
La modifica di altre proprietà di configurazione LogManager OSGi potrebbe causare problemi di disponibilità in AEM come Cloud Service.
Di seguito sono riportati alcuni esempi delle configurazioni di registrazione consigliate (che utilizzano il pacchetto Java segnaposto di com.example ) per i tre AEM come tipi di ambiente di Cloud Service.

Sviluppo

/apps/my-app/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": "debug"
}

Stadio

/apps/my-app/config.stage/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": "warn"
}

Produzione

/apps/my-app/config.prod/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": "error"
}

Registrazione richiesta HTTP AEM

AEM come registrazione di richieste HTTP fornisce informazioni approfondite sulle richieste HTTP effettuate a AEM e le relative risposte HTTP in ordine di tempo. Questo registro è utile per comprendere le richieste HTTP effettuate per AEM e l’ordine in cui sono elaborate e a cui hanno risposto.
La chiave per comprendere questo registro è la mappatura delle coppie di richieste e risposte HTTP in base agli ID, indicati dal valore numerico tra parentesi. Spesso le richieste e le risposte corrispondenti hanno altre richieste HTTP e risposte inserite nel registro.
Esempio di registro
29/Apr/2020:19:14:21 +0000 [137] -> POST /conf/global/settings/dam/adminui-extension/metadataprofile/ HTTP/1.1 [cm-p1234-e5678-aem-author-59555cb5b8-q7l9s]
...
29/Apr/2020:19:14:22 +0000 [139] -> GET /mnt/overlay/dam/gui/content/processingprofilepage/metadataprofiles/editor.html/conf/global/settings/dam/adminui-extension/metadataprofile/main HTTP/1.1 [cm-p1234-e5678-aem-author-59555cb5b8-q7l9s]
...
29/Apr/2020:19:14:21 +0000 [137] <- 201 text/html 111ms [cm-p1234-e5678-aem-author-59555cb5b8-q7l9s]
...
29/Apr/2020:19:14:22 +0000 [139] <- 200 text/html;charset=utf-8 637ms [cm-p1234-e5678-aem-author-59555cb5b8-q7l9s]

Formato registro
Data e ora 29/Apr/2020:19:14:21 +0000
ID coppia richiesta/risposta [137]
Metodo HTTP POST
URL /conf/global/settings/dam/adminui-extension/metadata-profile/
Protocollo HTTP/1.1
AEM come ID nodo Cloud Service [cm-p1234-e5678-aem-author-59555cb5b8-q7l9s]

Configurazione del registro

Il registro AEM richieste HTTP non è configurabile in AEM come Cloud Service.

Registrazione AEM accesso HTTP

AEM come registrazione di accesso HTTP Cloud Service, vengono visualizzate le richieste HTTP in ordine temporale. Ogni voce di registro rappresenta la richiesta HTTP che accede a AEM.
Questo registro è utile per comprendere rapidamente a quali richieste HTTP vengono inviate per AEM, se riuscite guardando il codice di stato della risposta HTTP corrispondente e per quanto tempo è necessario completare la richiesta HTTP. Questo registro può essere utile anche per eseguire il debug dell'attività di un utente specifico filtrando le voci di registro per Utenti.
Esempio di output del registro
cm-p1234-e26813-aem-author-59555cb5b8-8kgr2 - example@adobe.com 30/Apr/2020:17:37:14 +0000  "GET /libs/granite/ui/references/clientlibs/references.lc-5188e85840c529149e6cd29d94e74ad5-lc.min.css HTTP/1.1" 200 1141 "https://author-p10711-e26813.adobeaemcloud.com/mnt/overlay/dam/gui/content/assets/metadataeditor.external.html?item=/content/dam/en/images/example.jpeg&_charset_=utf8" "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/81.0.4044.122 Safari/537.36"
cm-p1234-e26813-aem-author-59555cb5b8-8kgr2 - example@adobe.com 30/Apr/2020:17:37:14 +0000  "GET /libs/dam/gui/coral/components/admin/customthumb/clientlibs.lc-60e4443805c37afa0c74b674b141f1df-lc.min.css HTTP/1.1" 200 809 "https://author-p10711-e26813.adobeaemcloud.com/mnt/overlay/dam/gui/content/assets/metadataeditor.external.html?item=/content/dam/en/images/example.jpeg&_charset_=utf8" "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/81.0.4044.122 Safari/537.36"
cm-p1234-e26813-aem-author-59555cb5b8-8kgr2 - example@adobe.com 30/Apr/2020:17:37:14 +0000  "GET /libs/dam/gui/coral/components/admin/metadataeditor/clientlibs/metadataeditor.lc-4a2226d8232f8b7ab27d24820b9ddd64-lc.min.js HTTP/1.1" 200 7965 "https://author-p10711-e26813.adobeaemcloud.com/mnt/overlay/dam/gui/content/assets/metadataeditor.external.html?item=/content/dam/en/images/example.jpeg&_charset_=utf8" "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/81.0.4044.122 Safari/537.36"

Formato registro
AEM come ID nodo Cloud Service cm-p1235-e2644-aem-author-59555cb5b8-8kgr2
Indirizzo IP del client -
User myuser@adobe.com
Data e ora 30/Apr/2020:17:37:14 +000
Metodo HTTP GET
URL /libs/granite/ui/references/clientlibs/references.lc-5188e85840c529149e6cd29d94e74ad5-lc.min.css
Protocollo HTTP/1.1
Stato della risposta HTTP 200
Tempo di richiesta HTTP in millisecondi 1141
Referrer "https://author-p1234-e4444.adobeaemcloud.com/mnt/overlay/dam/gui/content/assets/metadataeditor.external.html?item=/content/dam/wknd/en/adventures/surf-camp-in-costa-rica/adobestock_266405335.jpeg&_charset_=utf8"
Agente utente "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_4) AppleWebKit/537.36 (KHTML, come Gecko) Chrome/81.0.4044.122 Safari/537.36"

Configurazione del registro di accesso HTTP

Il registro di accesso HTTP non è configurabile in AEM come Cloud Service.

Registrazione di Apache Web Server e Dispatcher

AEM come Cloud Service fornisce tre registri per i server Web Apache e il livello dispatcher nella pubblicazione:
  • Registro di accesso al server Web Apache HTTPD
  • Registro errori server Web Apache HTTPD
  • Registro Dispatcher
Questi registri sono disponibili solo per il livello Pubblica.
Questo set di registri fornisce informazioni approfondite sulle richieste HTTP al AEM come livello di pubblicazione Cloud Service prima che tali richieste arrivino all’applicazione AEM. Questo è importante perché, idealmente, la maggior parte delle richieste HTTP ai server dei livelli di pubblicazione è gestita da contenuto memorizzato nella cache dal server Web Apache HTTPD e AEM Dispatcher, e non arriva mai all'applicazione AEM stessa. Pertanto, non esistono istruzioni di registro per queste richieste nei registri AEM Java, Request o Access.

Registro di accesso al server Web Apache HTTPD

Il registro di accesso al server Web Apache HTTP fornisce istruzioni per ogni richiesta HTTP che raggiunge il server Web/Dispatcher del livello Publish. Notate che le richieste servite da una CDN upstream non vengono riportate in questi registri.
Consultate le informazioni sul formato del registro errori nella documentazione apache ufficiale.
Esempio di output del registro
cm-p1234-e5678-aem-publish-b86c6b466-qpfvp - - 17/Jul/2020:09:14:41 +0000  "GET /etc.clientlibs/wknd/clientlibs/clientlib-site/resources/images/favicons/favicon-32.png HTTP/1.1" 200 715 "-" "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:78.0) Gecko/20100101 Firefox/78.0"
cm-p1234-e5678-aem-publish-b86c6b466-qpfvp - - 17/Jul/2020:09:14:41 +0000  "GET /etc.clientlibs/wknd/clientlibs/clientlib-site/resources/images/favicons/favicon-512.png HTTP/1.1" 200 9631 "-" "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:78.0) Gecko/20100101 Firefox/78.0"
cm-p1234-e5678-aem-publish-b86c6b466-qpfvp - - 17/Jul/2020:09:14:42 +0000  "GET /etc.clientlibs/wknd/clientlibs/clientlib-site/resources/images/country-flags/US.svg HTTP/1.1" 200 810 "https://publish-p6902-e30226.adobeaemcloud.com/content/wknd/us/en.html" "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:78.0) Gecko/20100101 Firefox/78.0"

Formato registro
AEM come ID nodo del servizio cloud cm-p1234-e26813-aem-publish-5c787687c-lqlxr
Indirizzo IP del client -
User -
Data e ora 01/maggio/2020:00:09:46 +000
Metodo HTTP GET
URL /content/example.html
Protocollo HTTP/1.1
Stato della risposta HTTP 200
Dimensione 310
Referente -
Agente utente "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_4) AppleWebKit/537.36 (KHTML, come Gecko) Chrome/81.0.4044.122 Safari/537.36"

Configurazione del registro di accesso al server Web Apache HTTPD

Questo registro non è configurabile in AEM come Cloud Service.

Registro errori server Web Apache HTTPD

Il registro errori del server Web Apache HTTP fornisce istruzioni per ogni errore nel server Web/Dispatcher del livello Publish.
Consultate le informazioni sul formato del registro errori nella documentazione apache ufficiale.
Esempio di output del registro
Fri Jul 17 02:19:48.093820 2020 [mpm_worker:notice] [pid 1:tid 140272153361288] [cm-p1234-e30226-aem-publish-b86c6b466-b9427] AH00292: Apache/2.4.43 (Unix) Communique/4.3.4-20200424 mod_qos/11.63 configured -- resuming normal operations
Fri Jul 17 02:19:48.093874 2020 [core:notice] [pid 1:tid 140272153361288] [cm-p1234-e30226-aem-publish-b86c6b466-b9427] AH00094: Command line: 'httpd -d /etc/httpd -f /etc/httpd/conf/httpd.conf -D FOREGROUND -D ENVIRONMENT_PROD'
Fri Jul 17 02:29:34.517189 2020 [mpm_worker:notice] [pid 1:tid 140293638175624] [cm-p1234-e30226-aem-publish-b496f64bf-5vckp] AH00295: caught SIGTERM, shutting down

Formato registro
Data e ora Venerdì 17 Luglio 02:16:42.608913 2020
Livello evento [mpm_Worker:Notice]
ID processo [pid 1:tid 140715149343624]
Nome contenitore [cm-p1234-e56789-aem-publish-b86c6b466-qpfvp]
Messaggio AH00094: Riga di comando: 'httpd -d /etc/httpd -f /etc/httpd/conf/httpd.conf -D FOREGROUND -D

Configurazione del registro errori del server Web Apache HTTPD

I livelli di registro mod_rewrite sono definiti dalla variabile REWRITE_LOG_LEVEL presente nel file conf.d/variables/global.var .
Può essere impostato su Errore, Avverti, Informazioni, Debug e Trace1 - Trace8, con il valore predefinito Avverti. Per eseguire il debug delle regole di riscrittura, è consigliabile aumentare il livello di registro a Trace2.
Per ulteriori informazioni, consulta la documentazione del modulo mod_rewrite.
Per impostare il livello di registro per l'ambiente, utilizzare il ramo condizionale appropriato nel file global.var, come descritto di seguito:
Define REWRITE_LOG_LEVEL Debug
  
<IfDefine ENVIRONMENT_STAGE>
  ...
  Define REWRITE_LOG_LEVEL Warn
  ...
</IfDefine>
<IfDefine ENVIRONMENT_PROD>
  ...
  Define REWRITE_LOG_LEVEL Error
  ...
</IfDefine>

Registro Dispatcher

Esempio
[17/Jul/2020:23:48:06 +0000] [I] [cm-p12904-e25628-aem-publish-6c5f7c9dbd-mzcvr] "GET /content/wknd/us/en/adventures.html" - 475ms [publishfarm/0] [action miss] "publish-p12904-e25628.adobeaemcloud.com"
[17/Jul/2020:23:48:07 +0000] [I] [cm-p12904-e25628-aem-publish-6c5f7c9dbd-mzcvr] "GET /content/wknd/us/en/adventures/climbing-new-zealand/_jcr_content/root/responsivegrid/carousel/item_1571266094599.coreimg.jpeg/1473680817282/sport-climbing.jpeg" 302 10ms [publishfarm/0] [action none] "publish-p12904-e25628.adobeaemcloud.com"
[17/Jul/2020:23:48:07 +0000] [I] [cm-p12904-e25628-aem-publish-6c5f7c9dbd-mzcvr] "GET /content/wknd/us/en/adventures/ski-touring-mont-blanc/_jcr_content/root/responsivegrid/carousel/item_1571168419252.coreimg.jpeg/1572047288089/adobestock-238230356.jpeg" 302 11ms [publishfarm/0] [action none] "publish-p12904-e25628.adobeaemcloud.com"

Formato registro
Data e ora [17/lug/2020:23:48:16 +000]
Nome contenitore [cm-p12904-e25628-aem-publish-6c5f7c9dbd-mzcvr]
Protocollo GET
URL /content/experience-fragments/wknd/language-masters/en/contributors/sofia-sjoeberg/master/_jcr_content/root/responsivegrid/image.coreimg.100.500.jpeg/1572236359031/ayo-ogunseinde-237739.jpeg
Codice stato risposta Dispatcher /content/experience-fragments/wknd/language-masters/en/contributors/sofia-sjoeberg/master/_jcr_content/root/responsivegrid/image.coreimg.100.500.jpeg/1572236359031/ayo-ogunseinde-237739.jpeg
Durata 1949ms
Agriturismo [publishfarm/0]
Stato cache [azione mancante]
Host "publish-p12904-e25628.adobeaemcloud.com"

Configurazione del registro errori Dispatcher

I livelli del registro del dispatcher sono definiti dalla variabile DISP_LOG_LEVEL presente nel file conf.d/variables/global.var .
Può essere impostato su Errore, Avverti, Informazioni, Debug e Trace1, con il valore predefinito Avverti.
Sebbene la registrazione Dispatcher supporti diversi altri livelli di granularità della registrazione, il AEM come Cloud Service consiglia di utilizzare i livelli descritti di seguito.
Per impostare il livello di registro per l'ambiente, utilizzare il ramo condizionale appropriato nel global.var file, come descritto di seguito:
Define DISP_LOG_LEVEL Debug
  
<IfDefine ENVIRONMENT_STAGE>
  ...
  Define DISP_LOG_LEVEL Warn
  ...
</IfDefine>
<IfDefine ENVIRONMENT_PROD>
  ...
  Define DISP_LOG_LEVEL Error
  ...
</IfDefine>

Come accedere ai registri

Ambienti cloud

AEM come Cloud Service di registri per i servizi cloud è possibile accedere sia scaricando tramite l'interfaccia di Cloud Manager sia inviando i registri alla riga di comando utilizzando l'interfaccia riga di comando I/O Adobe. Per ulteriori informazioni, consulta la documentazione di registrazione di Cloud Manager.

SDK locale

AEM come Cloud Service SDK fornisce file di registro per supportare lo sviluppo locale.
AEM file di registro si trovano nella cartella crx-quickstart/logs , dove è possibile visualizzare i seguenti file di registro:
  • AEM registro Java: error.log
  • AEM registro delle richieste HTTP: request.log
  • AEM registro di accesso HTTP: access.log
I registri dei livelli Apache, incluso il dispatcher, si trovano nel contenitore Docker che contiene l’Dispatcher. Per informazioni sull’avvio dell’Dispatcher, consultate la documentazione di Dispatcher.
Per recuperare i file di registro:
  1. Nella riga di comando, digitare docker ps per elencare i contenitori
  2. Per accedere al contenitore, digitare " docker exec -it <container> /bin/sh ", dove <container> corrisponde all'ID del contenitore del dispatcher dal passaggio precedente
  3. Andate alla directory principale della cache in /mnt/var/www/html
  4. I log sono sotto /etc/httpd/logs
  5. Inspect i registri: sono accessibili nella cartella XYZ, dove è possibile visualizzare i seguenti file di registro:
    • Registro di accesso al server Web Apache HTTPD - httpd_access.log
    • Registri di errore del server Web Apache HTTPD - httpd_error.log
    • Registri Dispatcher - dispatcher.log
I registri vengono inoltre stampati direttamente sull'uscita terminale. Nella maggior parte dei casi, questi registri devono essere DEBUG, che può essere realizzato trasmettendo il livello Debug come parametro durante l'esecuzione di Docker. Ad esempio:
DISP_LOG_LEVEL=Debug ./bin/docker_run.sh out docker.for.mac.localhost:4503 8080

Debug di fase e produzione

In circostanze eccezionali, è necessario modificare i livelli di registro per eseguire il log a una granularità maggiore negli ambienti Stage o Produzione.
Anche se questo è possibile, richiede modifiche ai livelli di registro nei file di configurazione in Git da Avverti ed Errore a Debug, ed esegue una distribuzione da AEM come Cloud Service per registrare le modifiche di configurazione con gli ambienti.
A seconda del traffico e della quantità di istruzioni di registro scritte da Debug, questo può causare un impatto negativo sulle prestazioni sull'ambiente, pertanto si consiglia di modificare i livelli di debug di Stage e Produzione:
  • Fatto con prudenza, e solo quando assolutamente necessario
  • Ripristinati i livelli appropriati e ridistribuiti il prima possibile

Registri splunk

I clienti che dispongono di account Splunk possono richiedere tramite ticket di assistenza clienti che i loro registri di Cloud Service AEM vengano inoltrati all'indice appropriato. I dati di registrazione sono equivalenti a quelli disponibili tramite i download del registro di Cloud Manager, ma i clienti potrebbero trovare utile sfruttare le funzionalità di query disponibili nel prodotto Splunk.
La larghezza di banda di rete associata ai registri inviati a Splunk è considerata parte dell'utilizzo di I/O di rete del cliente.

Abilitazione dell'inoltro splunk

Nella richiesta di assistenza, i clienti devono indicare:
  • Host Splunk
  • Indice Splunk
  • La porta Splunk
  • Il token Splunk HEC. Per ulteriori informazioni, consulta questa pagina .
Le proprietà di cui sopra devono essere specificate per ciascuna combinazione di programma/tipo di ambiente pertinente. Ad esempio, se un cliente voleva un ambiente di sviluppo, staging e produzione, dovrebbe fornire tre serie di informazioni, come indicato di seguito.
L'inoltro splunk per gli ambienti di programmi sandbox non è supportato.
Di seguito è riportato un esempio di richiesta di assistenza clienti:
Programma 123, Production Env
  • Host splunk: splunk-hec-ext.acme.com
  • Indice splunk: acme_123prod (il cliente può scegliere qualsiasi convenzione di denominazione)
  • Porta splunk: 443
  • Token Splunk HEC: ABC123
Program 123, Stage Env
  • Host splunk: splunk-hec-ext.acme.com
  • Indice splunk: acme_123stage
  • Porta splunk: 443
  • Token Splunk HEC: ABC123
Programma 123, Dev Envs
  • Host splunk: splunk-hec-ext.acme.com
  • Indice splunk: acme_123dev
  • Porta splunk: 443
  • Token Splunk HEC: ABC123
Può essere sufficiente che lo stesso indice Splunk venga utilizzato per ogni ambiente, nel qual caso il aem_env_type campo può essere utilizzato per differenziare in base ai valori dev, stage e prod. In presenza di più ambienti di sviluppo, è possibile utilizzare anche il aem_env_id campo. Alcune organizzazioni possono scegliere un indice separato per i registri dell'ambiente di produzione se l'indice associato limita l'accesso a un set ridotto di utenti Splunk.
Esempio di voce di registro:
aem_env_id: 1242
aem_env_type: dev
aem_program_id: 12314
aem_tier: author
file_path: /var/log/aem/error.log
host: 172.34.200.12 
level: INFO
msg: [FelixLogListener] com.adobe.granite.repository Service [5091, [org.apache.jackrabbit.oak.api.jmx.SessionMBean]] ServiceEvent REGISTERED
orig_time: 16.07.2020 08:35:32.346
pod_name: aemloggingall-aem-author-77797d55d4-74zvt
splunk_customer: true