Logowanie

Usługa Logging jest skonfigurowana z użyciem SLF4J ogólnej biblioteki logów dla języka Java, pozwala kierować logi do wielu różnych implementacji logowania. Zapewniamy i plików konfiguracji dla log4j 1.2/2 i Java Util Logging (JUL).

Układ i funkcje logowania

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

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. Do zmień długość obcinania logów, ustaw -Dapi.googleads.maxLogMessageLength=<number> Ustawienie -1 wyłączeń obcinania logów.

Log4j 2

  1. Dodaj zależność z biblioteki log4j-slf4j-impl, zastępując fragment 2.x.y w wersji Log4j 2, której używasz w swoim projekcie.

    <dependency>
      <groupId>org.apache.logging.log4j</groupId>
      <artifactId>log4j-slf4j-impl</artifactId>
      <version>2.x.y</version>
    </dependency>
    
  2. (Opcjonalnie) Utwórz w katalogu zasobów plik konfiguracji dla przykład w narzędziu Maven: src/main/resources. Log4j 2 wczytuje swoją konfigurację ze ścieżki klasy, a nie z katalogu roboczego, utwórz więc plik katalogu zasobów.

  3. Uruchom swoją aplikację, określając -Dlog4j.configurationFile=<CONFIG_FILE_PATH> Możesz określić CONFIG_FILE_PATH=googleads-logging/log4j2.xml, aby użyć wartości domyślnej do biblioteki klienta.

Log4j 1.2 (starsza wersja)

  1. Dodaj zależność z biblioteki slf4j-log4j12, zastępując 1.x.y ciągiem wersji 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 projektów, np. w Maven ścieżka to src/main/resources. Log4j 1.2 wczytuje ze ścieżki klasy, a nie z katalogu roboczego, upewnij się więc, skopiować do katalogu zasobów.

  3. Uruchom swoją aplikację, używając parametru -Dlog4j.configuration=<CONFIG_FILE_PATH>. Możesz wybrać CONFIG_FILE_PATH=googleads-logging/log4j.properties, która będzie używana domyślny plik konfiguracji dołączony 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 odczytu Twojej aplikacji (np. ./jdk-logger.properties). Szablon to dostępne na google-ads/src/main/resources/googleads-logging/jdk-logger.properties LIP do odczytu danych tylko z systemu plików, więc nie kopiuj do katalogu zasobów.

  3. Uruchom aplikację określającą -Djava.util.logging.config.file=./jdk-logger.properties