Configurazione logging

Il logging nella libreria client Java è configurato con SLF4J, una facciata di logging generica per Java che consente di indirizzare i log a molte implementazioni di logging diverse, come Log4j 2, Logback o java.util.logging (JUL). Forniamo file di configurazione di esempio per Log4j 2 e JUL.

Layout e funzionalità dei log

Le richieste vengono registrate con un riepilogo di una riga e il corpo e le intestazioni completi di richiesta e risposta.

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

Troncamento del log dettagliato

Per impostazione predefinita, i log dettagliati vengono troncati per evitare la creazione di log di grandi dimensioni. Per modificare la lunghezza in cui i log vengono troncati, imposta la proprietà JVM -Dapi.googleads.maxLogMessageLength=<number>. Se imposti -1, il troncamento dei log viene disattivato.

Log4j 2

  1. Aggiungi una dipendenza dalla libreria log4j-slf4j2-impl, sostituendo 2.x.y con la versione di Log4j 2 che utilizzi nel tuo progetto:

    <dependency>
      <groupId>org.apache.logging.log4j</groupId>
      <artifactId>log4j-slf4j2-impl</artifactId>
      <version>2.x.y</version>
    </dependency>
    
  2. (Facoltativo) Crea un file di configurazione log4j2.xml nella directory delle risorse (ad esempio, src/main/resources in Maven). Log4j 2 carica il file di configurazione dal classpath, non dalla directory di lavoro, quindi assicurati di crearlo in una directory delle risorse.

  3. Esegui l'applicazione specificando -Dlog4j.configurationFile=<CONFIG_FILE_PATH>. Puoi specificare CONFIG_FILE_PATH=googleads-logging/log4j2.xml per utilizzare il file di configurazione predefinito incluso nella libreria client.

Log4j 1.2 (legacy)

  1. Aggiungi una dipendenza dalla libreria slf4j-log4j12, sostituendo 1.x.y con la versione di Log4j 1.2 che utilizzi 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 src/main/resources in Maven. Log4j 1.2 carica il file di configurazione dal classpath, non dalla directory di lavoro, quindi assicurati di copiarlo in una directory delle risorse.

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

Java Util Logging

  1. Aggiungi una dipendenza dalla libreria slf4j-jdk14, sostituendo 2.x.y con la versione di SLF4J utilizzata nel tuo progetto:

    <dependency>
      <groupId>org.slf4j</groupId>
      <artifactId>slf4j-jdk14</artifactId>
      <version>2.x.y</version>
    </dependency>
    
  2. Crea un file di configurazione JUL sul file system in un percorso leggibile dalla tua applicazione (ad esempio, ./jdk-logger.properties). Un modello è disponibile all'indirizzo google-ads/src/main/resources/googleads-logging/jdk-logger.properties. JUL legge solo dal file system, quindi non copiarlo solo nella directory delle risorse del classpath.

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