Logowanie

Rejestrowanie jest konfigurowane za pomocą SLF4J, czyli ogólnej biblioteki rejestrowania dla Javy, 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 z jednowierszowym podsumowaniem oraz pełną treścią żądania/odpowiedzi i nagłówkami.

Typ logu Nazwa logu Poziom powodzenia Poziom niepowodzenia
PODSUMOWANIE com.google.ads.googleads.lib.request.summary INFORMACJE WARN
SZCZEGÓŁY com.google.ads.googleads.lib.request.detail DEBUGUJ INFORMACJE

Obcinanie dziennika szczegółów

Szczegółowe dzienniki są domyślnie obcinane, aby uniknąć tworzenia dużych dzienników. Aby zmienić długość, po której logi są obcinane, ustaw parametr -Dapi.googleads.maxLogMessageLength=<number>. Ustawienie -1 wyłącza skracanie dziennika.

Log4j 2

  1. Dodaj zależność od biblioteki log4j-slf4j-impl, zastępując 2.x.y wersją Log4j 2, której używasz 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, na przykład w Maven: src/main/resources. Log4j 2 wczytuje plik konfiguracji z ścieżki klas, a nie z katalogu roboczego, więc pamiętaj, aby utworzyć go w katalogu resources.

  3. Uruchom aplikację, podając parametr -Dlog4j.configurationFile=<CONFIG_FILE_PATH>. Możesz użyć opcji 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. Na przykład w Maven ścieżka to src/main/resources. Log4j 1.2 wczytuje plik konfiguracji z ścieżki klas, a nie z katalogu roboczego, więc pamiętaj, aby skopiować go do katalogu resources.

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

Logowanie w Java Util

  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 konfiguracji JUL w systemie plików na ścieżce dostępnej z poziomu aplikacji (na przykład ./jdk-logger.properties). Szablon znajdziesz na stronie google-ads/src/main/resources/googleads-logging/jdk-logger.properties. JUL odczytuje tylko z systemu plików, więc nie kopiuj do katalogu resources.

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