로깅

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

로그 수준

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

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

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

구성

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

Log4perl 구성 맞춤설정

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

로그 사용 설정 또는 중지

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

• 두 로거 모두에 로깅을 사용 설정합니다 (성공적인 호출에 대해 전체 요청 및 응답 페이로드가 로깅되도록 수준을 DEBUG로 설정하려면 1을 전달).

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