Das Logging in der Java-Clientbibliothek wird mit SLF4J konfiguriert, einer generischen Logging-Fassade für Java, mit der Logs an viele verschiedene Logging-Implementierungen wie Log4j 2, Logback oder java.util.logging (JUL) weitergeleitet werden können. Wir stellen Beispielkonfigurationsdateien für Log4j 2 und JUL bereit.
Layout und Funktionalität von Logs
Anfragen werden mit einer einzeiligen Zusammenfassung und dem vollständigen Anfrage- und Antworttext sowie den Headern protokolliert.
| 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 von detaillierten Logs
Die detaillierten Protokolle werden standardmäßig gekürzt, um die Erstellung großer Protokolle zu vermeiden. Wenn Sie die Länge ändern möchten, bei der Logs gekürzt werden, legen Sie das JVM-Attribut -Dapi.googleads.maxLogMessageLength=<number> fest. Wenn Sie -1 festlegen, wird die Protokollkürzung deaktiviert.
Log4j 2
Fügen Sie eine Abhängigkeit von der
log4j-slf4j2-impl-Bibliothek hinzu und ersetzen Sie2.x.ydurch die Version von Log4j 2, die Sie in Ihrem Projekt verwenden:<dependency> <groupId>org.apache.logging.log4j</groupId> <artifactId>log4j-slf4j2-impl</artifactId> <version>2.x.y</version> </dependency>(Optional) Erstellen Sie eine
log4j2.xml-Konfigurationsdatei in Ihrem Ressourcenverzeichnis (z. B.src/main/resourcesin Maven). Log4j 2 lädt die Konfigurationsdatei aus dem Klassenpfad, nicht aus dem Arbeitsverzeichnis. Erstellen Sie sie daher in einem Ressourcenverzeichnis.Führen Sie die Anwendung aus und geben Sie dabei
-Dlog4j.configurationFile=<CONFIG_FILE_PATH>an. Sie könnenCONFIG_FILE_PATH=googleads-logging/log4j2.xmlangeben, um die Standardkonfigurationsdatei zu verwenden, die in der Clientbibliothek enthalten ist.
Log4j 1.2 (alt)
Fügen Sie eine Abhängigkeit von der
slf4j-log4j12-Bibliothek hinzu und ersetzen Sie1.x.ydurch 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, z. B.
src/main/resourcesin Maven. 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 dabei
-Dlog4j.configuration=<CONFIG_FILE_PATH>an. Sie könnenCONFIG_FILE_PATH=googleads-logging/log4j.propertiesangeben, um die Standardkonfigurationsdatei zu verwenden, die in der Clientbibliothek enthalten ist.
Java Util Logging
Fügen Sie eine Abhängigkeit von der
slf4j-jdk14-Bibliothek hinzu und ersetzen Sie2.x.ydurch die in Ihrem Projekt verwendete SLF4J-Version:<dependency> <groupId>org.slf4j</groupId> <artifactId>slf4j-jdk14</artifactId> <version>2.x.y</version> </dependency>Erstellen Sie eine JUL-Konfigurationsdatei im Dateisystem in 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 daher nicht nur in das Ressourcenverzeichnis des Klassenpfads.Führen Sie die Anwendung aus und geben Sie dabei
-Djava.util.logging.config.file=./jdk-logger.propertiesan.