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 para muitas implementações de geração de registros 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 partial failure é true não fazem com que toda a solicitação falhe. 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 detalhado

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>. A configuração -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 caminho de classe, 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 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 caminho de classe, 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.

Java Util Logging

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

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

2. Crie um arquivo de configuração 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 o copie apenas para o diretório de recursos do caminho de classe.

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