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
Fügen Sie eine Abhängigkeit von der
log4j-slf4j-impl
-Bibliothek hinzu und ersetzen Sie2.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>
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.Führen Sie die Anwendung aus und geben Sie
-Dlog4j.configurationFile=<CONFIG_FILE_PATH>
an. Sie könnenCONFIG_FILE_PATH=googleads-logging/log4j2.xml
angeben, um die Standardkonfigurationsdatei zu verwenden, die in den Clientbibliotheken enthalten ist.
Log4j 1.2 (alt)
Fügen Sie eine Abhängigkeit von der
slf4j-log4j12
-Bibliothek hinzu und ersetzen Sie1.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>
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.Führen Sie die Anwendung aus und geben Sie
-Dlog4j.configuration=<CONFIG_FILE_PATH>
an. Sie könnenCONFIG_FILE_PATH=googleads-logging/log4j.properties
angeben, um die Standardkonfigurationsdatei zu verwenden, die in den Clientbibliotheken enthalten ist.
Java Util Logging
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>
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 untergoogle-ads/src/main/resources/googleads-logging/jdk-logger.properties
. JUL liest nur aus dem Dateisystem. Kopieren Sie es also nicht in das Ressourcenverzeichnis.Führen Sie die Anwendung mit
-Djava.util.logging.config.file=./jdk-logger.properties
aus.