Journalisation

Les requêtes, les réponses et les messages récapitulatifs envoyés à l'API Google Ads peuvent être avec votre propre enregistreur personnalisé ou avec l'enregistreur par défaut dans la bibliothèque cliente. pour Perl.

Niveaux de journalisation

La bibliothèque enregistrera différents types d'événements à différents niveaux de journalisation. Sur un de l'API réussie, le récapitulatif est consigné dans INFO et l'intégralité et les réponses correspondantes seront enregistrées à DEBUG. Sur une demande qui a abouti à erreur d'API, le message récapitulatif sera consigné à l'adresse WARN et la demande complète et la réponse sera enregistrée sous INFO.

Type de journal Nom du journal Niveau de réussite Niveau d'échec
SUMMARY Google.Ads.GoogleAds.Summary INFO WARN
DÉTAILS Google.Ads.GoogleAds.Detail DEBUG INFO

Pour les échecs partiels, les détails sont consignés dans DEBUG.

Configuration

La bibliothèque cliente utilise une classe personnalisée pour toutes les tâches de journalisation et est exposée via l'outil GoogleAdsLogger de ce module. Cette classe fournit une configuration par défaut qui, à la fois récapitulative et détaillée, Les enregistreurs se connecteront aux fichiers relatifs du dossier logs dans votre répertoire HOME. Cependant, la configuration par défaut peut être remplacée en fournissant log4perl.conf dans le répertoire HOME.

Vous pouvez activer ou désactiver la journalisation à l'aide des méthodes suivantes:

  • Active la journalisation pour les deux enregistreurs.

    Google::Ads::GoogleAds::Logging::GoogleAdsLogger::enable_all_logging();
    
  • Désactive la journalisation récapitulative.

    Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_summary_logging();
    
  • Désactive la journalisation des détails.

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

Vous pouvez utiliser directement les méthodes de la classe GoogleAdsLogger pour encore plus de détails sur la façon dont les requêtes sont journalisées.