Logging 使用 SLF4J 进行配置,这是一种 Java 的通用日志记录库,可将日志定向到许多不同的日志记录实现。我们为 log4j 1.2/2 和 Java 实用程序日志记录 (JUL) 提供了配置文件。
日志记录的布局和功能
记录的请求中包含一行摘要以及完整的请求/响应正文和标头。
日志类型 | 日志名称 | 成功级别 | 故障级别 |
---|---|---|---|
摘要 | com.google.ads.googleads.lib.request.summary | 信息 | WARN |
详细信息 | com.google.ads.googleads.lib.request.detail | DEBUG | 信息 |
详细信息日志截断
默认情况下,系统会截断详细日志,以避免创建大型日志。如需更改日志被截断的长度,请设置 -Dapi.googleads.maxLogMessageLength=<number>
。设置 -1
会停用日志截断。
Log4j 2
添加
log4j-slf4j-impl
库的依赖项,将2.x.y
替换为您在项目中使用的 Log4j 2 版本。<dependency> <groupId>org.apache.logging.log4j</groupId> <artifactId>log4j-slf4j-impl</artifactId> <version>2.x.y</version> </dependency>
(可选)在资源目录中创建配置文件(例如,在 Maven 中):
src/main/resources
。Log4j 2 从类路径(而不是工作目录)加载其配置文件,因此请确保在资源目录中创建。运行您的应用,指定
-Dlog4j.configurationFile=<CONFIG_FILE_PATH>
。您可以指定CONFIG_FILE_PATH=googleads-logging/log4j2.xml
以使用客户端库附带的默认配置文件。
Log4j 1.2(旧版)
添加
slf4j-log4j12
库的依赖项,将1.x.y
替换为您在项目中使用的 Log4j 1.2 版本。<dependency> <groupId>org.slf4j</groupId> <artifactId>slf4j-log4j12</artifactId> <version>1.x.y</version> </dependency>
(可选)在项目资源目录中创建配置文件,例如,在 Maven 中,路径为
src/main/resources
。Log4j 1.2 从类路径(而不是工作目录)加载其配置文件,因此请务必复制到资源目录。运行您的应用,指定
-Dlog4j.configuration=<CONFIG_FILE_PATH>
。您可以指定CONFIG_FILE_PATH=googleads-logging/log4j.properties
以使用客户端库附带的默认配置文件。
Java 实用程序日志记录
添加对
slf4j-jdk14
库的依赖项。<dependency> <groupId>org.slf4j</groupId> <artifactId>slf4j-jdk14</artifactId> <version>1.7.25</version> </dependency>
在文件系统上可从应用读取的路径(例如
./jdk-logger.properties
)中创建一个 JUL 配置文件。google-ads/src/main/resources/googleads-logging/jdk-logger.properties
中提供了模板。JUL 仅从文件系统中读取数据,因此请勿复制到资源目录。指定
-Djava.util.logging.config.file=./jdk-logger.properties
运行您的应用。