Logowanie

Rejestrowanie jest konfigurowane za pomocą SLF4J, ogólnej biblioteki rejestrowania dla języka Java, która umożliwia kierowanie logów do wielu różnych implementacji rejestrowania. Udostępniamy pliki konfiguracji dla log4j 1.2/2 i Java Util Logging (JUL).

Układ i funkcje logowania

Żądania są rejestrowane w postaci jednolinijkowego podsumowania oraz pełnej treści żądania/odpowiedzi i nagłówków.

Obcinanie szczegółowego logu

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 wartość -Dapi.googleads.maxLogMessageLength=<number>. Ustawienie -1 wyłącza obcinanie logów.

Log4j 2

1. Dodaj zależność od biblioteki log4j-slf4j-impl, zastępując 2.x.y wersją Log4j 2 używaną w projekcie.

   <dependency>
     <groupId>org.apache.logging.log4j</groupId>
     <artifactId>log4j-slf4j-impl</artifactId>
     <version>2.x.y</version>
   </dependency>
   

2. (Opcjonalnie) Utwórz plik konfiguracji w katalogu zasobów, np. w Mavenie: src/main/resources. Log4j 2 wczytuje plik konfiguracyjny ze ścieżki klasy, a nie z katalogu roboczego, więc utwórz go w katalogu zasobów.

3. 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 bibliotek klienta.

Log4j 1.2 (starsza wersja)

1. Dodaj zależność od biblioteki slf4j-log4j12, zastępując 1.x.y wersją Log4j 1.2, której używasz w projekcie.

   <dependency>
     <groupId>org.slf4j</groupId>
     <artifactId>slf4j-log4j12</artifactId>
     <version>1.x.y</version>
   </dependency>
   

2. (Opcjonalnie) Utwórz plik konfiguracji w katalogu zasobów projektu, np. w Mavenie ścieżka to src/main/resources. Log4j 1.2 wczytuje plik konfiguracji ze ścieżki klasy, a nie z katalogu roboczego, więc skopiuj go do katalogu zasobów.

3. Uruchom aplikację, podając -Dlog4j.configuration=<CONFIG_FILE_PATH>. Możesz określić CONFIG_FILE_PATH=googleads-logging/log4j.properties, aby użyć domyślnego pliku konfiguracji dołączonego do bibliotek klienta.

Java Util Logging

1. Dodaj zależność od biblioteki slf4j-jdk14.

   <dependency>
     <groupId>org.slf4j</groupId>
     <artifactId>slf4j-jdk14</artifactId>
     <version>1.7.25</version>
   </dependency>
   

2. Utwórz plik konfiguracyjny JUL w systemie plików w ścieżce odczytywanej przez aplikację (np. ./jdk-logger.properties). Szablon jest dostępny pod adresem google-ads/src/main/resources/googleads-logging/jdk-logger.properties. JUL odczytuje tylko z systemu plików, więc nie kopiuj go do katalogu zasobów.

3. Uruchom aplikację, podając -Djava.util.logging.config.file=./jdk-logger.properties.