Logging

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

Layout und Funktionalität der Protokollierung

Anfragen werden mit einer einzeiligen Zusammenfassung und dem vollständigen Anfrage-/Antworttext protokolliert und Überschriften.

Logtyp Logname Erfolgsstufe 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 Detaillogs

Die detaillierten Logs werden standardmäßig abgeschnitten, um die Erstellung großer Logs zu vermeiden. Bis die Länge der gekürzten Protokolle ändern, -Dapi.googleads.maxLogMessageLength=<number> Mit der Einstellung „-1“ wird Folgendes deaktiviert: abgeschnitten.

Log4j 2

  1. Fügen Sie eine Abhängigkeit für die Bibliothek log4j-slf4j-impl hinzu und ersetzen Sie dabei 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 in Ihrem Ressourcenverzeichnis eine Konfigurationsdatei für Beispiel in Maven: src/main/resources. Log4j 2 lädt seine Konfiguration aus dem Klassenpfad und nicht aus dem Arbeitsverzeichnis. Ressourcenverzeichnis.

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

Log4j 1.2 (Legacy)

  1. Fügen Sie eine Abhängigkeit für die Bibliothek slf4j-log4j12 hinzu und ersetzen Sie dabei 1.x.y durch 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 und nicht aus dem Arbeitsverzeichnis. in ein Ressourcenverzeichnis kopiert.

  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, die in den Clientbibliotheken enthaltene Standardkonfigurationsdatei.

Java-Dienstprogramm-Logging

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

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

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