Registro

Logging se configura con SLF4J, una biblioteca de registro genérica para Java, y permite que los registros se dirijan a muchas implementaciones de registro diferentes. Ofrecemos de configuración para log4j 1.2/2 y Java Util Logging (JUL).

Diseño y funcionalidad de los registros

Las solicitudes se registran con un resumen de una línea y el cuerpo completo de la solicitud/respuesta. y encabezados.

Tipo de registro Nombre del registro Nivel de éxito Nivel de fallas
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

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

Log4j 2

  1. Agrega una dependencia en la biblioteca log4j-slf4j-impl y sustituye 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. ejemplo, en Maven: src/main/resources. Log4j 2 carga su configuración de la ruta de clase, no del directorio de trabajo, así que asegúrate de crear de Google Cloud.

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

Log4j 1.2 (heredado)

  1. Agrega una dependencia en la biblioteca slf4j-log4j12 y sustituye 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. Crea un archivo de configuración en el directorio de recursos de tu proyecto (opcional). Por ejemplo, en Maven, la ruta es src/main/resources. Log4j 1.2 carga su de Terraform desde la ruta de clase, no desde el directorio de trabajo, así que copias a 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 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 JUL en el sistema de archivos en una ruta legible desde tu aplicación (por ejemplo, ./jdk-logger.properties). Una plantilla es proporcionado en google-ads/src/main/resources/googleads-logging/jdk-logger.properties JUL. solo lee del sistema de archivos, así que no lo copies en el directorio de recursos.

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