Skip to content

Logging

Jump to bottom
Josh Radcliff edited this page Jun 21, 2017 · 12 revisions

Contents

Overview

The client library uses SLF4J for all logging. If you want to turn on logging, you must include a plugin that bridges SLF4J with a concrete logging framework.

To quickly get you started and to serve as an example of how to do this, each example distribution uses the log4j framework, and includes a sample log4j.properties file that shows how you might configure logging if you decide to use log4j as your concrete logging framework.

The library includes the following loggers:

SOAP loggers

com.google.api.ads.adwords.lib.client.AdWordsServiceClient.soapXmlLogger
com.google.api.ads.dfp.lib.client.DfpServiceClient.soapXmlLogger

Logs incoming and outgoing SOAP requests/responses. SOAP requests and responses are logged as WARN for exceptions and INFO for all other requests. You can configure your logging framework to accept logs on these parameters.

Request info loggers

com.google.api.ads.adwords.lib.client.AdWordsServiceClient.requestInfoLogger
com.google.api.ads.dfp.lib.client.DfpServiceClient.requestInfoLogger

Logs a single line summary of each request from the client library that includes information such as the timestamp, service, method, endpoint URL, and success or failure of the request.

Product-specific loggers

AdWords has the following additional loggers.

  • Reporting:

    com.google.api.ads.adwords.lib.utils.report_download

    Report requests:

    • One-line summary logged to INFO for successful requests, and WARN for failed requests
    • HTTP headers and complete AWQL or ReportDefinition XML logged to INFO for successful requests, and WARN for failed requests

    Report responses:

    • One-line summary including HTTP status code and message logged to INFO for successful requests, and WARN for failed requests

  • BatchJob requests:

    com.google.api.ads.adwords.lib.utils.batch_job

    Operation uploads:

    • One-line summary logged to INFO for successful uploads, and WARN for failed uploads
    • Complete upload contents logged to DEBUG for all uploads

    Batch job result downloads:

    • One-line summary logged to INFO for successful downloads, and WARN for failed downloads

Because the client library uses SLF4J, the behavior of these loggers is highly customizable.

Using log4j with the example projects

To make it easier to enable logging in the example projects, each example project includes a sample log4j.properties file, as well as the log4j dependencies required at runtime.

If you are using jars

If you downloaded a file like adwords-axis-jars-and-examples-v.vv.vv.tar.gz, it will already include:

  • log4j dependencies in its src/lib folder
  • a default log4j.properties config file in its src folder

Simply make sure that both the jars in src/lib and the src/log4j.properties file are in your classpath.

If you are using maven

If you downloaded a file like adwords-axis-maven-and-examples-v.vv.vv.tar.gz, it will already include:

  • log4j dependencies in its pom.xml file
  • a default log4j.properties config file in its src/main/resources folder

Maven should automatically include the log4j dependencies and the config file in your classpath, so logging will be enabled by default.

Setting up your own project

This is where the flexibility of SLF4J proves useful. You simply need to:

  1. Include the SLF4J dependencies that bridge SLF4J to your logging framework of choice
  2. Configure the relevant loggers in the config file for your logging framework

The SLF4J manual contains a list of bindings for common logging frameworks.

If you are using jars

To use a different framework than log4j, remove the slf4j-log4j12-v.v.v.jar from your classpath and fetch a different one from http://www.slf4j.org/download.html.

If you are using maven

To bridge SLF4J for a logging framework, you must include the plugin and logging framework dependencies in the dependencies list of your pom.xml file.

For example, if you want to use the log4j logging framework, add the following to your pom.xml file.

 <!-- Adds the log4j framework -->
 <dependency>
   <groupId>log4j</groupId>
   <artifactId>log4j</artifactId>
   <version>1.2.16</version>
 </dependency>
 <!-- Make SLF4J use log4j as the logging framework -->
 <dependency>
   <groupId>org.slf4j</groupId>
   <artifactId>slf4j-log4j12</artifactId>
   <version>1.7.7</version>
 </dependency>

If you want to use JDK logging, add the following to your pom.xml file.

 <!-- Adds the log4j framework -->
 <dependency>
   <groupId>log4j</groupId>
   <artifactId>log4j</artifactId>
   <version>1.2.16</version>
 </dependency>
 <!-- Make SLF4J use JDK logging as the logging framework -->
 <dependency>
   <groupId>org.slf4j</groupId>
   <artifactId>slf4j-jdk14</artifactId>
   <version>1.7.12</version>
 </dependency>
Clone this wiki locally