Skonfiguruj logowanie

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

Układ i funkcjonalność logów

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

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

Obcinanie szczegółowych logów

Szczegółowe logi są domyślnie obcinane, 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 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 konfiguracji log4j2.xml w katalogu zasobów (np. src/main/resources w Mavenie). Log4j 2 wczytuje plik konfiguracji 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 określić CONFIG_FILE_PATH=googleads-logging/log4j2.xml, aby użyć 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, np. src/main/resources w Mavenie. Log4j 1.2 wczytuje plik konfiguracji 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 użyć wartości 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 odczytywanej przez aplikację (np. ./jdk-logger.properties). Szablon jest dostępny pod adresem 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 klas.

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