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 registro e un formato per i messaggi di registro

Sono tutte configurazioni OSGi.

NOTA

L’accesso AEM è basato sui principi Sling. Per ulteriori informazioni, vedere Sling Logging.

Registrazione globale

Apache Sling Logging Configurationè utilizzata per configurare il logger radice. Definisce le impostazioni globali per l’accesso AEM:

  • livello di registrazione
  • posizione del file di registro 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 registro
NOTA

Questo articolo della Knowledge Base spiega come ruotare i file request.log e access.log.

Registratori e scrittori per servizi individuali

Oltre alle impostazioni di registrazione globali, AEM consente di configurare impostazioni specifiche per un singolo servizio:

  • il livello di registrazione specifico
  • il percorso del singolo file di registro
  • 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 registro
  • logger (il servizio OSGi che fornisce i messaggi di registro)

Questo consente di incanalare i messaggi di registro per un singolo servizio in un file separato. Ciò può essere particolarmente utile durante lo sviluppo o i test; ad esempio, quando è necessario un livello di registro maggiore per un servizio specifico.

AEM utilizza quanto segue per scrivere messaggi di registro nel file:

  1. Un servizio OSGi (logger) scrive un messaggio di registro.
  2. Un Logger di registrazione riceve questo messaggio e lo formatta in base alle specifiche dell'utente.
  3. Un Registratore scrive tutti questi messaggi nel file fisico definito.

Questi elementi sono collegati dai seguenti parametri per gli elementi appropriati:

  • Logger (Logging)

    Definire i servizi che generano i messaggi.

  • File di registro (Logging Logger)

    Definire il file fisico per la memorizzazione dei messaggi di registro.

    Viene utilizzato per collegare un Registratore di registrazione a un Registratore di registrazione. Per stabilire la connessione, il valore deve essere identico allo stesso parametro nella configurazione di Log Writer.

  • File di registro (Registratore Di Registrazione)

    Definire il file fisico in cui verranno scritti i messaggi di registro.

    Deve essere identico allo stesso parametro nella configurazione di Logging Writer, altrimenti la corrispondenza non verrà effettuata. Se non esiste alcuna corrispondenza, verrà creato un Writer implicito con configurazione predefinita (rotazione del registro giornaliera).

Registratori 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 Custom Request Data Logger

      (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 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 Registratore Di Registrazione Apache Sling

      (org.apache.sling.commons.log.LogManager.factory.config)

    • Scrive i messaggi Information in logs/error.log.

  • Collegamenti allo scrittore:

    • Configurazione dello scrittore di registrazione Apache Sling

      (org.apache.sling.commons.log.LogManager.factory.writer)

  • Il Logger:

    • Configurazione Del Registratore Di Registrazione Apache Sling
      (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 del registro giornaliera).

Creazione di registri e autori

Puoi definire la tua coppia Logger/Writer:

  1. Create una nuova istanza della configurazione Apache Sling Logging Logging Configuration.

    1. Specificate il file di registro.
    2. Specificate il logger.
    3. Configurate gli altri parametri come necessario.
  2. Create una nuova istanza della configurazione Apache Sling Logging Writer Configuration.

    1. Specificare il file di registro. Deve corrispondere a quello specificato per il logger.
    2. Configurate gli altri parametri come necessario.
NOTA

In alcune circostanze è possibile creare un file di registro personalizzato.

In questa pagina