Skonfiguruj logowanie

Logowanie w bibliotece klienta Java jest konfigurowane za pomocą SLF4J, czyli 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 konfiguracyjne dla Log4j 2 i JUL.

Układ i funkcje logu

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

Typ logu Nazwa logu Poziom powodzenia Poziom niepowodzenia
PODSUMOWANIE com.google.ads.googleads.lib.request.summary INFORMACJE OSTRZEŻENIE
SZCZEGÓŁY com.google.ads.googleads.lib.request.detail DEBUGOWANIE INFORMACJE

Obcinanie logów szczegółowych

Domyślnie logi szczegółowe są obcinane, aby nie tworzyć dużych logó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

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

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

  2. (Opcjonalnie) Utwórz plik konfiguracyjny log4j2.xml w katalogu zasobów (np. src/main/resources w Maven). 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 podać CONFIG_FILE_PATH=googleads-logging/log4j2.xml, aby użyć domyślnego pliku konfiguracyjnego dołączonego do biblioteki klienta.

Log4j 1.2 (starsza wersja)

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

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

  2. (Opcjonalnie) Utwórz plik konfiguracyjny w katalogu zasobów projektu, np. src/main/resources w Maven. Log4j 1.2 wczytuje plik konfiguracyjny 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 podać CONFIG_FILE_PATH=googleads-logging/log4j.properties, aby użyć domyślnego pliku konfiguracyjnego dołączonego do biblioteki klienta.

Java Util Logging

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

    <dependency>
  <groupId>org.slf4j</groupId>
  <artifactId>slf4j-jdk14</artifactId>
  <version>2.x.y</version>
</dependency>

  2. Utwórz plik konfiguracyjny JUL w systemie plików w ścieżce, która jest czytelna dla aplikacji (np. ./jdk-logger.properties). Szablon znajdziesz w google-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 klasy.

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