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 e le intestazioni completi della richiesta/risposta.
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. Per modificare la lunghezza di corrispondenza dei log, imposta -Dapi.googleads.maxLogMessageLength=<number>
. L'impostazione di -1
disabilita
il troncamento dei log.
Log4j 2
Aggiungi una dipendenza alla libreria
log4j-slf4j-impl
, sostituendo2.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>
(Facoltativo) Crea un file di configurazione nella directory delle risorse, ad esempio in Maven:
src/main/resources
. Log4j 2 carica il file di configurazione da classpath, non dalla directory di lavoro, quindi assicurati di crearlo in una directory delle risorse.Esegui l'applicazione specificando
-Dlog4j.configurationFile=<CONFIG_FILE_PATH>
. Puoi specificareCONFIG_FILE_PATH=googleads-logging/log4j2.xml
per utilizzare il file di configurazione predefinito incluso con le librerie client.
Log4j 1.2 (legacy)
Aggiungi una dipendenza alla libreria
slf4j-log4j12
, sostituendo1.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>
(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 file di configurazione da classpath, non dalla directory di lavoro, quindi assicurati di copiarlo in una directory delle risorse.Esegui l'applicazione specificando
-Dlog4j.configuration=<CONFIG_FILE_PATH>
. Puoi specificare cheCONFIG_FILE_PATH=googleads-logging/log4j.properties
utilizzi il file di configurazione predefinito inclusocon le librerie client.
Logging Utili Java
Aggiungi una dipendenza alla libreria
slf4j-jdk14
.<dependency> <groupId>org.slf4j</groupId> <artifactId>slf4j-jdk14</artifactId> <version>1.7.25</version> </dependency>
Crea un file di configurazione JUL nel file system in un percorso leggibile dalla tua applicazione (ad esempio,
./jdk-logger.properties
). Un modello viene fornito all'indirizzogoogle-ads/src/main/resources/googleads-logging/jdk-logger.properties
. JUL legge solo dal file system, quindi non copiarlo nella directory delle risorse.Esegui l'applicazione specificando
-Djava.util.logging.config.file=./jdk-logger.properties
.