로깅 사용 설정

Ruby 클라이언트 라이브러리의 기본 로거 또는 자체 맞춤 Ruby 로거를 사용하여 Google Ads API로 전송된 요청, 응답, 요약 메시지를 로깅할 수 있습니다. 로깅 구성이 제공되지 않으면 기본적으로 로깅이 사용 중지됩니다.

로그 수준

라이브러리는 API 요청의 결과에 따라 다양한 로그 수준에서 이벤트를 로깅합니다.

이벤트 유형 요약 로그 수준 전체 요청 및 응답 로그 수준
성공적인 API 응답 INFO DEBUG
API 오류 WARN INFO
부분 실패 없음 DEBUG (부분 실패 세부정보)

구성

google_ads_config.rb 구성 파일에서 또는 런타임에 프로그래매틱 방식으로 로깅을 구성할 수 있습니다.

기본 로거

google_ads_config.rb 파일에서 log_level 및 log_target 필드를 지정하여 기본 로거를 설정합니다.

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

맞춤 로거

logger 필드를 사용하여 자체 맞춤 Ruby 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.logger이 설정된 후 가져온 서비스 클라이언트(client.service.<name>)에만 적용됩니다.

require 'logger'

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