Logging

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

Layout e funcionalidade de 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

Truncagem de registros detalhados

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 -Dapi.googleads.maxLogMessageLength=<number>. Definir -1 desativa o truncamento de registros.

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 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 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 dos projetos. 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.

Java Util Logging

  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 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.