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 cách sử dụng trình ghi nhật ký mặc định trong thư viện ứng dụng Ruby hoặc trình ghi nhật ký Ruby tuỳ chỉnh của riêng bạn. Nếu bạn không cung cấp cấu hình ghi nhật ký, thì tính năng ghi nhật ký sẽ bị tắt theo mặc định.
Các cấp độ nhật ký
Thư viện ghi lại các sự kiện ở nhiều cấp độ nhật ký tuỳ thuộc vào kết quả của yêu cầu API:
| Loại sự kiện | Cấp độ nhật ký tóm tắt | Cấp nhật ký yêu cầu và phản hồi đầy đủ |
|---|---|---|
| Phản hồi thành công của API | INFO |
DEBUG |
| Lỗi API | WARN |
INFO |
| Không thực hiện được một phần | Không có | DEBUG (thông tin chi tiết về lỗi một phần) |
Cấu hình
Bạn có thể định cấu hình hoạt động ghi nhật ký trong tệp cấu hình google_ads_config.rb hoặc theo phương thức lập trình trong thời gian chạy.
Trình ghi nhật ký mặc định
Thiết lập trình ghi nhật ký mặc định bằng cách chỉ định các trường log_level và log_target trong tệp google_ads_config.rb:
Google::Ads::GoogleAds::Config.new do |c|
# Valid levels: 'DEBUG', 'INFO', 'WARN', 'ERROR', 'FATAL'
c.log_level = 'INFO'
# Output destination, such as STDOUT, STDERR, or a file path
c.log_target = STDOUT
end
Trình ghi nhật ký tuỳ chỉnh
Bạn cũng có thể chỉ định phiên bản Logger Ruby tuỳ chỉnh của riêng mình bằng cách sử dụng trường logger. Nếu bạn chỉ định logger, thì log_level và log_target sẽ bị bỏ qua:
require 'logger'
# In google_ads_config.rb:
Google::Ads::GoogleAds::Config.new do |c|
c.logger = Logger.new('log/google_ads.log')
end
Bạn cũng có thể chỉ định một trình ghi nhật ký tuỳ chỉnh sau khi khởi tạo ứng dụng bằng client.logger=. Xin lưu ý rằng điều này chỉ có hiệu lực đối với các ứng dụng dịch vụ được tìm nạp (client.service.<name>) sau khi client.logger được đặt:
require 'logger'
client = Google::Ads::GoogleAds::GoogleAdsClient.new
client.logger = Logger.new(STDOUT)