Ghi nhật ký

Bạn có thể ghi nhật ký 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ác cấp độ nhật ký

Thư viện ghi lại các loại sự kiện khác nhau vào các cấp độ nhật ký khác nhau. Khi API phản hồi thành công, bản tóm tắt sẽ được ghi lại tại INFO, còn toàn bộ yêu cầu và phản hồi sẽ được ghi lại 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 lại ở WARN, còn toàn bộ yêu cầu và phản hồi sẽ được ghi lại ở INFO.

Loại nhật ký	Tên nhật ký	Mức độ thành công	Mức độ 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 lỗi một phần, thông tin chi tiết về lỗi một phần sẽ được ghi vào trình ghi nhật ký DETAIL tại DEBUG.

Cấu hình

Thư viện ứng dụng sử dụng một lớp tuỳ chỉnh cho tất cả 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, trong đó cả trình ghi nhật ký tóm tắt và trình ghi nhật ký chi tiết đều ghi vào các tệp trong thư mục logs trong thư mục HOME của bạn.

Tuỳ chỉnh cấu hình Log4perl

Bạn có thể ghi đè cấu hình mặc định bằng cách cung cấp tệp log4perl.conf tuỳ chỉnh trong thư mục HOME hoặc bằng cách khởi chạy Log::Log4perl trực tiếp trong ứng dụng trước khi thực hiện lệnh gọi API.

Bật hoặc tắt nhật ký

Bạn có thể bật hoặc tắt tính năng ghi nhật ký theo phương thức lập trình bằng các phương thức trợ giúp sau:

• Bật tính năng ghi nhật ký cho cả hai trình ghi nhật ký (chuyển 1 để đặt cấp độ thành DEBUG để tải trọng yêu cầu và phản hồi đầy đủ được ghi lại cho các lệnh gọi thành công):

  use Google::Ads::GoogleAds::Logging::GoogleAdsLogger;
  
  Google::Ads::GoogleAds::Logging::GoogleAdsLogger::enable_all_logging(1);
  

• Tắt tất cả tính năng ghi nhật ký:

  Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_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 chặt chẽ hơn cách ghi nhật ký yêu cầu.