Logging

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

Level log

Library mencatat berbagai jenis peristiwa ke level log yang berbeda. Pada respons API yang berhasil, ringkasan dicatat ke dalam log di INFO, dan permintaan serta respons lengkap dicatat ke dalam log di DEBUG. Pada permintaan yang menghasilkan error API, pesan ringkasan dicatat ke dalam log di WARN, sedangkan permintaan dan respons lengkap 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 dicatat ke logger DETAIL di DEBUG.

Konfigurasi

Library klien menggunakan class kustom untuk semua tujuan logging dan diekspos melalui modul GoogleAdsLogger. Class ini menyediakan konfigurasi default tempat pencatat log ringkasan dan detail menulis ke file di folder logs di bawah direktori HOME Anda.

Menyesuaikan konfigurasi Log4perl

Anda dapat mengganti konfigurasi default dengan menyediakan file log4perl.conf kustom di direktori HOME, atau dengan melakukan inisialisasi Log::Log4perl langsung di aplikasi sebelum melakukan panggilan API.

Mengaktifkan atau menonaktifkan log

Logging dapat diaktifkan atau dinonaktifkan secara terprogram menggunakan metode bantuan berikut:

• Aktifkan logging untuk kedua logger (teruskan 1 untuk menetapkan level ke DEBUG sehingga payload permintaan dan respons lengkap dicatat ke dalam log untuk panggilan yang berhasil):

  use Google::Ads::GoogleAds::Logging::GoogleAdsLogger;
  
  Google::Ads::GoogleAds::Logging::GoogleAdsLogger::enable_all_logging(1);
  

• Menonaktifkan semua logging:

  Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_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 kontrol yang lebih besar atas cara permintaan dicatat ke dalam log.