DocumentazioneAEM 6.5Guida utente

Registrazione logging

Last update: Sun Jul 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Amministratore

L’AEM ti 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 sulla 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.

NOTE
La registrazione in AEM si basa sui principi Sling. Per ulteriori informazioni, vedere Registrazione Sling.

Registrazione globale global-logging

Configurazione registrazione Sling Apache utilizzata per configurare il logger radice. Questo definisce le impostazioni globali per l’accesso all’AEM:

  • livello di registrazione
  • posizione del file di registro centrale
  • il numero di versioni da conservare
  • rotazione delle versioni; dimensione massima o intervallo di tempo
  • formato da utilizzare per la scrittura dei messaggi di registro
NOTE
Questo articolo della Knowledge Base spiega come ruotare i file request.log e access.log.

Logger e writer per singoli servizi loggers-and-writers-for-individual-services

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

  • il livello di registrazione specifico
  • posizione del singolo file di registro
  • il numero di versioni da conservare
  • rotazione delle versioni; dimensione massima o intervallo di tempo
  • formato da utilizzare per la scrittura dei messaggi di registro
  • il logger (il servizio OSGi che fornisce i messaggi di registro)

In questo modo è possibile canalizzare i messaggi di registro per un singolo servizio in un file separato. Ciò può essere particolarmente utile durante lo sviluppo o il test; ad esempio, quando è necessario un livello di registro aumentato per un servizio specifico.

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

  1. Un servizio OSGi (logger) scrive un messaggio di registro.
  2. Un Logger accetta questo messaggio e lo formatta in base alle tue specifiche.
  3. Un Logging Writer scrive tutti questi messaggi nel file fisico definito.

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

  • Logger (Logger)

    Definisci i servizi che generano i messaggi.

  • File di registro (Logger di registrazione)

    Definisci il file fisico per l’archiviazione dei messaggi di registro.

    Viene utilizzato per collegare un Logger con un Logger. Il valore deve essere identico allo stesso parametro nella configurazione di Logging Writer per la connessione da effettuare.

  • File di log (Logging Writer)

    Definisci il file fisico in cui verranno scritti i messaggi del registro.

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

Logger e writer standard standard-loggers-and-writers

Alcuni Logger e Writer sono inclusi in un'installazione AEM standard.

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

  • Logger:

    • Registratore dati di richieste personalizzabili Apache Sling

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

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

  • Collegamenti a:

    • Logger 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:

  • Logger:

    • Configurazione logger registrazione Sling Apache

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

    • Scrive Information messaggi in logs/error.log.

  • Collegamenti a Writer:

    • Configurazione di Apache Sling Logging Writer

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

  • Logger:

    • Configurazione logger registrazione Sling Apache
      (org.apache.sling.commons.log.LogManager.factory.config.649d51b7-6425-45c9-81e6-2697a03d6be7)

    • Scrive Warning messaggi in ../logs/error.log per il servizio org.apache.pdfbox.

  • Non è collegato a un processo di scrittura specifico, pertanto creerà e utilizzerà un processo di scrittura implicito con configurazione predefinita (rotazione giornaliera del registro).

Creazione di logger e autori personalizzati creating-your-own-loggers-and-writers

Puoi definire una tua coppia Logger/Writer:

  1. Creare un'istanza della configurazione di fabbrica configurazione del logger di registrazione Sling Apache.

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

  2. Creare un'istanza della configurazione di fabbrica configurazione del writer di registrazione Sling di Apache.

    1. Specifica il file di registro, che deve corrispondere a quello specificato per il logger.
    2. Configura gli altri parametri come richiesto.
NOTE
In determinate circostanze è possibile creare un file di registro personalizzato.
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2