Journalisation logging
AEM vous offre la possibilité de configurer :
- paramètres globaux pour le service de journalisation central
- la journalisation des données de demande ; une configuration de journalisation spécialisée pour les informations de requête ;
- les paramètres spécifiques des services individuels ; par exemple, un fichier journal individuel et le format des messages du journal.
Il s’agit toutes de configurations OSGi.
Journalisation globale global-logging
Configuration de la journalisation Apache Sling est utilisé pour configurer l’enregistreur racine. Cela définit les paramètres globaux pour la connexion à AEM :
- niveau de journalisation
- l’emplacement du fichier journal central ;
- le nombre de versions à conserver
- la rotation de version (soit une taille maximale, soit un intervalle de temps)
- le format à utiliser lors de l’écriture des messages du journal
Enregistreurs et rédacteurs pour les services individuels loggers-and-writers-for-individual-services
En plus des paramètres de journalisation globale, AEM permet de configurer des paramètres spécifiques pour un service individuel :
- le niveau de journalisation spécifique
- l’emplacement du fichier journal individuel ;
- le nombre de versions à conserver
- la rotation de version (soit une taille maximale, soit un intervalle de temps)
- le format à utiliser lors de l’écriture des messages du journal
- l’enregistreur (le service OSGi fournissant les messages de journal)
Cela vous permet de canaliser les messages de journal pour un seul service dans un fichier distinct. Cela peut être particulièrement utile pendant le développement ou les tests, par exemple, si vous avez besoin d’un niveau de journalisation accru pour un service spécifique.
AEM utilise les éléments suivants pour écrire des messages de journal dans le fichier :
- Un Service OSGi (journal) écrit un message de journal.
- A Enregistreur de journalisation prend ce message et le formate selon vos spécifications.
- A Enregistreur de journalisation écrit tous ces messages dans le fichier physique que vous avez défini.
Ces éléments sont liés par les paramètres suivants pour les éléments appropriés :
-
Enregistreur (enregistreur de journalisation)
Définissez le ou les services qui génèrent les messages.
-
Fichier journal (enregistreur de journalisation)
Définissez le fichier physique pour stocker les messages du journal.
Ceci est utilisé pour lier un enregistreur de journalisation à un rédacteur de journalisation. La valeur doit être identique au même paramètre de la configuration du rédacteur de journalisation pour que la connexion s’effectue.
-
Fichier journal (rédacteur de journalisation)
Définissez le fichier physique dans lequel les messages du journal seront écrits.
La valeur doit être identique au même paramètre de la configuration du rédacteur de journalisation, sinon la correspondance ne s’effectue pas. S’il n’existe aucune correspondance, un rédacteur implicite est créé avec la configuration par défaut (rotation quotidienne du journal).
Enregistreurs et rédacteurs standard standard-loggers-and-writers
Certains enregistreurs et rédacteurs sont inclus dans une installation d’AEM standard.
Le premier est un cas particulier car il contrôle à la fois les fichiers request.log et access.log :
-
L’enregistreur :
-
Enregistreur de données de demandes personnalisables Apache Sling
(org.apache.sling.engine.impl.log.RequestLoggerService)
-
Écrit les messages relatifs au contenu des demandes dans
request.log.
-
-
Est lié à :
-
Enregistreur de demandes Apache Sling
(org.apache.sling.engine.impl.log.RequestLogger)
-
Écrit les messages dans
request.logouaccess.log.
-
Ceux-ci peuvent être personnalisés si nécessaire, bien que la configuration standard convienne à la plupart des installations.
Les autres paires suivent la configuration standard :
-
L’enregistreur :
-
Apache Sling Logging Logger Configuration
(org.apache.sling.commons.log.LogManager.factory.config)
-
Écrit des messages
Informationsurlogs/error.log.
-
-
Est lié au rédacteur :
-
Apache Sling Logging Writer Configuration
(org.apache.sling.commons.log.LogManager.factory.writer)
-
-
L’enregistreur :
-
Apache Sling Logging Logger Configuration (org.apache.sling.commons.log.LogManager.factory.config.649d51b7-6425-45c9-81e6-2697a03d6be7)
-
Écrit des messages
Warningsur../logs/error.logpour le serviceorg.apache.pdfbox.
-
-
N’est pas lié à un rédacteur spécifique, et crée et utilise donc un rédacteur implicite avec une configuration par défaut (rotation quotidienne du journal).
Création de vos propres enregistreurs et rédacteurs creating-your-own-loggers-and-writers
Vous pouvez définir votre propre paire enregistreur/rédacteur :
-
Création d’une instance de la configuration d’usine Configuration de l’enregistreur de journalisation Apache Sling.
- Spécifiez le fichier journal.
- Définissez l’enregistreur.
- Configurez les autres paramètres selon les besoins.
-
Création d’une instance de la configuration d’usine Configuration de l’auteur de journalisation Apache Sling.
- Spécifiez le fichier journal. Celui-ci doit correspondre à celui spécifié pour l’enregistreur.
- Configurez les autres paramètres selon les besoins.