DocumentazioneAEM 6.4Guida alla distribuzione

Registrazione logging

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Developer
CAUTION
AEM 6.4 ha raggiunto la fine del supporto esteso e questa documentazione non viene più aggiornata. Per maggiori dettagli, consulta la nostra periodi di assistenza tecnica. Trova le versioni supportate qui.

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.

NOTE
L'accesso AEM è basato sui principi Sling. Vedi Registrazione Sling per ulteriori informazioni.

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
NOTE
Questo Articolo della Knowledge Base spiega come ruotare i file request.log e access.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:

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

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

    • Scritture Warning messaggi a ../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 scrittori creating-your-own-loggers-and-writers

Puoi definire una coppia Logger / Writer personalizzata:

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

    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.
NOTE
In alcune circostanze è possibile creare un file di registro personalizzato.
recommendation-more-help
6a71a83d-c2e0-4ce7-a6aa-899aa3885b56