Logging

Le richieste, le risposte e i messaggi di riepilogo inviati all'API Google Ads possono essere registrati con il tuo logger personalizzato o con il logger predefinito nella libreria client per Perl.

Livelli di log

La libreria registrerà diversi tipi di eventi su diversi livelli di log. Se l'esito della risposta dell'API è positivo, il riepilogo verrà registrato all'indirizzo INFO e la richiesta e le risposte complete verranno registrate all'indirizzo DEBUG. Su una richiesta che ha generato un errore API, il messaggio di riepilogo verrà registrato all'indirizzo WARN e la richiesta e la risposta complete verranno registrate all'indirizzo INFO.

Tipo di log Nome log Livello di successo Livello di errore
RIEPILOGO Google.Ads.GoogleAds.Summary INFORMAZIONI AVVISO
DETTAGLIO Google.Ads.GoogleAds.Detail DEBUG INFORMAZIONI

Per gli errori parziali, i relativi dettagli verranno registrati all'indirizzo DEBUG.

Configurazione

La libreria client utilizza una classe personalizzata per tutti gli scopi di logging ed è esposta tramite il modulo GoogleAdsLogger. Questa classe fornisce una configurazione predefinita che i log di riepilogo e dettagli verranno registrati in file relativi nella cartella logs nella directory HOME. Tuttavia, la configurazione predefinita può essere sostituita fornendo un file log4perl.conf nella directory HOME.

Logging può essere abilitato/disabilitato con i seguenti metodi:

  • Abilita il logging per entrambi i logger.

    Google::Ads::GoogleAds::Logging::GoogleAdsLogger::enable_all_logging();
    
  • Disattiva il logging di riepilogo.

    Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_summary_logging();
    
  • Disattiva il logging dei dettagli.

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

Puoi utilizzare direttamente i metodi della classe GoogleAdsLogger per un controllo ancora maggiore sulla modalità di registrazione delle richieste.