Registrazione logging
AEM offre la possibilità di configurare:
- parametri globali per il servizio di registrazione centrale
- richiedere la registrazione dei dati; una configurazione di registrazione specializzata per le informazioni di richiesta
- impostazioni specifiche per i singoli servizi; ad esempio, un singolo file di log e un formato per i messaggi di log
Questi sono tutti Configurazioni OSGi.
Registrazione globale global-logging
Configurazione della registrazione Apache Sling viene utilizzato per configurare il logger principale. Definisce le impostazioni globali per l’accesso AEM:
- livello di registrazione
- la posizione del file di log centrale
- il numero di versioni da conservare
- rotazione della versione; dimensione massima o intervallo di tempo
- il formato da utilizzare per la scrittura dei messaggi di log
Loggers e Scrittori per servizi individuali loggers-and-writers-for-individual-services
Oltre alle impostazioni di registrazione globale, AEM consente di configurare impostazioni specifiche per un singolo servizio:
- livello di registrazione specifico
- la posizione del singolo file di log
- il numero di versioni da conservare
- rotazione della versione; dimensione massima o intervallo di tempo
- il formato da utilizzare per la scrittura dei messaggi di log
- il logger (il servizio OSGi che fornisce i messaggi di log)
Questo ti consente di incanalare i messaggi di log per un singolo servizio in un file separato. Ciò può essere particolarmente utile durante lo sviluppo o i test; ad esempio, quando hai bisogno di un livello di registro maggiore per un servizio specifico.
AEM utilizza quanto segue per scrivere messaggi di log nel file:
- Un Servizio OSGi (logger) scrive un messaggio di log.
- A Logger di registrazione prende questo messaggio e lo formatta in base alle tue specifiche.
- A Registratore scrive tutti questi messaggi nel file fisico definito.
Questi elementi sono collegati dai seguenti parametri per gli elementi appropriati:
-
Logger (logger di registrazione)
Definisci i servizi che generano i messaggi.
-
File di registro (logger di registrazione)
Definire il file fisico per la memorizzazione dei messaggi di log.
Viene utilizzato per collegare un logger di registrazione a un Registratore di registrazione. Il valore deve essere identico allo stesso parametro nella configurazione di Logging Writer per la connessione da effettuare.
-
File di log (Registratore)
Definire il file fisico in cui verranno scritti i messaggi di log.
Deve essere identico allo stesso parametro nella configurazione di Logging Writer, altrimenti la corrispondenza non verrà effettuata. Se non vi è alcuna corrispondenza, verrà creato un writer implicito con la configurazione predefinita (rotazione giornaliera del registro).
Registratori e scrittori standard standard-loggers-and-writers
Alcuni Loggers e Scrittori sono inclusi in un’installazione AEM standard.
Il primo è un caso speciale in quanto controlla sia la request.log
e access.log
file:
-
Il logger:
-
Apache Sling Registratore dati di richiesta personalizzabile
(org.apache.sling.engine.impl.log.RequestLoggerService)
-
Scrivi messaggi sul contenuto della richiesta in
request.log
.
-
-
Collegamenti a:
-
Registratore di richieste Apache Sling
(org.apache.sling.engine.impl.log.RequestLogger)
-
Scrive i messaggi in
request.log
oaccess.log
.
-
Questi possono essere personalizzati se necessario, anche se la configurazione standard è adatta per la maggior parte delle installazioni.
Le altre coppie seguono la configurazione standard:
-
Il logger:
-
Configurazione del logger di registrazione Sling di Apache
(org.apache.sling.commons.log.LogManager.factory.config)
-
Scritture
Information
messaggi alogs/error.log
.
-
-
Collegamenti allo scrittore:
-
Configurazione di Apache Sling Logging Writer
(org.apache.sling.commons.log.LogManager.factory.writer)
-
-
Il logger:
-
Configurazione del logger di registrazione Apache Sling (org.apache.sling.commons.log.LogManager.factory.config.649d51b7-6425-45c9-81e6-2697a03d6be7)
-
Scritture
Warning
messaggi a../logs/error.log
per il servizioorg.apache.pdfbox
.
-
-
Non si collega a uno specifico Writer in modo da creare e utilizzare un writer implicito con configurazione predefinita (rotazione giornaliera del registro).
Creazione di propri logger e scrittori creating-your-own-loggers-and-writers
Puoi definire una coppia Logger / Writer personalizzata:
-
Crea una nuova istanza della configurazione di fabbrica Configurazione del logger di registrazione Sling di Apache.
- Specificare il file di registro.
- Specifica il logger.
- Configura gli altri parametri come richiesto.
-
Crea una nuova istanza della configurazione di fabbrica Configurazione di Apache Sling Logging Writer.
- Specifica il file di registro, che deve corrispondere a quello specificato per il logger.
- Configura gli altri parametri come richiesto.