Configura el registro

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

  1. Agrega una dependencia en la biblioteca log4j-slf4j2-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-slf4j2-impl</artifactId>
      <version>2.x.y</version>
    </dependency>
    
  2. (Opcional) Crea un archivo de configuración log4j2.xml en tu directorio de recursos (por ejemplo, src/main/resources en 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.

  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 en la biblioteca 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, src/main/resources en 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.

  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 en la biblioteca cliente.

Java Util Logging

  1. Agrega una dependencia en la biblioteca slf4j-jdk14 y reemplaza 2.x.y por 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>
    
  2. 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 en google-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.

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