Ghi nhật ký

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 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à 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 phần tóm tắt một dòng và toàn bộ nội dung yêu cầu/phản hồi và tiêu đề.

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. Người nhận thay đổi độ dài mà nhật ký bị cắt bớt, đặt -Dapi.googleads.maxLogMessageLength=<number>. Thao tác đặt -1 sẽ tắt 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 của mình.

    <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 của bạn, cho chẳng hạn như trong Maven: src/main/resources. Log4j 2 tải 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 trong một 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 giá trị mặc định tệp cấu hình đi kèm với thư viện ứng dụng.

Log4j 1.2 (cũ)

  1. Thêm phần phụ thuộc trên 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 của mình.

    <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 dự án của bạn, ví dụ: trong Maven, đường dẫn là src/main/resources. Log4j 1.2 tải nó 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 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 đ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.

    <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 theo một đường dẫn có thể đọc được ứng dụng của bạn (ví dụ: ./jdk-logger.properties). Mẫu là được cung cấp tại google-ads/src/main/resources/googleads-logging/jdk-logger.properties THÁNG 7 chỉ có thể đọc từ hệ thống tệp, do đó khô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.