Class Logger

Trình ghi nhật ký

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ứcLoại dữ liệu trả vềMô tả ngắn
clear()voidXoá nhật ký.
getLog()StringTrả về danh sách đầy đủ các thông báo trong nhật ký hiện tại.
log(data)LoggerGhi dữ liệu vào nhật ký.
log(format, values)LoggerGhi 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ênLoạiMô tả
dataObjectđố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ênLoạiMô tả
formatStringmột chuỗi định dạng chứa số lượng thực thể %s bằng số lượng đối số values
valuesObject...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