Logowanie

Usługa Logging jest skonfigurowana za pomocą SLF4J – ogólnej biblioteki logowania dla Javy, która umożliwia kierowanie logów do wielu różnych implementacji logowania. Udostępniamy pliki konfiguracji dla log4j w wersji 1.2/2 i usługi Java Util Logging (JUL).

Układ i funkcje logowania

Żądania są logowane z podsumowaniem w jednym wierszu oraz pełną treścią żądania/odpowiedzi i nagłówkami.

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

Obcięcie szczegółów logu

Szczegółowe logi są domyślnie obcięte, aby uniknąć tworzenia dużych logów. Aby zmienić długość przycinania logów, ustaw -Dapi.googleads.maxLogMessageLength=<number>. Ustawienie -1 wyłącza obcinanie logów.

Log4j 2

  1. Dodaj zależność z biblioteką 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 narzędziu Maven: src/main/resources. Log4j 2 wczytuje swój plik konfiguracji ze ścieżki klasy, a nie z katalogu roboczego, dlatego upewnij się, że tworzysz go w katalogu zasobów.

  3. Uruchom aplikację, używając parametru -Dlog4j.configurationFile=<CONFIG_FILE_PATH>. Możesz określić, czy CONFIG_FILE_PATH=googleads-logging/log4j2.xml ma używać domyślnego pliku konfiguracji dołączonego do bibliotek klienta.

Log4j 1.2 (starsza wersja)

  1. Dodaj zależność z biblioteką 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 swojego projektu, np. w narzędziu Maven ścieżka to src/main/resources. Log4j 1.2 wczytuje plik konfiguracji ze ścieżki klasy, a nie z katalogu roboczego, dlatego upewnij się, że kopiujesz go do katalogu zasobów.

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

Logowanie przy użyciu narzędzi Java

  1. Dodaj zależność z biblioteką 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 w ścieżce czytelnej z aplikacji (np. ./jdk-logger.properties). Szablon jest dostępny pod adresem google-ads/src/main/resources/googleads-logging/jdk-logger.properties. JUL odczytuje tylko dane z systemu plików, dlatego nie kopiuj go do katalogu zasobów.

  3. Uruchom aplikację przy użyciu właściwości -Djava.util.logging.config.file=./jdk-logger.properties.