Registro

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 registro

Las solicitudes se registran con un resumen de una línea y el cuerpo y los encabezados completos de la solicitud o 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

Punto clave: Las solicitudes de mutación en las que Partial failure es verdadero no harán que falle toda la solicitud. Por lo tanto, los registros de fallas parciales siempre se registran en el nivel de éxito, no en el nivel de fallas, como se podría esperar.

Recorte de registros de detalles

Los registros detallados se truncan de forma predeterminada para evitar crear registros grandes. Para cambiar la longitud en la que se truncan los registros, configura -Dapi.googleads.maxLogMessageLength=<number>. Configurar -1 inhabilita la truncación de registros.

Log4j 2

1. Agrega una dependencia en la biblioteca log4j-slf4j-impl y reemplaza 2.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>
   

2. (Opcional) Crea un archivo de configuración en el directorio de recursos, por ejemplo, en Maven: src/main/resources. Log4j 2 carga su archivo de configuración desde la ruta de acceso a clases, no desde el directorio de trabajo, así que asegúrate de crearlo en un directorio de recursos.

3. Ejecuta tu aplicación y especifica -Dlog4j.configurationFile=<CONFIG_FILE_PATH>. Puedes especificar CONFIG_FILE_PATH=googleads-logging/log4j2.xml para usar el archivo de configuración predeterminado incluido con las bibliotecas cliente.

Log4j 1.2 (heredado)

1. Agrega una dependencia en la biblioteca slf4j-log4j12 y reemplaza 1.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>
   

2. (Opcional) Crea un archivo de configuración en el directorio de recursos de tu proyecto. 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, así que asegúrate de copiarlo en un directorio de recursos.

3. Ejecuta tu aplicación y especifica -Dlog4j.configuration=<CONFIG_FILE_PATH>. Puedes especificar CONFIG_FILE_PATH=googleads-logging/log4j.properties para usar el archivo de configuración predeterminado incluido con las bibliotecas cliente.

Java Util Logging

1. Agrega una dependencia en la biblioteca slf4j-jdk14.

   <dependency>
     <groupId>org.slf4j</groupId>
     <artifactId>slf4j-jdk14</artifactId>
     <version>1.7.25</version>
   </dependency>
   

2. Crea un archivo de configuración de JUL en el sistema de archivos en una ruta de acceso que se pueda leer desde tu aplicación (por ejemplo, ./jdk-logger.properties). Se proporciona una plantilla en google-ads/src/main/resources/googleads-logging/jdk-logger.properties. JUL solo lee del sistema de archivos, por lo que no debes copiarlo en el directorio de recursos.

3. Ejecuta tu aplicación especificando -Djava.util.logging.config.file=./jdk-logger.properties.