Logging

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

Layout und Funktionen protokollieren

Anfragen werden mit einer einzeiligen Zusammenfassung und dem vollständigen Textkörper und den vollständigen Headern der Anfrage/Antwort protokolliert.

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

Kürzung von Detailprotokollen

Die detaillierten Protokolle werden standardmäßig gekürzt, um die Erstellung großer Protokolle zu vermeiden. Wenn Sie die Länge ändern möchten, nach der Protokolle abgeschnitten werden, legen Sie -Dapi.googleads.maxLogMessageLength=<number> fest. Wenn Sie -1 festlegen, wird die Kürzung von Protokollen deaktiviert.

Log4j 2

  1. Fügen Sie eine Abhängigkeit von der log4j-slf4j-impl-Bibliothek 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 im Ressourcenverzeichnis, z. B. in Maven: src/main/resources. Log4j 2 lädt seine Konfigurationsdatei aus dem Klassenpfad, nicht aus dem Arbeitsverzeichnis. Achten Sie daher darauf, sie in einem Ressourcenverzeichnis zu 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 (alt)

  1. Fügen Sie eine Abhängigkeit von der slf4j-log4j12-Bibliothek 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 eine Konfigurationsdatei im Ressourcenverzeichnis Ihres Projekts. In Maven lautet der Pfad beispielsweise src/main/resources. Log4j 1.2 lädt seine Konfigurationsdatei aus dem Klassenpfad, nicht aus dem Arbeitsverzeichnis. Kopieren Sie sie daher in ein Ressourcenverzeichnis.

  3. Führen Sie die Anwendung aus und geben Sie -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 Util 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 unter einem Pfad, der von Ihrer Anwendung gelesen werden kann (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 mit -Djava.util.logging.config.file=./jdk-logger.properties aus.