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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

"exceptionLogging": "STACKDRIVER",

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

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

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

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

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

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