Show Menu
SUJETS×

Journalisation

La plate-forme AEM as a Cloud Service permet aux clients d’inclure du code personnalisé destiné à créer des expériences incomparables pour leurs propres bases de clients. Dans cette optique, la journalisation est une fonction essentielle pour déboguer et comprendre l’exécution du code sur le développement local, ainsi que les environnements cloud, en particulier les environnements de développement AEM as a Cloud Service.
Les niveaux de journal et de journalisation AEM sont gérés dans des fichiers de configuration stockés au sein du projet AEM dans Git, et déployés dans le cadre du projet AEM via Cloud Manager. La journalisation dans AEM as a Cloud Service peut être divisée en deux ensembles logiques :
  • La journalisation au niveau de l’application AEM.
  • La journalisation de serveur web Apache HTTPD/Dispatcher au niveau Publication.

Journalisation AEM

La journalisation au niveau de l’application AEM est gérée par trois journaux :
  1. Les journaux Java AEM, qui consignent les instructions de journalisation Java pour l’application AEM.
  2. Les journaux de requêtes HTTP, qui consignent les informations sur les requêtes HTTP et les réponses fournies par AEM
  3. Les journaux d’accès HTTP, qui consignent les informations résumées et les requêtes HTTP diffusées par AEM
Les requêtes HTTP diffusées à partir du cache Dispatcher du niveau Publication ou du réseau de diffusion de contenu en amont ne sont pas reflétées dans ces journaux

Journalisation Java AEM

AEM as a Cloud Service donne accès aux instructions de journal Java. Les développeurs d’applications pour AEM doivent suivre les bonnes pratiques générales en matière de consignation pour Java, en consignant les instructions pertinentes concernant l’exécution du code personnalisé, aux niveaux de journal suivants :
Environnement AEM Niveau de journal Description Disponibilité des instructions de journal
Développement DEBUG Décrit ce qui se passe dans l’application. Lorsque la journalisation DEBUG est active, les instructions fournissant une image claire des activités survenues ainsi que les paramètres clés qui affectent le traitement sont consignés.
  • Développement local
  • Développement
Évaluation WARN Décrit les conditions susceptibles de devenir des erreurs. Lorsque la journalisation WARN est active, seules les instructions indiquant des conditions qui s’approchent de performances sous-optimales sont consignées.
  • Développement local
  • Développement
  • Évaluation
Production ERREUR Décrit les conditions qui indiquent un échec et doivent être résolues. Lorsque la journalisation ERROR est active, seules les instructions indiquant des échecs sont consignées. Les instructions de journal ERROR indiquent un problème grave qui doit être résolu le plus tôt possible.
  • Développement local
  • Développement
  • Évaluation
  • Production
Bien que la journalisation Java prenne en charge plusieurs autres niveaux de granularité de la journalisation, nous recommandons d’utiliser les trois niveaux décrits ci-dessus pour AEM as a Cloud Service.
Les niveaux de journalisation AEM sont définis par type d’environnement via la configuration OSGi, qui à leur tour sont validés dans Git, et déployés sur AEM as a Cloud Service via Cloud Manager. C’est pourquoi il est préférable de conserver des instructions de journal cohérentes et bien connues pour les types d’environnements, afin de s’assurer que les journaux disponibles par l’intermédiaire d’AEM as a Cloud Service sont disponibles au niveau de journal optimal sans avoir à redéployer l’application avec la configuration de niveau de journal mise à jour.
Exemple de sortie de journal
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

Format du journal
Date et heure 29.04.2020 21:50:13.398
ID du nœud AEM as a Cloud Service [cm-p1234-e5678-aem-author-59555cb5b8-q7l9s]
Niveau de journal DEBUG
Thread qtp2130572036-1472
Classe Java com.example.approval.workflow.impl.CustomApprovalWorkflow
Message du journal Aucun approbateur spécifié, utilisation par défaut de [groupe d’utilisateurs Approbateurs du contenu créatif]

Enregistreurs de configuration

Les journaux Java AEM sont définis en tant que configuration OSGi et ciblent par conséquent des environnements AEM as a Cloud Service spécifiques en utilisant des dossiers en mode d’exécution.
Configurez la journalisation Java pour des packages Java personnalisés via des configurations OSGi pour Sling LogManager Factory. Deux propriétés de configuration sont prises en charge :
Propriété de configuration OSGi
Description
org.apache.sling.commons.log.names
Packages Java pour lesquels collecter les instructions de journal.
org.apache.sling.commons.log.level
Niveau de journal auquel consigner les packages Java, spécifié par org.apache.sling.commons.log.names.
La modification d’autres propriétés de configuration OSGi LogManager peut entraîner des problèmes de disponibilité dans AEM as a Cloud Service.
Vous trouverez ci-dessous des exemples de configurations de journalisation recommandées (à l’aide de l’espace réservé de package Java com.example ) pour les trois types d’environnements AEM as a Cloud Service.

Développement

/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"
}

Évaluation

/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"
}

Production

/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"
}

Journalisation des requêtes HTTP AEM

La journalisation des requêtes HTTP dans AEM as a Cloud Service fournit des informations sur les requêtes HTTP envoyées à AEM et leurs réponses HTTP par ordre d’arrivée. Ce journal permet de comprendre les requêtes HTTP envoyées à AEM ainsi que l’ordre dans lequel elles sont traitées et reçoivent une réponse.
La clé pour comprendre ce journal est de mapper les paires de requête HTTP et réponse selon leur ID, identifié par la valeur numérique entre crochets. Notez que, dans le journal, les différentes requêtes HTTP et leurs réponses se chevauchent souvent.
Exemple de journal
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]

Format du journal
Date et heure 29/Apr/2020:19:14:21 +0000
ID de paire de requête/réponse [137]
Méthode HTTP POST
URL /conf/global/settings/dam/adminui-extension/metadataprofile/
Protocole HTTP/1.1
ID du nœud AEM as a Cloud Service [cm-p1234-e5678-aem-author-59555cb5b8-q7l9s]

Configuration du journal

Le journal des requêtes HTTP AEM n’est pas configurable dans AEM as a Cloud Service.

Journalisation des accès HTTP AEM

La journalisation des accès HTTP dans AEM as a Cloud Service affiche les requêtes HTTP par ordre d’arrivée. Chaque entrée de journal représente la requête HTTP qui accède à AEM.
Ce journal est utile pour comprendre rapidement quelles requêtes HTTP sont envoyées à AEM, si elles réussissent (en examinant le code d’état de la réponse HTTP qui l’accompagne) et combien de temps la requête HTTP a duré. Ce journal peut également servir à déboguer une activité d’utilisateur spécifique en filtrant les entrées du journal par utilisateurs.
Exemple de sortie de journal
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"

Format du journal
ID du nœud AEM as a Cloud Service cm-p1235-e2644-aem-author-59555cb5b8-8kgr2
Adresse IP du client -
User myuser@adobe.com
Date et heure 30/Apr/2020:17:37:14 +0000
Méthode HTTP GET
URL /libs/granite/ui/references/clientlibs/references.lc-5188e85840c529149e6cd29d94e74ad5-lc.min.css
Protocole HTTP/1.1
Statut de réponse HTTP 200
Temps de requête HTTP en millisecondes 1141
Référent "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"
Agent utilisateur "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"

Configuration du journal d’accès HTTP

Le journal des accès HTTP n’est pas configurable dans AEM as a Cloud Service.

Journalisation de serveur web Apache et de Dispatcher

AEM as a Cloud Service fournit trois journaux pour les serveurs web Apache et la couche Dispatcher au niveau Publication :
  • Journal des accès au serveur web Apache HTTPD
  • Journal des erreurs du serveur web Apache HTTPD
  • Journal de Dispatcher
Notez que ces journaux ne sont disponibles que pour le niveau Publication.
Cet ensemble de journaux fournit des informations sur les requêtes HTTP envoyées au niveau Publication d’AEM as a Cloud Service avant que celles-ci n’atteignent l’application AEM. Il est important de comprendre cela, car, dans l’idéal, la plupart des requêtes HTTP envoyées aux serveurs de niveau Publication sont servies par du contenu mis en cache par le serveur web Apache HTTPD et le Dispatcher AEM, et n’atteignent jamais l’application AEM elle-même. Il n’existe donc aucune instruction de journal pour ces requêtes dans les journaux Java, de requêtes ou des accès d’AEM.

Journal des accès au serveur web Apache HTTPD

Le journal des accès au serveur web Apache HTTPD fournit des instructions pour chaque requête HTTP qui atteint le serveur web/Dispatcher du niveau Publication. Notez que les requêtes diffusées à partir d’un réseau CDN en amont ne sont pas reflétées dans ces journaux.
Consultez les informations sur le format du journal des erreurs dans la documentation officielle d’Apache .
Exemple de sortie de journal
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"

Format du journal
ID du nœud AEM as a Cloud Service cm-p1234-e26813-aem-publish-5c787687c-lqlxr
Adresse IP du client -
User -
Date et heure 01/May/2020:00:09:46 +0000
Méthode HTTP GET
URL /content/example.html
Protocole HTTP/1.1
Statut de réponse HTTP 200
Taille 310
Référent -
Agent utilisateur "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"

Configuration du journal des accès au serveur web Apache HTTPD

Ce journal n’est pas configurable dans AEM as a Cloud Service.

Journal des erreurs du serveur web Apache HTTPD

Le journal des erreurs du serveur web Apache HTTPD fournit des instructions pour chaque erreur dans le serveur web/Dispatcher du niveau Publication.
Consultez les informations sur le format du journal des erreurs dans la documentation officielle d’Apache .
Exemple de sortie de journal
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

Format du journal
Date et heure Fri Jul 17 02:16:42.608913 2020
Niveau d’événement [mpm_worker:notice]
ID du processus [pid 1:tid 140715149343624]
Nom du pod [cm-p1234-e56789-aem-publish-b86c6b466-qpfvp]
Message AH00094: Command line: 'httpd -d /etc/httpd -f /etc/httpd/conf/httpd.conf -D FOREGROUND -D

Configuration du journal des erreurs du serveur web Apache HTTPD

Les niveaux de journal mod_rewrite sont définis par la variable REWRITE_LOG_LEVEL dans le fichier conf.d/variables/global.var .
Elle peut être définie sur Error, Warn, Info, Debug et Trace1 à Trace8, avec la valeur par défaut Warn. Pour déboguer vos règles de réécriture (RewriteRules), il est recommandé de passer au niveau de journal Trace2.
Pour plus d’informations, consultez la documentation du module mod_rewrite .
Pour définir le niveau de journal par environnement, utilisez la branche conditionnelle appropriée dans le fichier global.var, comme décrit ci-dessous :
Define REWRITE_LOG_LEVEL Debug
  
<IfDefine ENVIRONMENT_STAGE>
  ...
  Define REWRITE_LOG_LEVEL Warn
  ...
</IfDefine>
<IfDefine ENVIRONMENT_PROD>
  ...
  Define REWRITE_LOG_LEVEL Error
  ...
</IfDefine>

Journal de Dispatcher

Exemple
[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"

Format du journal
Date et heure [17/Jul/2020:23:48:16 +0000]
Nom du pod [cm-p12904-e25628-aem-publish-6c5f7c9dbd-mzcvr]
Protocole 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
Code d’état de réponse de 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
Durée 1949ms
Ferme [publishfarm/0]
Statut du cache [action miss]
Hôte "publish-p12904-e25628.adobeaemcloud.com"

Configuration du journal des erreurs de Dispatcher

Les niveaux de journal de Dispatcher sont définis par la variable DISP_LOG_LEVEL dans le fichier conf.d/variables/global.var .
Elle peut être définie sur Error, Warn, Info, Debug et Trace1, avec la valeur par défaut Warn.
Bien que la journalisation de Dispatcher prenne en charge plusieurs autres niveaux de granularité de la journalisation, nous recommandons d’utiliser les niveaux décrits ci-dessous pour AEM as a Cloud Service.
Pour définir le niveau de journal par environnement, utilisez la branche conditionnelle appropriée dans le fichier global.var , comme décrit ci-dessous :
Define DISP_LOG_LEVEL Debug
  
<IfDefine ENVIRONMENT_STAGE>
  ...
  Define DISP_LOG_LEVEL Warn
  ...
</IfDefine>
<IfDefine ENVIRONMENT_PROD>
  ...
  Define DISP_LOG_LEVEL Error
  ...
</IfDefine>

Comment accéder aux journaux

Environnements cloud

Les journaux AEM as a Cloud Service pour les services cloud sont accessibles par téléchargement via l’interface de Cloud Manager ou en affichant leurs dernières lignes à l’aide de l’interface de ligne de commande Adobe I/O. Pour plus d’informations, voir la documentation sur la journalisation de Cloud Manager .

SDK local

Le SDK AEM as a Cloud Service fournit des fichiers journaux pour la prise en charge du développement local.
Les journaux AEM se trouvent dans le dossier crx-quickstart/logs , où vous pouvez afficher les journaux suivants :
  • Journal Java AEM : error.log
  • Journal des requêtes HTTP AEM : request.log
  • Journal des accès HTTP AEM : access.log
Les journaux de couche Apache, y compris de Dispatcher, se trouvent dans le conteneur Docker qui contient Dispatcher. Consultez la documentation de Dispatcher pour savoir comment le démarrer.
Pour récupérer les journaux :
  1. Sur la ligne de commande, tapez docker ps afin de répertorier vos conteneurs.
  2. Pour vous connecter au conteneur, tapez «  docker exec -it <container> /bin/sh  », où <container> est l’identifiant de conteneur Dispatcher de l’étape précédente.
  3. Accédez à la racine du cache sous /mnt/var/www/html .
  4. Les journaux se trouvent sous /etc/httpd/logs .
  5. Inspectez les journaux : ils sont accessibles sous le dossier XYZ, où vous pouvez afficher les journaux suivants :
    • Journal des accès au serveur web Apache HTTPD –  httpd_access.log
    • Journaux des erreur du serveur web Apache HTTPD –  httpd_error.log
    • Journaux de Dispatcher –  dispatcher.log
Les journaux sont également directement imprimés dans la sortie du terminal. La plupart du temps, ces journaux doivent être en mode DEBUG, ce qui peut être effectué en transmettant le niveau Debug comme paramètre lors de l’exécution de Docker. Par exemple :
DISP_LOG_LEVEL=Debug ./bin/docker_run.sh out docker.for.mac.localhost:4503 8080

Débogage dans les environnements de production et d’évaluation

Dans des circonstances exceptionnelles, il est nécessaire de modifier les niveaux de journalisation pour qu’ils soient plus précis dans les environnements d’évaluation ou de production.
Bien que cela soit possible, cela requiert des modifications des niveaux de journal dans les fichiers de configuration dans Git (en passant de Warn et Error à Debug), et l’exécution d’un déploiement sur AEM as a Cloud Service pour enregistrer ces modifications de configuration auprès des environnements.
Selon le trafic et la quantité d’instructions de journal écrites par Debug, cela peut avoir un impact négatif sur les performances de l’environnement. Il est donc recommandé que les modifications apportées aux niveaux de débogage Stage (pour l’environnement d’évaluation) et Production soient :
  • effectuées judicieusement, et uniquement lorsque cela est absolument nécessaire ;
  • annulées le plus tôt possible pour redéployer les niveaux appropriés.

Journaux Splunk

Les clients disposant d’un compte Splunk peuvent demander, via un ticket de service clientèle, que leurs journaux d’AEM as a Cloud Service soient transférés vers l’index approprié. Les données de journalisation sont équivalentes à celles disponibles par téléchargement des journaux de Cloud Manager, mais les clients peuvent tirer parti des fonctionnalités de requête disponibles dans le produit Splunk.
La bande passante réseau associée aux journaux envoyés à Splunk est considérée comme faisant partie de l’utilisation des E/S réseau du client.

Activation du transfert Splunk

Dans la demande d’assistance, les clients doivent indiquer :
  • l’hôte Splunk ;
  • l’index Splunk ;
  • le port Splunk ;
  • le jeton Splunk HEC. Pour plus d’informations, consultez cette page .
Les propriétés ci-dessus doivent être spécifiées pour chaque combinaison de type programme/environnement appropriée. Par exemple, si un client souhaite des environnements de développement, d’évaluation et de production, il doit fournir trois ensembles d’informations, comme indiqué ci-dessous.
Le transfert Splunk pour les environnements de programme de test Sandbox n’est pas pris en charge.
Vous trouverez ci-dessous un exemple de demande d’assistance :
Programme 123, environnement de production
  • Hôte Splunk : splunk-hec-ext.acme.com
  • Index Splunk : acme_123prod (le client peut choisir la convention d’affectation de nom qu’il souhaite)
  • Port Splunk : 443
  • Jeton Splunk HEC : ABC123
Programme 123, environnement d’évaluation
  • Hôte Splunk : splunk-hec-ext.acme.com
  • Index Splunk : acme_123stage
  • Port Splunk : 443
  • Jeton Splunk HEC : ABC123
Programme 123, environnements de développement
  • Hôte Splunk : splunk-hec-ext.acme.com
  • Index Splunk : acme_123dev
  • Port Splunk : 443
  • Jeton Splunk HEC : ABC123
Il peut suffire que le même index Splunk soit utilisé pour chaque environnement, auquel cas le champ aem_env_type peut être utilisé pour les distinguer à l’aide des valeurs dev, stage et prod. S’il existe plusieurs environnements de développement, le champ aem_env_id peut également être utilisé. Certaines organisations peuvent choisir un index distinct pour les journaux de l’environnement de production si l’index associé limite l’accès à un ensemble réduit d’utilisateurs Splunk.
Voici un exemple d’entrée de journal :
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