Эта страница переведена с помощью Cloud Translation API.

Настроить ведение журнала

В клиентской библиотеке Java логирование настраивается с помощью SLF4J, универсального фасада логирования для Java, который позволяет направлять логи во множество различных реализаций логирования, таких как Log4j 2, Logback или java.util.logging (JUL). Мы предоставляем примеры конфигурационных файлов для Log4j 2 и JUL.

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

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

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

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

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

Log4j 2

Добавьте зависимость от библиотеки log4j-slf4j2-impl , заменив 2.xy на версию Log4j 2, используемую в вашем проекте:
```
<dependency>
  <groupId>org.apache.logging.log4j</groupId>
  <artifactId>log4j-slf4j2-impl</artifactId>
  <version>2.x.y</version>
</dependency>
```
(Необязательно) Создайте конфигурационный файл log4j2.xml в каталоге ресурсов (например, src/main/resources в Maven). Log4j 2 загружает свой конфигурационный файл из classpath, а не из рабочего каталога, поэтому убедитесь, что вы создали его в каталоге ресурсов.
Запустите приложение, указав параметр -Dlog4j.configurationFile=<CONFIG_FILE_PATH> . Вы можете указать CONFIG_FILE_PATH=googleads-logging/log4j2.xml , чтобы использовать файл конфигурации по умолчанию, входящий в состав клиентской библиотеки.

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

Добавьте зависимость от библиотеки slf4j-log4j12 , заменив 1.xy на версию Log4j 1.2, используемую в вашем проекте:
```
<dependency>
  <groupId>org.slf4j</groupId>
  <artifactId>slf4j-log4j12</artifactId>
  <version>1.x.y</version>
</dependency>
```
(Необязательно) Создайте конфигурационный файл в каталоге ресурсов вашего проекта, например, src/main/resources в Maven. Log4j 1.2 загружает свой конфигурационный файл из classpath, а не из рабочего каталога, поэтому убедитесь, что вы скопировали его в каталог ресурсов.
Запустите приложение, указав -Dlog4j.configuration=<CONFIG_FILE_PATH> . Вы можете указать CONFIG_FILE_PATH=googleads-logging/log4j.properties чтобы использовать файл конфигурации по умолчанию, входящий в состав клиентской библиотеки.

Ведение логов Java-утилиты

Добавьте зависимость от библиотеки slf4j-jdk14 , заменив 2.xy на версию SLF4J, используемую в вашем проекте:
```
<dependency>
  <groupId>org.slf4j</groupId>
  <artifactId>slf4j-jdk14</artifactId>
  <version>2.x.y</version>
</dependency>
```
Создайте конфигурационный файл JUL в файловой системе по пути, доступному для чтения из вашего приложения (например, ./jdk-logger.properties ). Шаблон предоставляется по адресу google-ads/src/main/resources/googleads-logging/jdk-logger.properties . JUL читает только из файловой системы, поэтому не копируйте его только в каталог ресурсов classpath.
Запустите приложение, указав параметр -Djava.util.logging.config.file=./jdk-logger.properties .