로깅

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

로그 수준

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

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

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

구성

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

다음 방법을 사용하여 로깅을 사용 설정/중지할 수 있습니다.

  • 두 로거 모두에 로깅을 사용 설정합니다.

    Google::Ads::GoogleAds::Logging::GoogleAdsLogger::enable_all_logging();
    
  • 요약 로깅을 사용 중지합니다.

    Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_summary_logging();
    
  • 세부정보 로깅을 사용 중지합니다.

    Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_detail_logging();
    

GoogleAdsLogger 클래스의 메서드를 직접 사용하여 요청이 로깅되는 방식을 더 세부적으로 제어할 수 있습니다.