Ghi nhật ký

Bạn có thể ghi lại các yêu cầu, phản hồi và thông báo tóm tắt được gửi đến Google Ads API bằng trình ghi nhật ký tuỳ chỉnh của riêng bạn hoặc trình ghi nhật ký mặc định trong thư viện ứng dụng cho Perl.

Cấp độ nhật ký

Thư viện sẽ ghi nhiều loại sự kiện vào nhiều cấp độ nhật ký. Khi phản hồi API thành công, bản tóm tắt sẽ được ghi vào nhật ký tại INFO và toàn bộ yêu cầu cũng như phản hồi sẽ được ghi vào nhật ký tại DEBUG. Đối với yêu cầu dẫn đến lỗi API, thông báo tóm tắt sẽ được ghi vào nhật ký tại WARN và yêu cầu cũng như phản hồi đầy đủ sẽ được ghi vào nhật ký tại INFO.

Loại nhật ký Tên nhật ký Cấp độ thành công Cấp độ lỗi
TÓM TẮT Google.Ads.GoogleAds.Summary INFO (THÔNG TIN) WARN (CẢNH BÁO)
CHI TIẾT Google.Ads.GoogleAds.Detail DEBUG (Gỡ lỗi) INFO (THÔNG TIN)

Đối với các lỗi một phần, thông tin chi tiết về lỗi một phần sẽ được ghi vào nhật ký tại DEBUG.

Cấu hình

Thư viện ứng dụng sử dụng một lớp tuỳ chỉnh cho mọi mục đích ghi nhật ký và được hiển thị thông qua mô-đun GoogleAdsLogger. Lớp này cung cấp một cấu hình mặc định mà cả trình ghi nhật ký tóm tắt và chi tiết sẽ ghi vào các tệp tương đối trong thư mục logs trong thư mục HOME. Tuy nhiên, bạn có thể ghi đè cấu hình mặc định bằng cách cung cấp tệp log4perl.conf trong thư mục HOME.

Bạn có thể bật/tắt tính năng ghi nhật ký bằng các phương thức sau:

  • Cho phép ghi nhật ký cho cả hai trình ghi nhật ký.

    Google::Ads::GoogleAds::Logging::GoogleAdsLogger::enable_all_logging();
    
  • Tắt tính năng ghi nhật ký tóm tắt.

    Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_summary_logging();
    
  • Tắt tính năng ghi nhật ký chi tiết.

    Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_detail_logging();
    

Bạn có thể sử dụng trực tiếp các phương thức của lớp GoogleAdsLogger để kiểm soát nhiều hơn nữa cách các yêu cầu được ghi lại.