Ведение журнала

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

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

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

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

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

Log4j 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 загружает свой файл конфигурации из classpath, а не из рабочего каталога, поэтому убедитесь, что вы создаете его в каталоге ресурсов.

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 загружает свой файл конфигурации из classpath, а не из рабочего каталога, поэтому обязательно скопируйте его в каталог ресурсов.

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

Ведение журнала Java Util

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 .