로깅

Google Ads API에 대한 요청, 응답, 요약 메시지는 자체 맞춤 로거 또는 Perl용 클라이언트 라이브러리의 기본 로거를 사용하여 로깅할 수 있습니다.

로그 수준

라이브러리는 다양한 유형의 이벤트를 다양한 로그 수준으로 로깅합니다. API 응답이 성공하면 요약은 INFO에 로깅되고 전체 요청과 응답은 DEBUG에 로깅됩니다. API 오류가 발생하는 요청의 경우 요약 메시지는 WARN에 로깅되고 전체 요청과 응답은 INFO에 로깅됩니다.

로그 유형	로그 이름	성공 수준	실패 수준
요약	Google.Ads.GoogleAds.Summary	정보	WARN
상세정보	Google.Ads.GoogleAds.Detail	디버그	정보

부분 실패의 경우 부분 실패 세부정보가 DEBUG의 DETAIL 로거에 로깅됩니다.

구성

클라이언트 라이브러리는 모든 로깅 목적으로 커스텀 클래스를 사용하며 GoogleAdsLogger 모듈을 통해 노출됩니다. 이 클래스는 요약 및 세부정보 로거가 모두 HOME 디렉터리 아래의 logs 폴더에 있는 파일에 쓰는 기본 구성을 제공합니다.

Log4perl 구성 맞춤설정

HOME 디렉터리에 맞춤 log4perl.conf 파일을 제공하거나 API 호출을 하기 전에 애플리케이션에서 직접 Log::Log4perl을 초기화하여 기본 구성을 재정의할 수 있습니다.

로그 사용 설정 또는 사용 중지

로깅은 다음 도우미 메서드를 사용하여 프로그래매틱 방식으로 사용 설정하거나 사용 중지할 수 있습니다.

• 두 로거의 로깅을 사용 설정합니다 (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 클래스의 메서드를 직접 사용하여 요청이 로깅되는 방식을 더욱 세밀하게 제어할 수 있습니다.