ค้นหาบันทึกข้อผิดพลาดสำหรับส่วนเสริมของ Google Workspace

เมื่อส่วนเสริม Google Workspace ที่เผยแพร่แล้วแสดงข้อผิดพลาด อินเทอร์เฟซของส่วนเสริมจะแสดงข้อความทั่วไปว่า "เกิดข้อผิดพลาดขณะเรียกใช้ส่วนเสริม" อย่างไรก็ตาม ระบบจะบันทึกข้อผิดพลาดเหล่านี้ไว้ใน Logs Explorer ของ Cloud

หมายเหตุ: สำหรับ Apps Script หากคุณ ติดตั้งใช้งานส่วนเสริมเป็นการทดสอบ ระบบจะรายงานข้อผิดพลาดทั้งใน Cloud Logs Explorer และใน อินเทอร์เฟซส่วนเสริม

ตัวอย่างเช่น การติดตั้งใช้งานการทดสอบส่วนเสริมอาจแสดง ข้อความแสดงข้อผิดพลาดในอินเทอร์เฟซดังนี้ TypeError: card.INVALIDFUNCTIONNAME is not a function [line: 33, function: getContextualAddOn, file: GetContextualAddOn]

แม้ว่าข้อความแสดงข้อผิดพลาดเช่นนี้จะเป็นประโยชน์ แต่ข้อมูลเพิ่มเติมจะ อยู่ใน Logs Explorer แนวทางปฏิบัติแนะนำคือให้ค้นหาบันทึกข้อผิดพลาดเพื่อดูข้อมูลเพิ่มเติม ดูข้อมูลเพิ่มเติมเกี่ยวกับการทดสอบการติดตั้งใช้งานส่วนเสริมได้ที่ ทดสอบและแก้ไขข้อบกพร่องของส่วนเสริม Google Workspace

คู่มือนี้จะอธิบายวิธีค้นหาบันทึกข้อผิดพลาดของส่วนเสริมใน Cloud Logs Explorer เพื่อให้คุณทำสิ่งต่อไปนี้ได้

• ดูว่าผู้ใช้พบข้อผิดพลาดหรือไม่
• ดูว่าข้อผิดพลาดเกิดขึ้นบ่อยแค่ไหนและข้อผิดพลาดใดที่พบบ่อยที่สุด
• อ่านข้อความแสดงข้อผิดพลาดที่อธิบายวิธีแก้ไข

ข้อกำหนดเบื้องต้น

สิ่งที่ควรทราบก่อนค้นหาบันทึกข้อผิดพลาดของส่วนเสริม

• เปิดใช้ "Cloud Logging API" ในโปรเจ็กต์ Google Cloud ของส่วนเสริม หากต้องการเปิดใช้ API โปรดดูที่หัวข้อ สร้างโปรเจ็กต์ Cloud และเปิดใช้ API
• เผยแพร่ส่วนเสริมใน Google Workspace Marketplace หากต้องการเผยแพร่ส่วนเสริมใน Marketplace โปรดดูเผยแพร่แอป

ค้นหาบันทึกข้อผิดพลาดของส่วนเสริม

วิธีดูบันทึกสำหรับส่วนเสริม

1. เปิด Google Cloud Console
2. คลิกลูกศรลง ข้าง "Google Cloud Platform" แล้วเลือก โปรเจ็กต์ส่วนเสริม
3. ที่มุมซ้ายบน ให้คลิกเมนู > การบันทึก Logs Explorer จะเปิดขึ้น

4. สำหรับบันทึกข้อผิดพลาดของส่วนเสริม ให้ป้อนคำค้นหาต่อไปนี้ในเครื่องมือสร้างคำค้นหา

   severity>=ERROR
   protoPayload.serviceName="gsuiteaddons.googleapis.com"
   

5. หากต้องการดูข้อผิดพลาดล่าสุด ให้คลิกเรียกใช้การค้นหา หรือหากต้องการดูข้อผิดพลาดที่เกิดขึ้น ให้คลิกบันทึกของสตรีม บันทึกข้อผิดพลาดของส่วนเสริมจะปรากฏในบานหน้าต่าง "ผลการค้นหา"

ดูข้อมูลเพิ่มเติมเกี่ยวกับ Cloud Logs Explorer และการเขียนการค้นหาได้ที่ รายการต่อไปนี้

• ใช้ Logs Explorer
• สร้างการค้นหา

เปิดหรือปิดใช้การบันทึกข้อผิดพลาด

การบันทึกข้อผิดพลาดจะเปิดใช้อยู่โดยค่าเริ่มต้น เมื่อเปิดใช้การบันทึกข้อผิดพลาด ไฟล์ Manifest จะมีข้อมูลต่อไปนี้

"exceptionLogging": "STACKDRIVER",

หากต้องการปิดใช้การบันทึกข้อผิดพลาด ให้แทนที่ "exceptionLogging": "STACKDRIVER", ด้วยบรรทัดต่อไปนี้ใน ไฟล์ Manifest

// Disable error logging
"exceptionLogging": "NONE"

หากต้องการเปิดใช้การบันทึกข้อผิดพลาดอีกครั้ง ให้แทนที่ "exceptionLogging": "NONE" ด้วย "exceptionLogging": "STACKDRIVER",

ข้อควรพิจารณา

ขณะที่ทำงานกับบันทึกข้อผิดพลาดของส่วนเสริมใน Cloud Logs Explorer โปรดคำนึงถึงข้อควรพิจารณาต่อไปนี้

• โดยส่วนเสริมจะบันทึกข้อผิดพลาดใน Logs Explorer เท่านั้น ระบบจะไม่บันทึก บันทึกประเภทอื่นๆ
• ข้อความแสดงข้อผิดพลาดจะเขียนเป็นภาษาอังกฤษเสมอ
• Cloud Logging จะมีค่าใช้จ่าย ดูข้อมูลเพิ่มเติมเกี่ยวกับราคาของ Cloud Logging ได้ที่ราคาของ Google Cloud Observability