Logging

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

Level log

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

Konfigurasi

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

Menyesuaikan konfigurasi Log4perl

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

Mengaktifkan atau menonaktifkan log

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

• Aktifkan logging untuk kedua logger (terus 1 untuk menyetel tingkat ke DEBUG sehingga payload permintaan dan respons lengkap dicatat untuk panggilan yang berhasil):

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

• Nonaktifkan semua logging:

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

• Menonaktifkan logging ringkasan:

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

• Nonaktifkan 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 permintaan dicatat.