Configurar a geração de registros

A geração de registros na biblioteca de cliente Java é configurada com o SLF4J, uma fachada de geração de registros genérica para Java que permite direcionar registros para várias implementações de geração de registros diferentes, como Log4j 2, Logback ou java.util.logging (JUL). Fornecemos arquivos de configuração de exemplo para Log4j 2 e JUL.

Layout e funcionalidade de registro

As solicitações são registradas com um resumo de uma linha e o corpo e os cabeçalhos completos da solicitação e da resposta.

Tipo de registro	Nome do registro	Nível de sucesso	Nível de falha
RESUMO	com.google.ads.googleads.lib.request.summary	INFO	WARN
DETALHE	com.google.ads.googleads.lib.request.detail	DEBUG	INFO

Importante: solicitações de mutação em que a falha parcial é true não causam a falha de toda a solicitação. Assim, os registros de falha parcial são sempre registrados no nível de sucesso, não no nível de falha.

Truncamento de registros detalhados

Os registros detalhados são truncados por padrão para evitar a criação de registros grandes. Para mudar o tamanho em que os registros são truncados, defina a propriedade da JVM -Dapi.googleads.maxLogMessageLength=<number>. Definir -1 desativa o truncamento de registros.

Log4j2

1. Adicione uma dependência à biblioteca log4j-slf4j2-impl, substituindo 2.x.y pela versão do Log4j 2 que você está usando no projeto:

   <dependency>
     <groupId>org.apache.logging.log4j</groupId>
     <artifactId>log4j-slf4j2-impl</artifactId>
     <version>2.x.y</version>
   </dependency>
   

2. (Opcional) Crie um arquivo de configuração log4j2.xml no diretório de recursos (por exemplo, src/main/resources no Maven). O Log4j 2 carrega o arquivo de configuração do classpath, não do diretório de trabalho. Portanto, crie-o em um diretório de recursos.

3. Execute o aplicativo, especificando -Dlog4j.configurationFile=<CONFIG_FILE_PATH>. É possível especificar CONFIG_FILE_PATH=googleads-logging/log4j2.xml para usar o arquivo de configuração padrão incluído na biblioteca de cliente.

Log4j 1.2 (legado)

1. Adicione uma dependência à biblioteca slf4j-log4j12, substituindo 1.x.y pela versão do Log4j 1.2 que você está usando no seu projeto:

   <dependency>
     <groupId>org.slf4j</groupId>
     <artifactId>slf4j-log4j12</artifactId>
     <version>1.x.y</version>
   </dependency>
   

2. (Opcional) Crie um arquivo de configuração no diretório de recursos do projeto, por exemplo, src/main/resources no Maven. O Log4j 1.2 carrega o arquivo de configuração do classpath, não do diretório de trabalho. Portanto, copie-o para um diretório de recursos.

3. Execute o aplicativo, especificando -Dlog4j.configuration=<CONFIG_FILE_PATH>. É possível especificar CONFIG_FILE_PATH=googleads-logging/log4j.properties para usar o arquivo de configuração padrão incluído na biblioteca de cliente.

Geração de registros do Java Util

1. Adicione uma dependência à biblioteca slf4j-jdk14, substituindo 2.x.y pela versão do SLF4J usada no seu projeto:

   <dependency>
     <groupId>org.slf4j</groupId>
     <artifactId>slf4j-jdk14</artifactId>
     <version>2.x.y</version>
   </dependency>
   

2. Crie um arquivo de configuração do JUL no sistema de arquivos em um caminho legível pelo aplicativo (por exemplo, ./jdk-logger.properties). Um modelo é fornecido em google-ads/src/main/resources/googleads-logging/jdk-logger.properties. O JUL lê apenas do sistema de arquivos. Portanto, não copie apenas para o diretório de recursos do classpath.

3. Execute o aplicativo especificando -Djava.util.logging.config.file=./jdk-logger.properties.