Logging

Il logging è configurato con SLF4J, una libreria di logging generica per Java, che consente di indirizzare i log a molte implementazioni di logging diverse. Forniamo file di configurazione per log4j 1.2/2 e Java Util Logging (JUL).

Layout e funzionalità di logging

Le richieste vengono registrate con un riepilogo di una riga e il corpo completo della richiesta/risposta e intestazioni.

Tipo di log Nome log Livello riuscito Livello di errore
RIEPILOGO com.google.ads.googleads.lib.request.summary INFORMAZIONI AVVISO
DETTAGLIO com.google.ads.googleads.lib.request.detail DEBUG INFORMAZIONI

Troncamento log dettagli

I log dettagliati vengono troncati per impostazione predefinita per evitare di creare log di grandi dimensioni. A modifica la lunghezza di corrispondenza dei log, imposta -Dapi.googleads.maxLogMessageLength=<number>. L'impostazione di -1 viene disattivata troncamento del log.

Log4j 2

  1. Aggiungi una dipendenza alla libreria log4j-slf4j-impl, sostituendo 2.x.y con la versione di Log4j 2 che stai utilizzando nel tuo progetto.

    <dependency>
      <groupId>org.apache.logging.log4j</groupId>
      <artifactId>log4j-slf4j-impl</artifactId>
      <version>2.x.y</version>
    </dependency>
    
  2. (Facoltativo) Crea un file di configurazione nella directory delle risorse, per esempio, in Maven: src/main/resources. Log4j 2 carica la sua configurazione in classpath, non dalla directory di lavoro, quindi assicurati di creare della directory di risorse.

  3. Esegui l'applicazione, specificando -Dlog4j.configurationFile=<CONFIG_FILE_PATH>. Puoi specificare CONFIG_FILE_PATH=googleads-logging/log4j2.xml per utilizzare l'impostazione predefinita di configurazione del deployment incluso nelle librerie client.

Log4j 1.2 (legacy)

  1. Aggiungi una dipendenza alla libreria slf4j-log4j12, sostituendo 1.x.y con la versione di Log4j 1.2 che stai utilizzando nel tuo progetto.

    <dependency>
      <groupId>org.slf4j</groupId>
      <artifactId>slf4j-log4j12</artifactId>
      <version>1.x.y</version>
    </dependency>
    
  2. (Facoltativo) Crea un file di configurazione nella directory delle risorse del progetto. ad esempio, in Maven, il percorso è src/main/resources. Log4j 1.2 carica la sua di configurazione del deployment da classpath, non dalla directory di lavoro, quindi che copi in una directory delle risorse.

  3. Esegui l'applicazione specificando -Dlog4j.configuration=<CONFIG_FILE_PATH>. Puoi specificare CONFIG_FILE_PATH=googleads-logging/log4j.properties da utilizzare il file di configurazione predefinito incluso con le librerie client.

Logging Utili Java

  1. Aggiungi una dipendenza alla libreria slf4j-jdk14.

    <dependency>
      <groupId>org.slf4j</groupId>
      <artifactId>slf4j-jdk14</artifactId>
      <version>1.7.25</version>
    </dependency>
    
  2. Creare un file di configurazione JUL sul file system in un percorso leggibile da dell'applicazione (ad esempio ./jdk-logger.properties). Un modello è fornito in google-ads/src/main/resources/googleads-logging/jdk-logger.properties. LUG legge solo dal file system, quindi non copiarlo nella directory delle risorse.

  3. Esegui l'applicazione specificando -Djava.util.logging.config.file=./jdk-logger.properties.