Skonfiguruj logowanie

Logowanie w bibliotece klienta Java jest skonfigurowane za pomocą SLF4J, ogólnej fasady logowania w języku Java, która umożliwia kierowanie logów do wielu różnych implementacji logowania, takich jak Log4j 2, Logback lub java.util.logging (JUL). Udostępniamy przykładowe pliki konfiguracji dla Log4j 2 i JUL.

Układ i funkcje logów

Żądania są rejestrowane z jednowierszowym podsumowaniem oraz pełną treścią i nagłówkami żądania i odpowiedzi.

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

Skracanie logów szczegółowych

Szczegółowe logi są domyślnie skracane, 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

  1. Dodaj zależność od biblioteki log4j-slf4j2-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-slf4j2-impl</artifactId>
  <version>2.x.y</version>
</dependency>

  2. (Opcjonalnie) Utwórz plik konfiguracji log4j2.xml w katalogu zasobów (np. src/main/resources w Maven). Log4j 2 wczytuje plik konfiguracji ze ścieżki klasy, a nie z katalogu roboczego, dlatego upewnij się, że tworzysz 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żywać domyślnego pliku konfiguracji 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, 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 src/main/resources w Mavenie. Log4j 1.2 wczytuje plik konfiguracji ze ścieżki klasy, a nie z katalogu roboczego, więc pamiętaj, aby skopiować 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 konfiguracji 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 konfiguracji JUL w systemie plików w ścieżce, którą Twoja aplikacja może odczytać (np. ./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 go tylko do katalogu zasobów ścieżki klasy.

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