Logging

A geração de registros é configurada com o SLF4J, uma biblioteca de geração de registros genérica para Java, que permite que os registros sejam direcionados a várias implementações de geração de registros diferentes. Fornecemos arquivos de configuração para log4j 1.2/2 e Java Util Logging (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/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: a mutação de solicitações em que Partial failure é verdadeiro não faz com que a solicitação inteira falhe. Portanto, os registros de falha parcial são sempre registrados no nível de sucesso, não no nível de falha, como seria de se esperar.

Trunca o 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 -Dapi.googleads.maxLogMessageLength=<number>. A configuração -1 desativa a truncagem de registro.

Log4j2

1. Adicione uma dependência à biblioteca log4j-slf4j-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-slf4j-impl</artifactId>
     <version>2.x.y</version>
   </dependency>
   

2. (Opcional) Crie um arquivo de configuração no diretório de recursos, por exemplo, no Maven: src/main/resources. O Log4j 2 carrega o arquivo de configuração do classpath, não do diretório de trabalho. Portanto, crie 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 nas bibliotecas 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 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, no Maven, o caminho é src/main/resources. O Log4j 1.2 carrega o arquivo de configuração do classpath, não do diretório de trabalho. Portanto, copie 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 nas bibliotecas de cliente.

Geração de registros Java Util

1. Adicione uma dependência à biblioteca slf4j-jdk14.

   <dependency>
     <groupId>org.slf4j</groupId>
     <artifactId>slf4j-jdk14</artifactId>
     <version>1.7.25</version>
   </dependency>
   

2. Crie um arquivo de configuração do JUL no sistema de arquivos em um caminho legível pelo seu 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 para o diretório de recursos.

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