Logging

  • The Google Ads API client library for Perl allows logging of requests, responses, and summaries using a custom or default logger.

  • Logging levels include INFO, DEBUG, and WARN, used to categorize different event types like successes, failures, and partial failures.

  • The default logger configuration saves logs to the logs folder in your home directory, which can be customized by providing a log4perl.conf file.

  • Logging can be controlled through the GoogleAdsLogger module, allowing for enabling/disabling logging or more advanced customization.

Requests, responses, and summary messages made to the Google Ads API can be logged with your own custom logger or the default logger in the client library for Perl.

Log Levels

The library will log different types of events to different log levels. On a successful API response, the summary will be logged at INFO, and the full request and responses will be logged at DEBUG. On a request that resulted in an API error, the summary message will be logged at WARN and the full request and response will be logged at INFO.

Log type Log name Success level Failure level
SUMMARY Google.Ads.GoogleAds.Summary INFO WARN
DETAIL Google.Ads.GoogleAds.Detail DEBUG INFO

For partial failures, the partial failure details will be logged at DEBUG.

Configuration

The client library uses a custom class for all logging purposes and is exposed through the GoogleAdsLogger module. This class provides a default configuration that both summary and detail loggers will log to relative files in the logs folder under your HOME directory. But the default configuration can be overridden by providing a log4perl.conf file in your HOME directory.

Logging can be enabled/disabled using the following methods:

  • Enables logging for both loggers.

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

  • Disables the summary logging.

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

  • Disables the detail logging.

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

You can use the methods of the GoogleAdsLogger class directly for even more control over how requests are logged.