記錄

Logging 設有 SLF4J 的 Java 通用記錄程式庫， 允許將記錄檔導向至許多不同的記錄實作。我們提供 log4j 1.2/2 和 Java Util Logging (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/resourcesLog4j 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。