Ghi nhật ký

Tính năng ghi nhật ký được định cấu hình với SLF4J một thư viện ghi nhật ký chung cho Java, cho phép chuyển hướng các nhật ký đến nhiều phương thức triển khai ghi nhật ký. Chúng tôi cung cấp các tệp cấu hình cho log4j 1.2/2 và tính năng Ghi nhật ký tiện ích Java (JUL).

Chức năng và bố cục ghi nhật ký

Các yêu cầu được ghi lại bằng bản tóm tắt 1 dòng, nội dung và tiêu đề đầy đủ 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 độ 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, các nhật ký chi tiết sẽ bị cắt bớt để tránh tạo nhật ký có kích thước lớn. Để thay đổi độ dài của 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 bớt nhật ký.

Log4j 2

  1. 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>
    
  2. (Không bắt buộc) Tạo tệp cấu hình trong thư mục tài nguyên, chẳng hạn như 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 nhớ tạo trong thư mục tài nguyên.

  3. Chạy ứng dụng, 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 có trong thư viện ứng dụng.

Log4j 1.2 (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ụ: 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 thư mục tài nguyên.

  3. Chạy ứng dụng, 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 có trong 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.

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

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