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
Agrega una dependencia en la biblioteca
log4j-slf4j-impl
y sustituye2.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>
(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.Ejecuta tu aplicación y especifica
-Dlog4j.configurationFile=<CONFIG_FILE_PATH>
Puedes especificarCONFIG_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)
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 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.Ejecuta tu 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 incluido en las bibliotecas cliente.
Java Util Logging
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 legible desde tu aplicación (por ejemplo,
./jdk-logger.properties
). Una plantilla es proporcionado engoogle-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.Ejecuta tu aplicación especificando
-Djava.util.logging.config.file=./jdk-logger.properties