記錄

記錄功能會透過 SLF4J 進行設定,這是 Java 適用的一般記錄程式庫,可將記錄檔導向許多不同的記錄實作。我們提供 log4j 1.2/2 和 Java 實用工具記錄 (JUL) 的設定檔。

記錄版面配置和功能

要求會記錄為一行摘要,並附上完整的要求/回應主體和標頭。

記錄檔類型 記錄檔名稱 成功等級 失敗等級
摘要 com.google.ads.googleads.lib.request.summary 資訊 警告
詳細資料 com.google.ads.googleads.lib.request.detail 偵錯 資訊

詳細記錄截斷

系統會預設截斷詳細記錄,以免產生過大的記錄。如要變更記錄檔截斷的長度,請設定 -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。JUL 只會讀取檔案系統,因此請勿複製至資源目錄。

  3. 執行指定 -Djava.util.logging.config.file=./jdk-logger.properties 的應用程式。