Logging

Le richieste, le risposte e i messaggi di riepilogo effettuati 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 in livelli di log differenti. Se la risposta dell'API è andata a buon fine, il riepilogo viene registrato in INFO e la richiesta e le risposte complete vengono registrate all'indirizzo DEBUG. Per una richiesta che ha generato un errore dell'API, il messaggio di riepilogo verrà registrato in WARN e la richiesta e la risposta complete verranno registrate all'indirizzo INFO.

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

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

Configurazione

La libreria client utilizza una classe personalizzata per tutti gli scopi di logging e viene esposta tramite il modulo GoogleAdsLogger. Questa classe fornisce una configurazione predefinita che sia i logger di riepilogo che quelli di dettagli registrano nei file relativi nella cartella logs all'interno della directory HOME. Tuttavia, è possibile eseguire l'override della configurazione predefinita fornendo un file log4perl.conf nella directory HOME.

Il logging può essere attivato/disattivato utilizzando i seguenti metodi:

  • Attiva il logging per entrambi i logger.

    Google::Ads::GoogleAds::Logging::GoogleAdsLogger::enable_all_logging();
    
  • Disabilita 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 sul modo in cui vengono registrate le richieste.