DokumentationAEM 6.4Användarhandbok om distribution

Loggning logging

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

Skapat för:

  • Developer
CAUTION
AEM 6.4 har nått slutet på den utökade supporten och denna dokumentation är inte längre uppdaterad. Mer information finns i teknisk supportperiod. Hitta de versioner som stöds här.

AEM ger dig möjlighet att konfigurera:

  • globala parametrar för den centrala loggningstjänsten
  • begära dataloggning, en särskild loggningskonfiguration för begärandeinformation
  • särskilda inställningar för de enskilda tjänsterna, t.ex. en enskild loggfil och ett format för loggmeddelandena

De här är alla OSGi-konfigurationer.

NOTE
Inloggning AEM baseras på Sling-principer. Se Sling Logging för ytterligare information.

Global loggning global-logging

Konfiguration av Apache Sling-loggning används för att konfigurera rotloggaren. Detta definierar de globala inställningarna för inloggning AEM:

  • loggningsnivån
  • platsen för den centrala loggfilen
  • antalet versioner som ska behållas
  • versionsrotation; antingen maximal storlek eller ett tidsintervall
  • det format som ska användas när loggmeddelanden skrivs
NOTE
Detta Kunskapsbasartikel I beskrivs hur du roterar filen request.log och access.log.

Loggare och skribenter för enskilda tjänster loggers-and-writers-for-individual-services

Förutom de globala loggningsinställningarna kan du med AEM konfigurera specifika inställningar för en enskild tjänst:

  • den specifika loggningsnivån
  • platsen för den enskilda loggfilen
  • antalet versioner som ska behållas
  • versionsrotation; antingen maxstorlek eller tidsintervall
  • det format som ska användas när loggmeddelanden skrivs
  • loggaren (OSGi-tjänsten som tillhandahåller loggmeddelanden)

På så sätt kan du kanalisera loggmeddelanden för en enskild tjänst till en separat fil. Detta kan vara särskilt användbart under utveckling eller testning. om du till exempel behöver en högre loggnivå för en viss tjänst.

AEM använder följande för att skriva loggmeddelanden till filen:

  1. An OSGi-tjänst (logger) skriver ett loggmeddelande.
  2. A Loggningsloggare tar det här meddelandet och formaterar det enligt din specifikation.
  3. A Loggningsförfattare skriver alla dessa meddelanden till den fysiska filen som du har definierat.

Dessa element är länkade med följande parametrar för de relevanta elementen:

  • Logger (loggningsloggare)

    Definiera de tjänster som genererar meddelandena.

  • Loggfil (loggningslogg)

    Definiera den fysiska filen för lagring av loggmeddelanden.

    Detta används för att länka en loggningslogg till en loggningsförfattare. Värdet måste vara identiskt med samma parameter i loggningsskrivarens konfiguration för att anslutningen ska kunna upprättas.

  • Loggfil (loggningsskrivare)

    Definiera den fysiska fil som loggmeddelandena ska skrivas till.

    Detta måste vara identiskt med samma parameter i loggningsskrivarkonfigurationen, annars görs ingen matchning. Om det inte finns någon matchning skapas ett implicit skrivprogram med standardkonfigurationen (daglig loggrotation).

Standardloggare och -författare standard-loggers-and-writers

Vissa loggare och skrivprogram ingår i en AEM standardinstallation.

Det första är ett specialfall eftersom det styr både request.log och access.log filer:

  • Loggaren:

    • Dataloggning för anpassningsbara Apache Sling-begäranden

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

    • Skriv meddelanden om att begära innehåll till request.log.

  • Länkar till:

    • Apache Sling Request Logger

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

    • Skriver meddelanden till antingen request.log eller access.log.

Dessa kan anpassas vid behov, men standardkonfigurationen passar de flesta installationer.

De andra paren följer standardkonfigurationen:

  • Loggaren:

    • Konfiguration av loggningsloggare för Apache Sling

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

    • Skrivningar Information meddelanden till logs/error.log.

  • Länkar till skrivprogrammet:

    • Konfiguration av skrivprogram för Apache Sling Logging

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

  • Loggaren:

    • Konfiguration av loggningslogg för Apache Sling (org.apache.sling.Commons.log.LogManager.factory.config.649d51b7-6425-45c9-81e6-2697a03d6be7)

    • Skrivningar Warning meddelanden till ../logs/error.log för tjänsten org.apache.pdfbox.

  • Länkar inte till ett specifikt skrivprogram, så skapar och använder ett implicit skrivprogram med standardkonfiguration (daglig loggrotation).

Skapa egna loggare och författare creating-your-own-loggers-and-writers

Du kan definiera ett eget par för loggare/skrivare:

  1. Skapa en ny instans av fabrikskonfigurationen Konfiguration av loggningsloggare för Apache Sling.

    1. Ange loggfilen.
    2. Ange loggaren.
    3. Konfigurera de andra parametrarna efter behov.

  2. Skapa en ny instans av fabrikskonfigurationen Konfiguration av skrivprogram för Apache Sling Logging.

    1. Ange loggfilen - den måste matcha den som har angetts för loggaren.
    2. Konfigurera de andra parametrarna efter behov.
NOTE
Under vissa omständigheter kanske du vill skapa en anpassad loggfil.
recommendation-more-help
6a71a83d-c2e0-4ce7-a6aa-899aa3885b56