Hoạt động ghi nhật ký trong thư viện ứng dụng Java được định cấu hình bằng SLF4J, một lớp trừu tượng ghi nhật ký chung cho Java, cho phép chuyển nhật ký đến nhiều cách triển khai ghi nhật ký khác nhau, chẳng hạn như Log4j 2, Logback hoặc java.util.logging (JUL). Chúng tôi cung cấp các tệp cấu hình mẫu cho Log4j 2 và JUL.
Bố cục và chức năng của nhật ký
Các yêu cầu được ghi nhật ký bằng một dòng tóm tắt, cũng như toàn bộ nội dung và tiêu đề của yêu cầu và phản hồi.
| Loại nhật ký | Tên nhật ký | Mức độ thành công | Mức độ lỗi |
|---|---|---|---|
| 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) |
Việc cắt bớt nhật ký chi tiết
Nhật ký chi tiết sẽ bị cắt bớt theo mặc định để tránh tạo 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 thuộc tính JVM -Dapi.googleads.maxLogMessageLength=<number>. Việc đặt -1 sẽ tắt tính năng cắt bớt nhật ký.
Log4j 2
Thêm một phần phụ thuộc vào thư viện
log4j-slf4j2-impl, thay thế2.x.ybằng phiên bản Log4j 2 mà bạn đang dùng trong dự án:<dependency> <groupId>org.apache.logging.log4j</groupId> <artifactId>log4j-slf4j2-impl</artifactId> <version>2.x.y</version> </dependency>(Không bắt buộc) Tạo một tệp cấu hình
log4j2.xmltrong thư mục tài nguyên (ví dụ:src/main/resourcestrong Maven). Log4j 2 tải tệp cấu hình từ đường dẫn lớp chứ không phải thư mục đang hoạt động, vì vậy, hãy đảm bảo bạn tạo tệp này trong thư mục tài nguyên.Chạy ứng dụng của bạn, 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 một phần phụ thuộc vào thư viện
slf4j-log4j12, thay thế1.x.ybằng phiên bản Log4j 1.2 mà bạn đang 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 một tệp cấu hình trong thư mục tài nguyên của dự án, ví dụ:
src/main/resourcestrong Maven. Log4j 1.2 tải tệp cấu hình từ đường dẫn lớp chứ không phải thư mục đang hoạt động, vì vậy, hãy đảm bảo bạn sao chép tệp này vào một thư mục tài nguyên.Chạy ứng dụng của bạn, 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.
Java Util Logging
Thêm một phần phụ thuộc vào thư viện
slf4j-jdk14, thay thế2.x.ybằng phiên bản SLF4J được dùng trong dự án của bạn:<dependency> <groupId>org.slf4j</groupId> <artifactId>slf4j-jdk14</artifactId> <version>2.x.y</version> </dependency>Tạo một 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 (ví dụ:
./jdk-logger.properties). Một mẫu được cung cấp tạigoogle-ads/src/main/resources/googleads-logging/jdk-logger.properties. JUL chỉ đọc từ hệ thống tệp, vì vậy, đừng chỉ sao chép JUL vào thư mục tài nguyên classpath.Chạy ứng dụng của bạn bằng cách chỉ định
-Djava.util.logging.config.file=./jdk-logger.properties.