Class Logger

Logger

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 Cloud tiêu chuẩn. Bạn nên 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ứcKiểu 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ý, bằng cách sử dụng định dạng và các 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ộ thông tin đầu ra trong 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, một đối tượng JavaScript hoặc một đố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 điệp 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ể được chuyển đổi tuần tự thành 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ý, để xâu 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ý, bằng cách sử dụng định dạng và các giá trị được cung cấp. Chuỗi này có thể bao gồm nhiều phần giữ chỗ %s. Các phần giữ chỗ này được thay thế bằng các giá trị tương ứng trong 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 nhiều phiên bản của %s như số lượng đối số values
valuesObject...một số lượng biến của các giá trị cần chèn vào chuỗi định dạng

Cầu thủ trả bóng

Logger – Logger, để tạo chuỗi