Журналы

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

Уровни ведения журнала

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

Тип журнала	Название журнала	Уровень успеха	Уровень сбоя
КРАТКОЕ ОПИСАНИЕ	Google.Ads.GoogleAds.Summary	ИНФОРМАЦИЯ	WARN
ПОДРОБНЫЕ ДАННЫЕ	Google.Ads.GoogleAds.Detail	ОТЛАДКА	ИНФОРМАЦИЯ

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

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

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

Настройка конфигурации Log4perl

Вы можете переопределить конфигурацию по умолчанию, добавив собственный файл log4perl.conf в каталог HOME или инициализировав Log::Log4perl непосредственно в приложении перед вызовами API.

Как включить или отключить журналы

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

• Включите ведение журнала для обоих регистраторов (передайте 1, чтобы установить уровень DEBUG, чтобы для успешных вызовов регистрировались полные полезные нагрузки запросов и ответов):

  use Google::Ads::GoogleAds::Logging::GoogleAdsLogger;
  
  Google::Ads::GoogleAds::Logging::GoogleAdsLogger::enable_all_logging(1);
  

• Отключить все журналы:

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

• Отключить ведение журнала сводки:

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

• Отключите подробное ведение журналов:

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

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