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)