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 registra tipi diversi di eventi a livelli di log diversi. In caso di risposta API positiva, il riepilogo verrà registrato in INFO e la richiesta e le risposte complete verranno registrate in DEBUG. Per una richiesta che ha generato un errore API, il messaggio di riepilogo verrà registrato in WARN e la richiesta e la risposta complete verranno registrate in INFO.

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

Per gli errori parziali, i dettagli dell'errore parziale verranno registrati in DEBUG.

Configurazione

La libreria client utilizza una classe personalizzata per tutte le finalità di logging ed è esposta tramite il modulo GoogleAdsLogger. Questa classe fornisce una configurazione predefinita che consente ai logger di riepilogo e dettagliati di registrare i log nei file relativi nella cartella logs della directory HOME. Tuttavia, la configurazione predefinita può essere sostituita 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();
    
  • Disattiva il logging del riepilogo.

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

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

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