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

Запросы, ответы и сводные сообщения, отправленные в API Google Ads, можно регистрировать с помощью собственного пользовательского регистратора или регистратора по умолчанию в клиентской библиотеке для Perl.

Уровни журнала

Библиотека регистрирует различные типы событий на разных уровнях журнала. При успешном ответе API сводка будет записана в INFO , а полный запрос и ответы — в DEBUG . Если запрос привёл к ошибке API, сводка будет записана в WARN , а полный запрос и ответы — в INFO .

Тип журнала Имя журнала Уровень успеха Уровень отказа
КРАТКОЕ СОДЕРЖАНИЕ Google.Ads.GoogleAds.Summary ИНФОРМАЦИЯ ПРЕДУПРЕЖДАТЬ
ДЕТАЛЬ Google.Ads.GoogleAds.Detail ОТЛАЖИВАТЬ ИНФОРМАЦИЯ

В случае частичных сбоев сведения о частичном сбое будут регистрироваться в DEBUG .

Конфигурация

Клиентская библиотека использует специальный класс для всех задач ведения журналов, доступ к которому осуществляется через модуль GoogleAdsLogger . Этот класс предоставляет конфигурацию по умолчанию, которую как сводные, так и подробные регистраторы будут сохранять в соответствующих файлах в папке logs в вашем HOME каталоге. Однако конфигурацию по умолчанию можно переопределить, добавив файл log4perl.conf в ваш HOME каталог.

Ведение журнала можно включить/отключить следующими способами:

  • Включает ведение журнала для обоих регистраторов.

    Google::Ads::GoogleAds::Logging::GoogleAdsLogger::enable_all_logging();
    
  • Отключает ведение итогового журнала.

    Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_summary_logging();
    
  • Отключает подробное ведение журнала.

    Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_detail_logging();
    

Вы можете напрямую использовать методы класса GoogleAdsLogger для еще большего контроля над тем, как регистрируются запросы.