Logging
Stay organized with collections
Save and categorize content based on your preferences.
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.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-25 UTC.
[null,null,["Last updated 2025-08-25 UTC."],[[["\u003cp\u003eThe Google Ads API client library for Perl allows logging of requests, responses, and summaries using a custom or default logger.\u003c/p\u003e\n"],["\u003cp\u003eLogging levels include \u003ccode\u003eINFO\u003c/code\u003e, \u003ccode\u003eDEBUG\u003c/code\u003e, and \u003ccode\u003eWARN\u003c/code\u003e, used to categorize different event types like successes, failures, and partial failures.\u003c/p\u003e\n"],["\u003cp\u003eThe default logger configuration saves logs to the \u003ccode\u003elogs\u003c/code\u003e folder in your home directory, which can be customized by providing a \u003ccode\u003elog4perl.conf\u003c/code\u003e file.\u003c/p\u003e\n"],["\u003cp\u003eLogging can be controlled through the \u003ccode\u003eGoogleAdsLogger\u003c/code\u003e module, allowing for enabling/disabling logging or more advanced customization.\u003c/p\u003e\n"]]],[],null,["# Logging\n\nRequests, responses, and summary messages made to the Google Ads API can be\nlogged with your own custom logger or the default logger in the client library\nfor Perl.\n\nLog Levels\n----------\n\nThe library will log different types of events to different log levels. On a\nsuccessful API response, the summary will be logged at `INFO`, and the full\nrequest and responses will be logged at `DEBUG`. On a request that resulted in\nan API error, the summary message will be logged at `WARN` and the full request\nand response will be logged at `INFO`.\n\n| Log type | Log name | Success level | Failure level |\n|----------|------------------------------|---------------|---------------|\n| SUMMARY | Google.Ads.GoogleAds.Summary | INFO | WARN |\n| DETAIL | Google.Ads.GoogleAds.Detail | DEBUG | INFO |\n\nFor partial failures, the partial failure details will be logged at `DEBUG`.\n\nConfiguration\n-------------\n\nThe client library uses a custom class for all logging purposes and is exposed\nthrough the [GoogleAdsLogger](https://github.com/googleads/google-ads-perl/blob/HEAD/lib/Google/Ads/GoogleAds/Logging/GoogleAdsLogger.pm)\nmodule. This class provides a default configuration that both summary and detail\nloggers will log to relative files in the `logs` folder under your `HOME` directory.\nBut the default configuration can be overridden by providing a\n[log4perl.conf](https://github.com/googleads/google-ads-perl/blob/HEAD/log4perl.conf)\nfile in your `HOME` directory.\n\nLogging can be enabled/disabled using the following methods:\n\n- Enables logging for both loggers.\n\n Google::Ads::GoogleAds::Logging::GoogleAdsLogger::enable_all_logging();\n\n- Disables the summary logging.\n\n Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_summary_logging();\n\n- Disables the detail logging.\n\n Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_detail_logging();\n\nYou can use the methods of the `GoogleAdsLogger` class directly for even more\ncontrol over how requests are logged."]]
