El registro en la biblioteca cliente de Java se configura con SLF4J, una fachada de registro genérica para Java que permite dirigir los registros a muchas implementaciones de registro diferentes, como Log4j 2, Logback o java.util.logging (JUL). Proporcionamos archivos de configuración de muestra para Log4j 2 y JUL.
Diseño y funcionalidad del registro
Las solicitudes se registran con un resumen de una línea y el cuerpo y los encabezados completos de la solicitud y la respuesta.
| Tipo de registro | Nombre del registro | Nivel de éxito | Nivel de falla |
|---|---|---|---|
| RESUMEN | com.google.ads.googleads.lib.request.summary | INFORMACIÓN | WARN |
| DETALLE | com.google.ads.googleads.lib.request.detail | DEBUG | INFORMACIÓN |
Truncamiento de registros de detalles
De forma predeterminada, los registros detallados se truncan para evitar la creación de registros grandes. Para cambiar la longitud con la que se truncan los registros, configura la propiedad de JVM -Dapi.googleads.maxLogMessageLength=<number>. Si se configura -1, se inhabilita el truncamiento de registros.
Log4j 2
Agrega una dependencia en la biblioteca
log4j-slf4j2-imply reemplaza2.x.ypor la versión de Log4j 2 que usas en tu proyecto:<dependency> <groupId>org.apache.logging.log4j</groupId> <artifactId>log4j-slf4j2-impl</artifactId> <version>2.x.y</version> </dependency>(Opcional) Crea un archivo de configuración
log4j2.xmlen tu directorio de recursos (por ejemplo,src/main/resourcesen Maven). Log4j 2 carga su archivo de configuración desde la ruta de clase, no desde el directorio de trabajo, por lo que debes asegurarte de crearlo en un directorio de recursos.Ejecuta tu aplicación y especifica
-Dlog4j.configurationFile=<CONFIG_FILE_PATH>. Puedes especificarCONFIG_FILE_PATH=googleads-logging/log4j2.xmlpara usar el archivo de configuración predeterminado incluido en la biblioteca cliente.
Log4j 1.2 (heredado)
Agrega una dependencia en la biblioteca
slf4j-log4j12y reemplaza1.x.ypor la versión de Log4j 1.2 que usas en tu proyecto:<dependency> <groupId>org.slf4j</groupId> <artifactId>slf4j-log4j12</artifactId> <version>1.x.y</version> </dependency>(Opcional) Crea un archivo de configuración en el directorio de recursos de tu proyecto, por ejemplo,
src/main/resourcesen Maven. Log4j 1.2 carga su archivo de configuración desde la ruta de clase, no desde el directorio de trabajo, por lo que debes asegurarte de copiarlo en un directorio de recursos.Ejecuta tu aplicación y especifica
-Dlog4j.configuration=<CONFIG_FILE_PATH>. Puedes especificarCONFIG_FILE_PATH=googleads-logging/log4j.propertiespara usar el archivo de configuración predeterminado incluido en la biblioteca cliente.
Java Util Logging
Agrega una dependencia en la biblioteca
slf4j-jdk14y reemplaza2.x.ypor la versión de SLF4J que se usa en tu proyecto:<dependency> <groupId>org.slf4j</groupId> <artifactId>slf4j-jdk14</artifactId> <version>2.x.y</version> </dependency>Crea un archivo de configuración de JUL en el sistema de archivos en una ruta de acceso legible desde tu aplicación (por ejemplo,
./jdk-logger.properties). Se proporciona una plantilla engoogle-ads/src/main/resources/googleads-logging/jdk-logger.properties. JUL solo lee desde el sistema de archivos, por lo que no debes copiarlo solo en el directorio de recursos de classpath.Ejecuta tu aplicación y especifica
-Djava.util.logging.config.file=./jdk-logger.properties.