Tính năng ghi nhật ký được định cấu hình bằng SLF4J một thư viện ghi nhật ký chung cho Java, cho phép chuyển hướng nhật ký đến nhiều cách triển khai nhật ký. Chúng tôi cung cấp các tệp cấu hình cho log4j 1.2/2 và Ghi nhật ký tiện ích Java (JUL).
Bố cục và chức năng ghi nhật ký
Các yêu cầu được ghi lại bằng bản tóm tắt một dòng, cũng như toàn bộ nội dung và tiêu đề của yêu cầu/phản hồi.
Loại nhật ký | Tên nhật ký | Mức độ thành công | Mức độ không thành công |
---|---|---|---|
TÓM TẮT | com.google.ads.googleads.lib.request.summary | INFO (THÔNG TIN) | WARN (CẢNH BÁO) |
CHI TIẾT | com.google.ads.googleads.lib.request.detail | DEBUG (Gỡ lỗi) | INFO (THÔNG TIN) |
Rút ngắn nhật ký chi tiết
Theo mặc định, nhật ký chi tiết được cắt bớt để tránh tạo các nhật ký có kích thước lớn. Để thay đổi độ dài mà nhật ký bị cắt bớt, hãy đặt -Dapi.googleads.maxLogMessageLength=<number>
. Việc đặt -1
sẽ tắt tính năng cắt nhật ký.
Log4j 2
Thêm phần phụ thuộc vào thư viện
log4j-slf4j-impl
, thay thế2.x.y
bằng phiên bản Log4j 2 mà bạn đang sử dụng trong dự án.<dependency> <groupId>org.apache.logging.log4j</groupId> <artifactId>log4j-slf4j-impl</artifactId> <version>2.x.y</version> </dependency>
(Không bắt buộc) Tạo tệp cấu hình trong thư mục tài nguyên, ví dụ: trong Maven:
src/main/resources
. Log4j 2 tải tệp cấu hình từ classpath, chứ không phải thư mục đang hoạt động. Vì vậy, hãy đảm bảo bạn tạo trong một thư mục tài nguyên.Chạy ứng dụng, chỉ định
-Dlog4j.configurationFile=<CONFIG_FILE_PATH>
. Bạn có thể chỉ địnhCONFIG_FILE_PATH=googleads-logging/log4j2.xml
để sử dụng tệp cấu hình mặc định có trong thư viện ứng dụng.
Log4j 1.2 (cũ)
Thêm phần phụ thuộc vào thư viện
slf4j-log4j12
, thay thế1.x.y
bằng phiên bản Log4j 1.2 mà bạn đang sử dụng trong dự án.<dependency> <groupId>org.slf4j</groupId> <artifactId>slf4j-log4j12</artifactId> <version>1.x.y</version> </dependency>
(Không bắt buộc) Tạo tệp cấu hình trong thư mục tài nguyên của dự án. Ví dụ: trong Maven, đường dẫn là
src/main/resources
. Log4j 1.2 tải tệp cấu hình từ classpath, chứ không phải thư mục đang hoạt động. Vì vậy, hãy nhớ sao chép vào một thư mục tài nguyên.Chạy ứng dụng, chỉ định
-Dlog4j.configuration=<CONFIG_FILE_PATH>
. Bạn có thể chỉ địnhCONFIG_FILE_PATH=googleads-logging/log4j.properties
để sử dụng tệp cấu hình mặc định đi kèm với thư viện ứng dụng.
Ghi nhật ký tiện ích Java
Thêm phần phụ thuộc vào thư viện
slf4j-jdk14
.<dependency> <groupId>org.slf4j</groupId> <artifactId>slf4j-jdk14</artifactId> <version>1.7.25</version> </dependency>
Tạo tệp cấu hình JUL trên hệ thống tệp theo một đường dẫn có thể đọc được từ ứng dụng của bạn (chẳng hạn như
./jdk-logger.properties
). Một mẫu được cung cấp tạigoogle-ads/src/main/resources/googleads-logging/jdk-logger.properties
. THÁNG 7 chỉ đọc được từ hệ thống tệp, vì vậy, bạn không nên sao chép vào thư mục tài nguyên.Chạy ứng dụng chỉ định
-Djava.util.logging.config.file=./jdk-logger.properties
.