Logging

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

Level Log

Library akan mencatat berbagai jenis peristiwa ke dalam log di berbagai level log. Pada respons API yang berhasil, ringkasan akan dicatat ke dalam log pada INFO, dan permintaan serta respons lengkap akan dicatat ke dalam log di DEBUG. Pada permintaan yang mengakibatkan error API, pesan ringkasan akan dicatat ke dalam log di WARN, dan permintaan serta respons lengkap akan dicatat ke dalam log di 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 parsial, detail kegagalan parsial akan dicatat dalam log di DEBUG.

Konfigurasi

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 di folder logs pada direktori HOME Anda. Namun, konfigurasi default dapat diganti dengan menyediakan file log4perl.conf di direktori HOME Anda.

Logging dapat diaktifkan/dinonaktifkan menggunakan metode berikut:

  • Mengaktifkan logging untuk kedua pencatat log.

    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 atas cara mencatat permintaan ke dalam log.