Logging

Permintaan, respons, dan pesan ringkasan yang dibuat ke Google Ads API dapat dicatat dengan logger kustom Anda sendiri atau pencatat log default di library klien untuk Perl.

Level Log

Library ini akan mencatat berbagai jenis peristiwa ke dalam log ke berbagai level log. Jika respons API berhasil, ringkasan akan dicatat ke dalam log pada INFO, dan permintaan serta respons lengkap akan dicatat ke dalam log pada DEBUG. Atas permintaan yang mengakibatkan error API, pesan ringkasan akan dicatat ke dalam log di WARN serta permintaan dan respons lengkap akan dicatat ke dalam log pada INFO.

Jenis log Nama log Tingkat keberhasilan Tingkat kegagalan
RINGKASAN Google.Ads.GoogleAds.Summary INFO WARN
DETAIL Google.Ads.GoogleAds.Detail DEBUG INFO

Untuk kegagalan sebagian, detail kegagalan sebagian akan dicatat dalam log pada DEBUG.

Configuration

Library klien menggunakan class kustom untuk semua tujuan logging dan diekspos melalui modul GoogleAdsLogger. Class ini menyediakan konfigurasi default yang akan dicatat oleh logger ringkasan dan detail ke file relatif dalam folder logs pada direktori HOME Anda. Namun, konfigurasi default dapat diganti dengan menyediakan file log4perl.conf di direktori HOME.

Logging dapat diaktifkan/dinonaktifkan menggunakan metode berikut:

  • Mengaktifkan logging untuk kedua pencatat.

    Google::Ads::GoogleAds::Logging::GoogleAdsLogger::enable_all_logging();
    
  • Menonaktifkan logging ringkasan.

    Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_summary_logging();
    
  • Menonaktifkan logging detail.

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

Anda dapat menggunakan metode class GoogleAdsLogger secara langsung untuk mendapatkan kontrol yang lebih besar terkait cara permintaan dicatat.