日志记录

Logging 通过 SLF4J 进行配置，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

  1. 添加对 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>

  2. （可选）在资源目录中创建一个配置文件， 例如，在 Maven 中：src/main/resources。Log4j 2 加载其配置 文件，因此请确保在 资源目录中。

  3. 运行您的应用，指定 -Dlog4j.configurationFile=<CONFIG_FILE_PATH>。您可以指定 CONFIG_FILE_PATH=googleads-logging/log4j2.xml，使用默认值 配置文件。

Log4j 1.2（旧版）

  1. 添加对 slf4j-log4j12 库的依赖项，将 1.x.y 替换为 您在项目中使用的 Log4j 1.2 版本。

    <dependency>
  <groupId>org.slf4j</groupId>
  <artifactId>slf4j-log4j12</artifactId>
  <version>1.x.y</version>
</dependency>

  2. （可选）在项目资源目录中创建配置文件， 例如，在 Maven 中，路径为 src/main/resources。Log4j 1.2 配置文件，因此请确保 您需要复制到一个资源目录中。

  3. 运行您的应用，指定 -Dlog4j.configuration=<CONFIG_FILE_PATH>。 您可以指定要使用的 CONFIG_FILE_PATH=googleads-logging/log4j.properties 客户端库附带的默认配置文件。

Java 实用程序日志记录

  1. 添加对 slf4j-jdk14 库的依赖项。

    <dependency>
  <groupId>org.slf4j</groupId>
  <artifactId>slf4j-jdk14</artifactId>
  <version>1.7.25</version>
</dependency>

  2. 在文件系统上创建 JUL 配置文件，路径从 您的应用（例如 ./jdk-logger.properties）。模板是 提供 google-ads/src/main/resources/googleads-logging/jdk-logger.properties。7 月 仅从文件系统读取，因此不要复制到资源目录。

  3. 运行您的应用，指定 -Djava.util.logging.config.file=./jdk-logger.properties。