логирование

Ведение журналов настраивается с помощью SLF4J — универсальной библиотеки журналирования для Java, которая позволяет направлять журналы на множество различных реализаций журналирования. Мы предоставляем файлы конфигурации для log4j 1.2/2 и Java Util Logging (JUL).

Структура и функциональность журналирования

Запросы регистрируются с однострочной сводкой, а также полным телом запроса/ответа и заголовками.

Тип журнала Имя журнала Уровень успеха Уровень отказа
КРАТКОЕ СОДЕРЖАНИЕ com.google.ads.googleads.lib.request.summary ИНФОРМАЦИЯ ПРЕДУПРЕЖДАТЬ
ДЕТАЛИ com.google.ads.googleads.lib.request.detail ОТЛАЖИВАТЬ ИНФОРМАЦИЯ

Подробное усечение журнала

Подробные журналы по умолчанию усекаются, чтобы избежать создания больших журналов. Чтобы изменить длину усечения журналов, задайте -Dapi.googleads.maxLogMessageLength=<number> . Настройка -1 отключает усечение журнала.

Лог4дж ​​2

  1. Добавьте зависимость от библиотеки log4j-slf4j-impl , заменив 2.xy на версию Log4j 2, которую вы используете в своем проекте.

    <dependency>
      <groupId>org.apache.logging.log4j</groupId>
      <artifactId>log4j-slf4j-impl</artifactId>
      <version>2.x.y</version>
    </dependency>
    
  2. (Необязательно) Создайте файл конфигурации в каталоге ресурсов, например, в Maven: src/main/resources . Log4j 2 загружает свой файл конфигурации из пути к классам, а не из рабочего каталога, поэтому убедитесь, что вы создаете его в каталоге ресурсов.

  3. Запустите приложение, указав -Dlog4j.configurationFile=<CONFIG_FILE_PATH> . Вы можете указать CONFIG_FILE_PATH=googleads-logging/log4j2.xml чтобы использовать файл конфигурации по умолчанию, включенный в клиентские библиотеки.

Log4j 1.2 (устаревшая версия)

  1. Добавьте зависимость от библиотеки slf4j-log4j12 , заменив 1.xy на версию Log4j 1.2, которую вы используете в своем проекте.

    <dependency>
      <groupId>org.slf4j</groupId>
      <artifactId>slf4j-log4j12</artifactId>
      <version>1.x.y</version>
    </dependency>
    
  2. (Необязательно) Создайте файл конфигурации в каталоге ресурсов вашего проекта, например, в Maven, путь — src/main/resources . Log4j 1.2 загружает свой файл конфигурации из пути к классам, а не из рабочего каталога, поэтому обязательно скопируйте его в каталог ресурсов.

  3. Запустите приложение, указав -Dlog4j.configuration=<CONFIG_FILE_PATH> . Вы можете указать CONFIG_FILE_PATH=googleads-logging/log4j.properties чтобы использовать файл конфигурации по умолчанию, включенный в клиентские библиотеки.

Журналирование Java-утилиты

  1. Добавьте зависимость от библиотеки slf4j-jdk14 .

    <dependency>
      <groupId>org.slf4j</groupId>
      <artifactId>slf4j-jdk14</artifactId>
      <version>1.7.25</version>
    </dependency>
    
  2. Создайте файл конфигурации JUL в файловой системе по пути, читаемому вашим приложением (например, ./jdk-logger.properties ). Шаблон доступен по google-ads/src/main/resources/googleads-logging/jdk-logger.properties . JUL читает только из файловой системы, поэтому не копируйте в каталог ресурсов.

  3. Запустите приложение, указав -Djava.util.logging.config.file=./jdk-logger.properties .