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

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: