Logging

O Logging é configurado com o SLF4J, uma biblioteca de geração de registros genérica para Java, permite que os registros sejam direcionados para muitas implementações de registro diferentes. Oferecemos 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 completo da solicitação/resposta e 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

Importante: solicitações de modificação em que parcialmente falha for verdadeira não fará com que toda falha. Assim, os registros de falha parcial são sempre registrados como "Sucesso". e não no nível de falha, como é esperado.

Truncamento do registro de detalhes

Os registros detalhados são truncados por padrão para evitar a criação de registros grandes. Para alterar o tamanho do truncamento dos registros, definir -Dapi.googleads.maxLogMessageLength=<number>: Definir -1 desativa truncamento de log.

Log4j2

1. Adicione uma dependência à biblioteca log4j-slf4j-impl, substituindo 2.x.y pela versão do Log4j2 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 para exemplo, no Maven: src/main/resources. O Log4j 2 carrega a própria configuração do caminho de classe, e não do diretório de trabalho. Por isso, crie em um de recursos do Terraform.

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

Log4j 1.2 (legado)

1. Adicione uma dependência à biblioteca slf4j-log4j12, substituindo 1.x.y por a 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, no Maven, o caminho é src/main/resources. O Log4j 1.2 carrega de configuração do Terraform do caminho de classe, não do diretório de trabalho. Portanto, que você copia 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 de utilitários do Java

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 JUL no sistema de arquivos em um caminho legível de seu aplicativo (por exemplo, ./jdk-logger.properties). Um modelo é fornecidas em google-ads/src/main/resources/googleads-logging/jdk-logger.properties. JUL lê somente do sistema de arquivos. Portanto, não copie para o diretório de recursos.

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