El registro se configura con SLF4J, una biblioteca de registro genérica para Java, que permite que los registros se dirijan a muchas implementaciones de registro diferentes. Proporcionamos archivos de configuración para log4j 1.2/2 y Java Util Logging (JUL).
Diseño y funcionalidad de Logging
Las solicitudes se registran con un resumen de una línea y el cuerpo y los encabezados completos de la solicitud/respuesta.
Tipo de registro | Nombre del registro | Nivel de éxito | Nivel de falla |
---|---|---|---|
RESUMEN | com.google.ads.googleads.lib.request.summary | INFO | WARN |
DETALLE | com.google.ads.googleads.lib.request.detail | DEBUG | INFO |
Truncamiento del registro detallado
Los registros detallados se truncan de forma predeterminada para evitar crear registros grandes. Para cambiar la longitud con la que se truncan los registros, configura -Dapi.googleads.maxLogMessageLength=<number>
. Si configuras -1
, se inhabilita el truncamiento de registros.
Log4j 2
Agrega una dependencia en la biblioteca
log4j-slf4j-impl
y reemplaza2.x.y
por la versión de Log4j 2 que usas en tu proyecto.<dependency> <groupId>org.apache.logging.log4j</groupId> <artifactId>log4j-slf4j-impl</artifactId> <version>2.x.y</version> </dependency>
Crea un archivo de configuración en el directorio de recursos, por ejemplo, en Maven:
src/main/resources
(opcional). 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 la aplicación y especifica
-Dlog4j.configurationFile=<CONFIG_FILE_PATH>
. Puedes especificarCONFIG_FILE_PATH=googleads-logging/log4j2.xml
para usar el archivo de configuración predeterminado que se incluye con las bibliotecas cliente.
Log4j 1.2 (heredado)
Agrega una dependencia en la biblioteca
slf4j-log4j12
y sustituye1.x.y
por 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>
Crea un archivo de configuración en el directorio de recursos de tu proyecto (opcional), por ejemplo, en Maven, la ruta de acceso es
src/main/resources
. 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 la aplicación y especifica
-Dlog4j.configuration=<CONFIG_FILE_PATH>
. Puedes especificarCONFIG_FILE_PATH=googleads-logging/log4j.properties
para usar el archivo de configuración predeterminado que se incluye con las bibliotecas cliente.
Registro de utilidades de Java
Agrega una dependencia en la biblioteca
slf4j-jdk14
.<dependency> <groupId>org.slf4j</groupId> <artifactId>slf4j-jdk14</artifactId> <version>1.7.25</version> </dependency>
Crea un archivo de configuración 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 lee solo desde el sistema de archivos, así que no lo copies en el directorio de recursos.Ejecuta la aplicación y especifica
-Djava.util.logging.config.file=./jdk-logger.properties
.