คลาสนี้ช่วยให้นักพัฒนาแอปเขียนลงในบันทึกการดำเนินการและการบันทึกของ Google Cloud ได้หากสคริปต์เชื่อมโยงกับโปรเจ็กต์ Cloud มาตรฐาน เราขอแนะนำให้ใช้คลาสนี้สำหรับการบันทึกที่มีโครงสร้างและjsonPayload
การสนับสนุนใน Cloud Logging สําหรับการบันทึกตามเวลา ให้ใช้ console
เมธอด
วิธีการ | ประเภทการแสดงผล | รายละเอียดแบบย่อ |
---|---|---|
clear() | void | ล้างบันทึก |
getLog() | String | แสดงรายการข้อความทั้งหมดในบันทึกปัจจุบัน |
log(data) | Logger | เขียนข้อมูลลงในบันทึก |
log(format, values) | Logger | เขียนสตริงที่จัดรูปแบบไปยังคอนโซลการบันทึกโดยใช้รูปแบบและค่าที่ระบุ |
เอกสารประกอบโดยละเอียด
clear()
ล้างบันทึก
getLog()
แสดงรายการข้อความทั้งหมดในบันทึกปัจจุบัน วิธีนี้สามารถใช้เพื่อบันทึกหรือส่งออกเอาต์พุตบันทึกทั้งหมดที่สร้างขึ้นระหว่างการเรียกใช้สคริปต์ทางอีเมล
// 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);
รีเทิร์น
String
— บันทึกจากคอนโซลการบันทึก
log(data)
เขียนข้อมูลลงในบันทึก ข้อมูลอาจเป็นสตริง ออบเจ็กต์ JavaScript หรือออบเจ็กต์ที่มีพร็อพเพอร์ตี้ 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
เมื่อส่งออบเจ็กต์ หากออบเจ็กต์มีพร็อพเพอร์ตี้ message
ระบบจะใช้พร็อพเพอร์ตี้นั้นเป็นข้อความบันทึก มิเช่นนั้น ระบบจะเรียกใช้เมธอด toString()
เพื่อแปลงออบเจ็กต์เป็นสตริง พร็อพเพอร์ตี้อื่นๆ ทั้งหมดที่ซีเรียลไลซ์ JSON ได้จะรวมอยู่ใน jsonPayload
ใน LogEntry
คล้ายกับตัวอย่างด้านล่าง
{ "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" }
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
data | Object | ออบเจ็กต์ที่จะบันทึก |
รีเทิร์น
Logger
— เครื่องมือบันทึกสำหรับใช้ต่อเชื่อม
log(format, values)
เขียนสตริงที่จัดรูปแบบไปยังคอนโซลการบันทึกโดยใช้รูปแบบและค่าที่ระบุ สตริงอาจมีตัวยึดตําแหน่ง %s
หลายรายการ ซึ่งระบบจะแทนที่ด้วยค่าที่สอดคล้องกันจากรายการอาร์กิวเมนต์ที่แปลงเป็นสตริง
// 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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
format | String | สตริงรูปแบบที่มีอินสแตนซ์ %s เท่ากับจํานวนอาร์กิวเมนต์ values |
values | Object... | จํานวนค่าแบบแปรผันที่จะแทรกลงในสตริงรูปแบบ |
รีเทิร์น
Logger
— เครื่องมือบันทึกสำหรับใช้ต่อเชื่อม