Logging

Logging ist mit SLF4J, einer generischen Logging-Bibliothek für Java, konfiguriert, mit der Logs an viele verschiedene Logging-Implementierungen weitergeleitet werden können. Wir stellen Konfigurationsdateien für log4j 1.2/2 und Java Util Logging (JUL) bereit.

Logging-Layout und -Funktionalität

Anfragen werden in einer einzeiligen Zusammenfassung mit dem vollständigen Anfrage-/Antworttext und den Headern protokolliert.

Logtyp Logname Erfolgsebene Fehlerstufe
ZUSAMMENFASSUNG com.google.ads.googleads.lib.request.summary INFO WARN
DETAILS com.google.ads.googleads.lib.request.detail FEHLER BEHEBEN INFO

Kürzung des Detailprotokolls

Die detaillierten Logs werden standardmäßig gekürzt, um das Erstellen großer Logs zu vermeiden. Wenn Sie die Länge des Abschneidens von Logs ändern möchten, legen Sie -Dapi.googleads.maxLogMessageLength=<number> fest. Wenn Sie -1 festlegen, wird das Abschneiden von Logs deaktiviert.

Log4j 2

  1. Fügen Sie eine Abhängigkeit von der Bibliothek log4j-slf4j-impl hinzu und ersetzen Sie 2.x.y durch die Version von Log4j 2, die Sie in Ihrem Projekt verwenden.

    <dependency>
      <groupId>org.apache.logging.log4j</groupId>
      <artifactId>log4j-slf4j-impl</artifactId>
      <version>2.x.y</version>
    </dependency>
    
  2. (Optional) Erstellen Sie eine Konfigurationsdatei in Ihrem Ressourcenverzeichnis, z. B. in Maven: src/main/resources. Bei Log4j 2 wird die Konfigurationsdatei aus dem Klassenpfad und nicht aus dem Arbeitsverzeichnis geladen. Achten Sie also darauf, dass Sie die Datei in einem Ressourcenverzeichnis erstellen.

  3. Führen Sie die Anwendung aus und geben Sie -Dlog4j.configurationFile=<CONFIG_FILE_PATH> an. Sie können CONFIG_FILE_PATH=googleads-logging/log4j2.xml angeben, um die Standardkonfigurationsdatei zu verwenden, die in den Clientbibliotheken enthalten ist.

Log4j 1.2 (Legacy)

  1. Fügen Sie eine Abhängigkeit von der Bibliothek slf4j-log4j12 hinzu und ersetzen Sie 1.x.y durch die Version von Log4j 1.2, die Sie in Ihrem Projekt verwenden.

    <dependency>
      <groupId>org.slf4j</groupId>
      <artifactId>slf4j-log4j12</artifactId>
      <version>1.x.y</version>
    </dependency>
    
  2. (Optional) Erstellen Sie im Ressourcenverzeichnis Ihres Projekts eine Konfigurationsdatei. In Maven ist der Pfad beispielsweise src/main/resources. Die Konfigurationsdatei von Log4j 1.2 wird aus dem Klassenpfad und nicht aus dem Arbeitsverzeichnis geladen. Kopieren Sie daher unbedingt in ein Ressourcenverzeichnis.

  3. Führen Sie die Anwendung aus und geben Sie dabei -Dlog4j.configuration=<CONFIG_FILE_PATH> an. Sie können CONFIG_FILE_PATH=googleads-logging/log4j.properties angeben, um die Standardkonfigurationsdatei zu verwenden, die in den Clientbibliotheken enthalten ist.

Java-Dienstprogramm-Logging

  1. Fügen Sie eine Abhängigkeit von der slf4j-jdk14-Bibliothek hinzu.

    <dependency>
      <groupId>org.slf4j</groupId>
      <artifactId>slf4j-jdk14</artifactId>
      <version>1.7.25</version>
    </dependency>
    
  2. Erstellen Sie eine JUL-Konfigurationsdatei im Dateisystem in einem Pfad, der von Ihrer Anwendung aus lesbar ist (z. B. ./jdk-logger.properties). Eine Vorlage finden Sie unter google-ads/src/main/resources/googleads-logging/jdk-logger.properties. JUL liest nur aus dem Dateisystem, kopieren Sie es also nicht in das Ressourcenverzeichnis.

  3. Führen Sie die Anwendung aus und geben Sie -Djava.util.logging.config.file=./jdk-logger.properties an.