Registrazione

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

Sono tutte configurazioni OSGi.

Registrazione globale

Apache Sling Logging Configurationviene 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

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:

1. Un servizio OSGi (logger) scrive un messaggio di log.
2. Un Logging Logger prende questo messaggio e lo formatta in base alle tue specifiche.
3. Un 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).

Logger e scrittori standard

Alcuni Loggers e Scrittori sono inclusi in un’installazione AEM standard.

Il primo è un caso speciale in quanto controlla sia i file request.log che i file access.log:

• Il logger:

  • Apache Sling Registratore dati di richiesta personalizzabile

    (org.apache.sling.engine.impl.log.RequestLoggerService)

  • Scrivi messaggi sul contenuto della richiesta a request.log.

• Collegamenti a:

  • Registratore di richieste Apache Sling

    (org.apache.sling.engine.impl.log.RequestLogger)

  • Scrive i messaggi in request.log o access.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)

  • Scrive i messaggi Information in logs/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 Sling di Apache
    (org.apache.sling.commons.log.LogManager.factory.config.649d51b7-6425-45c9-81e6-2697a03d6be7)

  • Scrive i messaggi Warning in ../logs/error.log per il servizio org.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 autori

Puoi definire una coppia Logger / Writer personalizzata:

1. Crea una nuova istanza della configurazione di fabbrica Configurazione del logger di registrazione di Apache Sling.

   1. Specificare il file di registro.
   2. Specifica il logger.
   3. Configura gli altri parametri come richiesto.

2. Crea una nuova istanza della configurazione di fabbrica Configurazione di Apache Sling Logging Writer.

   1. Specifica il file di registro, che deve corrispondere a quello specificato per il logger.
   2. Configura gli altri parametri come richiesto.