Lớp này cho phép nhà phát triển ghi vào Nhật ký thực thi và Google Cloud Logging nếu tập lệnh được liên kết với một Dự án trên Google Cloud tiêu chuẩn. Bạn nên sử dụng lớp này để ghi nhật ký có cấu trúc và hỗ trợ jsonPayload
trong Cloud Logging. Để ghi nhật ký dựa trên thời gian, hãy sử dụng console
.
Phương thức
Phương thức | Loại dữ liệu trả về | Mô tả ngắn |
---|---|---|
clear() | void | Xoá nhật ký. |
getLog() | String | Trả về danh sách đầy đủ các thông báo trong nhật ký hiện tại. |
log(data) | Logger | Ghi dữ liệu vào nhật ký. |
log(format, values) | Logger | Ghi một chuỗi được định dạng vào bảng điều khiển ghi nhật ký, sử dụng định dạng và giá trị được cung cấp. |
Tài liệu chi tiết
clear()
Xoá nhật ký.
getLog()
Trả về danh sách đầy đủ các thông báo trong nhật ký hiện tại. Bạn có thể dùng phương thức này để lưu hoặc gửi email toàn bộ kết quả nhật ký được tạo trong quá trình thực thi tập lệnh.
// Generate a log, then email it to the person who ran the script. const files = DriveApp.getFiles(); while (files.hasNext()) { Logger.log(files.next().getName()); } const recipient = Session.getActiveUser().getEmail(); const subject = 'A list of files in your Google Drive'; const body = Logger.getLog(); MailApp.sendEmail(recipient, subject, body);
Cầu thủ trả bóng
String
– nhật ký từ bảng điều khiển ghi nhật ký
log(data)
Ghi dữ liệu vào nhật ký. Dữ liệu có thể là một chuỗi, đối tượng JavaScript hoặc đối tượng có thuộc tính message
.
Logger.log("my log message"); // Info my logmessage Logger.log({ key: "value" }); // Info {key=value} Logger.log({ message: "my log message", data: { key: "value" } }) // Info my logmessage
Khi truyền một đối tượng, nếu đối tượng đó chứa thuộc tính message
, thì thuộc tính đó sẽ được dùng làm thông báo nhật ký. Nếu không, phương thức toString()
sẽ được gọi để chuyển đổi đối tượng thành một chuỗi. Tất cả các thuộc tính khác có thể chuyển đổi tuần tự JSON đều được đưa vào jsonPayload
trong LogEntry
, tương tự như ví dụ bên dưới:
{ "insertId": "w5eib...", "jsonPayload": { "message": "my log message", "serviceContext": { "service": "AKfyc..." }, "data": { "key": "value" } }, "resource": { "type": "app_script_function", "labels": { "invocation_type": "editor", "function_name": "unknown", "project_id": "1234567890" } }, "timestamp": "2024-11-15T23:28:19.448591Z", "severity": "INFO", "labels": { "script.googleapis.com/user_key": "AOX2d...", "script.googleapis.com/process_id": "EAEA1...", "script.googleapis.com/project_key": "MQXvl...", "script.googleapis.com/deployment_id": "AKfyc..." }, "logName": "projects/[PROJECT_ID]/logs/script.googleapis.com%2Fconsole_logs", "receiveTimestamp": "2024-11-15T23:28:20.363790313Z" }
Tham số
Tên | Loại | Mô tả |
---|---|---|
data | Object | đối tượng cần ghi nhật ký |
Cầu thủ trả bóng
Logger
– Trình ghi nhật ký, để tạo chuỗi.
log(format, values)
Ghi một chuỗi được định dạng vào bảng điều khiển ghi nhật ký, sử dụng định dạng và giá trị được cung cấp. Chuỗi này có thể bao gồm nhiều phần giữ chỗ %s
, được thay thế bằng các giá trị tương ứng từ danh sách đối số, được chuyển đổi thành chuỗi.
// Log the number of Google Groups you belong to. const groups = GroupsApp.getGroups(); Logger.log('You are a member of %s Google Groups.', groups.length);
Tham số
Tên | Loại | Mô tả |
---|---|---|
format | String | một chuỗi định dạng chứa số lượng thực thể %s bằng số lượng đối số values |
values | Object... | một số lượng giá trị biến để chèn vào chuỗi định dạng |
Cầu thủ trả bóng
Logger
– Trình ghi nhật ký, để tạo chuỗi