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
會停用記錄檔截斷功能。
記錄 4j - 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
的應用程式。