O Logging é configurado com o SLF4J, uma biblioteca genérica de geração de registros para Java, que permite que os registros sejam direcionados para muitas implementações de geração de registros diferentes. Fornecemos arquivos de configuração para log4j 1.2/2 e Java Util Logging (JUL).
Layout e funcionalidade de geração de registros
As solicitações são registradas com um resumo de uma linha, além dos cabeçalhos e corpo completo 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 |
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 tamanho 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
, substituindo2.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 Log4j 2 carrega o arquivo de configuração do caminho de classe, não do diretório de trabalho. Portanto, não deixe de criar em um diretório de recursos.Execute o aplicativo especificando
-Dlog4j.configurationFile=<CONFIG_FILE_PATH>
. É possível especificarCONFIG_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
, substituindo1.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 projeto. Por exemplo, no Maven, o caminho é
src/main/resources
. O Log4j 1.2 carrega o arquivo de configuração a partir 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 especificarCONFIG_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
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 pelo seu aplicativo (por exemplo,
./jdk-logger.properties
). Um modelo é fornecido emgoogle-ads/src/main/resources/googleads-logging/jdk-logger.properties
. O JUL lê apenas o sistema de arquivos. Portanto, não o copie para o diretório de recursos.Execute o aplicativo especificando
-Djava.util.logging.config.file=./jdk-logger.properties
.