Logowanie

Usługa Logging jest skonfigurowana z użyciem 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 1.2/2 i Java util Logging (JUL).

Układ i funkcje logowania

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

Typ logu Nazwa logu Poziom sukcesu Poziom błędów
PODSUMOWANIE com.google.ads.googleads.lib.request.summary INFORMACJE UWAGA
SZCZEGÓŁY com.google.ads.googleads.lib.request.detail DEBUGUJ INFORMACJE

Obcinanie logu szczegółów

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

Log4j 2

  1. Dodaj zależność z 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, na przykład w Maven: src/main/resources. Log4j 2 wczytuje plik konfiguracji ze ścieżki klasy, a nie z katalogu roboczego, więc utwórz plik w katalogu zasobów.

  3. Uruchom aplikację, używając parametru -Dlog4j.configurationFile=<CONFIG_FILE_PATH>. Możesz wskazać 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ść z biblioteką 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 konfiguracji w katalogu zasobów projektów, np. w Maven ścieżka to src/main/resources. Log4j 1.2 wczytuje plik konfiguracji ze ścieżki klasy, a nie z katalogu roboczego, więc upewnij się, że skopiujesz go do katalogu zasobów.

  3. Uruchom swoją aplikację, używając parametru -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.

Logowanie narzędzi Java

  1. Dodaj zależność w bibliotece 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 dostępnej do odczytania z Twojej aplikacji (np. ./jdk-logger.properties). Szablon znajdziesz tutaj: google-ads/src/main/resources/googleads-logging/jdk-logger.properties. JUL czyta tylko z systemu plików, więc nie kopiuj do katalogu zasobów.

  3. Uruchom aplikację, podając właściwość -Djava.util.logging.config.file=./jdk-logger.properties.