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 della richiesta e della risposta.

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

Punto chiave: le richieste di modifica in cui l'errore parziale è true non causano l'errore dell'intera richiesta. Pertanto, i log degli errori parziali vengono sempre registrati a livello di esito positivo, non a livello di errore.

Troncamento dei log dettagliati

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

Log4j 2

1. Aggiungi una dipendenza alla libreria log4j-slf4j2-impl, sostituendo 2.x.y con la versione di Log4j 2 che utilizzi nel 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 alla libreria slf4j-log4j12, sostituendo 1.x.y con la versione di Log4j 1.2 che utilizzi nel 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 percorso di classe, 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 alla libreria slf4j-jdk14, sostituendo 2.x.y con la versione 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 nel 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.