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
Fügen Sie eine Abhängigkeit von der Bibliothek
log4j-slf4j-impl
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 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.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 (Legacy)
Fügen Sie eine Abhängigkeit von der Bibliothek
slf4j-log4j12
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 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.Führen Sie die Anwendung aus und geben Sie dabei
-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-Dienstprogramm-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 in einem Pfad, der von Ihrer Anwendung aus lesbar ist (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 aus und geben Sie
-Djava.util.logging.config.file=./jdk-logger.properties
an.