Logboekregistratie

AEM biedt u de mogelijkheid om te vormen:

  • globale parameters voor de centrale houtkapdienst
  • verzoeken om registratie van gegevens; een gespecialiseerde registrerenconfiguratie voor verzoekinformatie
  • specifieke instellingen voor de afzonderlijke diensten; bijvoorbeeld een afzonderlijk logbestand en een indeling voor de logberichten

Dit zijn allemaal OSGi configuraties.

OPMERKING

Aanmelden in AEM is gebaseerd op verkoopbeginselen. Zie Logboekregistratie voor verkoop voor meer informatie.

Globale registratie

Apache Sling Logging Configuration wordt gebruikt om het hoofdlogger te configureren. Hiermee worden de algemene instellingen voor het aanmelden van AEM gedefinieerd:

  • het registratieniveau
  • de locatie van het centrale logbestand
  • het aantal versies dat moet worden bewaard
  • versierotatie; of maximumgrootte of een tijdinterval
  • de indeling die moet worden gebruikt bij het schrijven van de logberichten
OPMERKING

Dit artikel van de Kennisbank verklaart hoe te om de request.log en access.log dossiers te roteren.

Loggers en schrijvers voor de Individuele Diensten

Naast de globale registrerenmontages, staat AEM u toe om specifieke montages voor de individuele dienst te vormen:

  • het specifieke registratieniveau
  • de locatie van het individuele logbestand
  • het aantal versies dat moet worden bewaard
  • versierotatie; of maximumgrootte of tijdinterval
  • de indeling die moet worden gebruikt bij het schrijven van de logberichten
  • de registreermachine (de dienst OSGi die de logboekberichten levert)

Dit staat u toe om logboekberichten voor één enkele dienst in een afzonderlijk dossier te kanaliseren. Dit kan met name nuttig zijn tijdens de ontwikkeling of het testen; bijvoorbeeld, wanneer u een verhoogd logboekniveau voor de specifieke dienst nodig hebt.

AEM gebruikt het volgende om logberichten naar bestand te schrijven:

  1. Een OSGi service (logger) schrijft een logboekbericht.
  2. Een Logging Logger neemt dit bericht en formatteert het volgens uw specificatie.
  3. Een Logging Writer schrijft al deze berichten aan het fysieke dossier dat u hebt bepaald.

Deze elementen zijn gekoppeld aan de volgende parameters voor de desbetreffende elementen:

  • Logger (Logging Logger)

    Definieer de service(s) die de berichten genereren.

  • Logbestand (Logging Logger)

    Bepaal het fysieke dossier voor het opslaan van de logboekberichten.

    Dit wordt gebruikt om een Logging Logger met een het Registreren Schrijver te verbinden. De waarde moet aan de zelfde parameter in de Logging configuratie van de Schrijver identiek zijn om de verbinding te maken.

  • Logbestand (logboekschrijver)

    Definieer het fysieke bestand waarnaar de logberichten worden geschreven.

    Dit moet gelijk zijn aan dezelfde parameter in de configuratie van Logging Writer, anders wordt de overeenkomst niet gemaakt. Als er geen gelijke is dan zal een impliciete Schrijver met standaardconfiguratie (dagelijkse logboekomwenteling) worden gecreeerd.

Standaardregistreerapparaten en -schrijvers

Bepaalde loggers en schrijvers zijn opgenomen in een standaard AEM installatie.

Het eerste is een speciaal geval aangezien het zowel de request.log als access.log dossiers controleert:

  • De logboekregistratie:

    • Apache Sling Aanpasbaar Data Logger Aanvraag

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

    • Schrijf berichten over verzoekinhoud aan request.log.

  • Koppelingen naar:

    • Apache Sling Request Logger

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

    • Schrijft de berichten naar request.log of access.log.

Deze kunnen indien nodig worden aangepast, hoewel de standaardconfiguratie geschikt is voor de meeste installaties.

De andere paren volgen de standaardconfiguratie:

  • De logboekregistratie:

    • Logboekconfiguratie Apache Sling Logging

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

    • Schrijft Information berichten aan logs/error.log.

  • Koppelingen naar de schrijver:

    • Configuratie van auteur van Apache Sling Logging

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

  • De logboekregistratie:

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

    • Schrijft Warning berichten aan ../logs/error.log voor de dienst org.apache.pdfbox.

  • Koppelt niet aan een specifieke schrijver, zodat er een impliciete schrijver met standaardconfiguratie (dagelijkse logrotatie) wordt gemaakt en gebruikt.

Uw eigen registreerapparaten en schrijvers maken

U kunt uw eigen registreerapparaat/schrijfpaar definiëren:

  1. Maak een nieuwe instantie van de Configuratie Apache Sling Logging Logger Configuration.

    1. Geef het logbestand op.
    2. Geef de logboekregistratie op.
    3. Configureer de overige parameters naar wens.
  2. Maak een nieuwe instantie van de Configuratie Apache Sling Logging Writer Configuration.

    1. Geef het logbestand op. Dit moet overeenkomen met het logbestand dat is opgegeven voor de gebruiker.
    2. Configureer de overige parameters naar wens.
OPMERKING

In bepaalde omstandigheden wilt u wellicht een aangepast logbestand maken.

Op deze pagina