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 que os registros sejam direcionados a muitas implementações diferentes, como Log4j 2, Logback ou java.util.logging (JUL). Fornecemos arquivos de configuração de amostra para Log4j 2 e JUL.

Layout e funcionalidade do 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: as 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 registro de detalhes

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

Log4j 2

1. Adicione uma dependência na biblioteca log4j-slf4j2-impl, substituindo 2.x.y pela versão do Log4j 2 que você está usando no seu 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 na 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 Java Util

1. Adicione uma dependência na 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 do 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.