Logowanie w bibliotece klienta Java jest konfigurowane za pomocą SLF4J, ogólnej fasady logowania dla Javy, która umożliwia kierowanie logów do wielu różnych implementacji logowania, takich jak Log4j 2, Logback czy java.util.logging (JUL). Udostępniamy przykładowe pliki konfiguracji dla Log4j 2 i JUL.
Układ i funkcjonalność logów
Żądania są rejestrowane w postaci jednolinijkowego podsumowania oraz pełnej treści i nagłówków żądania i odpowiedzi.
| Typ logu | Nazwa logu | Poziom sukcesu | Poziom błędu |
|---|---|---|---|
| PODSUMOWANIE | com.google.ads.googleads.lib.request.summary | INFORMACJE | WARN |
| SZCZEGÓŁY | com.google.ads.googleads.lib.request.detail | DEBUGOWANIE | INFORMACJE |
Obcinanie szczegółowych logów
Szczegółowe logi są domyślnie obcinane, aby uniknąć tworzenia dużych plików. Aby zmienić długość, przy której logi są obcinane, ustaw właściwość JVM -Dapi.googleads.maxLogMessageLength=<number>. Ustawienie -1 wyłącza obcinanie logów.
Log4j 2
Dodaj zależność od biblioteki
log4j-slf4j2-impl, zastępując2.x.ywersją Log4j 2 używaną w projekcie:<dependency> <groupId>org.apache.logging.log4j</groupId> <artifactId>log4j-slf4j2-impl</artifactId> <version>2.x.y</version> </dependency>(Opcjonalnie) Utwórz plik konfiguracji
log4j2.xmlw katalogu zasobów (np.src/main/resourcesw Mavenie). Log4j 2 wczytuje plik konfiguracji ze ścieżki klasy, a nie z katalogu roboczego, więc utwórz go w katalogu zasobów.Uruchom aplikację, podając
-Dlog4j.configurationFile=<CONFIG_FILE_PATH>. Możesz określićCONFIG_FILE_PATH=googleads-logging/log4j2.xml, aby użyć domyślnego pliku konfiguracji dołączonego do biblioteki klienta.
Log4j 1.2 (starsza wersja)
Dodaj zależność od biblioteki
slf4j-log4j12, zastępując1.x.ywersją Log4j 1.2, której używasz w projekcie:<dependency> <groupId>org.slf4j</groupId> <artifactId>slf4j-log4j12</artifactId> <version>1.x.y</version> </dependency>(Opcjonalnie) Utwórz plik konfiguracji w katalogu zasobów projektu, np.
src/main/resourcesw Mavenie. Log4j 1.2 wczytuje plik konfiguracji ze ścieżki klasy, a nie z katalogu roboczego, więc skopiuj go do katalogu zasobów.Uruchom aplikację, podając
-Dlog4j.configuration=<CONFIG_FILE_PATH>. Możesz użyć wartościCONFIG_FILE_PATH=googleads-logging/log4j.properties, aby użyć domyślnego pliku konfiguracji dołączonego do biblioteki klienta.
Java Util Logging
Dodaj zależność od biblioteki
slf4j-jdk14, zastępując2.x.ywersją SLF4J używaną w projekcie:<dependency> <groupId>org.slf4j</groupId> <artifactId>slf4j-jdk14</artifactId> <version>2.x.y</version> </dependency>Utwórz plik konfiguracji JUL w systemie plików w ścieżce odczytywanej przez aplikację (np.
./jdk-logger.properties). Szablon jest dostępny pod adresemgoogle-ads/src/main/resources/googleads-logging/jdk-logger.properties. JUL odczytuje tylko z systemu plików, więc nie kopiuj go tylko do katalogu zasobów ścieżki klas.Uruchom aplikację, podając
-Djava.util.logging.config.file=./jdk-logger.properties.