Logging

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 e le intestazioni completi di richiesta/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

Punto chiave: la modifica delle richieste in cui l'errore parziale è true non comporterà la mancata riuscita dell'intera richiesta. Di conseguenza, i log degli errori parziali vengono sempre registrati al livello di operazione riuscita, non al livello di errore, come potrebbe essere previsto.

Troncamento log dettagli

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 -Dapi.googleads.maxLogMessageLength=<number>. L'impostazione di -1 disabilita il troncamento dei 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, ad esempio in Maven: src/main/resources. Log4j 2 carica il proprio file di configurazione da classpath, non dalla directory di lavoro, quindi assicurati di creare il file 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 con le 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 il proprio file di configurazione da classpath, non dalla directory di lavoro, quindi assicurati di copiare in una directory delle risorse.

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

Logging dell'utilizzo 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. Crea un file di configurazione JUL nel file system in un percorso leggibile dalla tua applicazione (ad esempio, ./jdk-logger.properties). Un modello è fornito in google-ads/src/main/resources/googleads-logging/jdk-logger.properties. JUL 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.