Включить ведение журнала

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

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

Библиотека регистрирует события на разных уровнях в зависимости от результата запроса к API:

Тип события Уровень ведения сводного журнала Полный уровень ведения журнала запросов и ответов
Успешный ответ API INFO DEBUG
Ошибка API WARN INFO
Частичный сбой Нет DEBUG (сведения о частичном сбое)

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

Вы можете настроить ведение журнала в файле конфигурации google_ads_config.rb или программно во время выполнения.

Регистратор по умолчанию

Чтобы настроить регистратор по умолчанию, укажите поля log_level и log_target в файле google_ads_config.rb:

Google::Ads::GoogleAds::Config.new do |c|
  # Valid levels: 'DEBUG', 'INFO', 'WARN', 'ERROR', 'FATAL'
  c.log_level = 'INFO'

  # Output destination, such as STDOUT, STDERR, or a file path
  c.log_target = STDOUT
end

Специальный регистратор

Вы также можете указать собственный экземпляр Ruby Logger в поле logger. Если вы укажете logger, то log_level и log_target будут игнорироваться:

require 'logger'

# In google_ads_config.rb:
Google::Ads::GoogleAds::Config.new do |c|
  c.logger = Logger.new('log/google_ads.log')
end

Вы также можете назначить собственный регистратор после создания экземпляра клиента с помощью client.logger=. Обратите внимание, что это влияет только на клиентов сервиса, полученных (client.service.<name>) после того, как задано значение client.logger:

require 'logger'

client = Google::Ads::GoogleAds::GoogleAdsClient.new
client.logger = Logger.new(STDOUT)