Esta página foi traduzida pela API Cloud Translation.

Logging

O Logging é configurado com a SLF4J, uma biblioteca de geração de registros genérica para Java, o que permite que os registros sejam direcionados para várias implementações de geração de registros diferentes. Fornecemos arquivos de configuração para o log4j 1.2/2 e o Java Util Logging (JUL).

Layout e funcionalidade da geração de registros

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

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

Truncamento do 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>. Definir -1 desativa o truncamento de registro.

Log4j2

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>

(Opcional) Crie um arquivo de configuração no diretório de recursos, por exemplo, no Maven: src/main/resources. O Log4j2 carrega o arquivo de configuração no caminho de classe, e não no diretório de trabalho. Portanto, crie um diretório de recursos.
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)

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>
```
(Opcional) Crie um arquivo de configuração no diretório de recursos do seu projeto. Por exemplo, no Maven, o caminho é src/main/resources. O Log4j 1.2 carrega o arquivo de configuração do caminho de classe, não do diretório de trabalho. Portanto, copie para um diretório de recursos.
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 do utilitário Java

Adicione uma dependência à biblioteca slf4j-jdk14.

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

Crie um arquivo de configuração JUL no sistema de arquivos em um caminho legível no seu aplicativo (por exemplo, ./jdk-logger.properties). Um modelo é fornecido em google-ads/src/main/resources/googleads-logging/jdk-logger.properties. O JUL só lê pelo sistema de arquivos. Por isso, não o copie para o diretório de recursos.
Execute o aplicativo especificando -Djava.util.logging.config.file=./jdk-logger.properties.