Định cấu hình ghi nhật ký

Tính nă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 mặt nạ 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)

Cắt bớt nhật ký chi tiết

Theo mặc định, nhật ký chi tiết sẽ bị cắt bớt để tránh tạo nhật ký 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

  1. Thêm phần phụ thuộc vào thư viện log4j-slf4j2-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-slf4j2-impl</artifactId>
      <version>2.x.y</version>
    </dependency>
    
  2. (Không bắt buộc) Tạo tệp cấu hình log4j2.xml trong thư mục tài nguyên (ví dụ: src/main/resources trong Maven). Log4j 2 tải tệp cấu hình từ classpath chứ không phải thư mục làm việc, vì vậy, hãy đảm bảo bạn tạo tệp này trong thư mục tài nguyên.

  3. Chạy ứng dụng của bạn, chỉ định -Dlog4j.configurationFile=<CONFIG_FILE_PATH>. Bạn có thể chỉ định CONFIG_FILE_PATH=googleads-logging/log4j2.xml để sử dụng tệp cấu hình mặc định đi kèm với thư viện ứng dụng.

Log4j 1.2 (phiên bản cũ)

  1. 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>
    
  2. (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ụ: src/main/resources trong Maven. Log4j 1.2 tải tệp cấu hình từ classpath chứ không phải thư mục làm việc, vì vậy, hãy đảm bảo bạn sao chép tệp này vào thư mục tài nguyên.

  3. Chạy ứng dụng của bạn, chỉ định -Dlog4j.configuration=<CONFIG_FILE_PATH>. Bạn có thể chỉ định CONFIG_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

  1. Thêm phần phụ thuộc vào thư viện slf4j-jdk14, thay thế 2.x.y bằng phiên bản SLF4J được dùng trong dự án:

    <dependency>
      <groupId>org.slf4j</groupId>
      <artifactId>slf4j-jdk14</artifactId>
      <version>2.x.y</version>
    </dependency>
    
  2. Tạo tệp cấu hình JUL trên hệ thống tệp theo đường dẫn có thể đọc được từ ứng dụng của bạn (ví dụ: ./jdk-logger.properties). Bạn có thể tìm thấy mẫu tại google-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 tệp này vào thư mục tài nguyên đường dẫn lớp.

  3. Chạy ứng dụng của bạn, chỉ định -Djava.util.logging.config.file=./jdk-logger.properties.