เมื่อส่วนเสริมของ Google Workspace ที่เผยแพร่แสดงผลข้อผิดพลาด ส่วนอินเทอร์เฟซส่วนเสริมจะแสดงข้อความทั่วไป "เกิดข้อผิดพลาดขณะเรียกใช้ส่วนเสริม" อย่างไรก็ตาม ข้อผิดพลาดเหล่านี้ บันทึกไปยัง Logs Explorer ของ Cloud
คำแนะนำนี้จะอธิบายวิธีค้นหาบันทึกข้อผิดพลาดของส่วนเสริมใน Cloud Logging Explorer ซึ่งช่วยให้คุณทำสิ่งต่อไปนี้ได้
- ดูว่าผู้ใช้พบข้อผิดพลาดหรือไม่
- ดูว่าข้อผิดพลาดเกิดขึ้นบ่อยเพียงใด และข้อผิดพลาดใดบ่อยที่สุด
- อ่านข้อความแสดงข้อผิดพลาดที่สื่อความหมายซึ่งช่วยคุณแก้ไขได้
ข้อกำหนดเบื้องต้น
ก่อนค้นหาบันทึกข้อผิดพลาดของส่วนเสริม ให้ทำดังนี้
- เปิดใช้ "Cloud Logging API" ในส่วนเสริม โปรเจ็กต์ Google Cloud หากต้องการเปิดใช้ API โปรดดู สร้างโปรเจ็กต์ระบบคลาวด์และเปิดใช้ API
- เผยแพร่ส่วนเสริมใน Google Workspace Marketplace วิธีเผยแพร่ส่วนเสริมใน มาร์เก็ตเพลส โปรดดู เผยแพร่แอป
บันทึกข้อผิดพลาดของส่วนเสริมการค้นหา
วิธีรับบันทึกสำหรับส่วนเสริม
- เปิดคอนโซล Google Cloud
- ข้าง "Google Cloud Platform" คลิกลูกศรลง แล้วเลือก โปรเจ็กต์ส่วนเสริม
- คลิกเมนู ที่มุมซ้ายบน การบันทึก เครื่องมือสำรวจบันทึกจะเปิดขึ้น
สำหรับบันทึกข้อผิดพลาดของส่วนเสริม ให้ป้อนในเครื่องมือสร้างการค้นหา คำค้นหาต่อไปนี้:
severity>=ERROR protoPayload.serviceName="gsuiteaddons.googleapis.com"
หากต้องการดูข้อผิดพลาดล่าสุด ให้คลิกเรียกใช้คำค้นหา หรือหากต้องการดูข้อผิดพลาดในขณะที่ ให้คลิกบันทึกของสตรีม บันทึกข้อผิดพลาดของส่วนเสริมจะปรากฏในส่วน "ผลการค้นหา" แผง
ดูข้อมูลเพิ่มเติมเกี่ยวกับ Cloud Logging Explorer และการเขียนการค้นหาได้ที่ ดังต่อไปนี้
เปิดหรือปิดการบันทึกข้อผิดพลาด
การบันทึกข้อผิดพลาดจะเปิดใช้อยู่โดยค่าเริ่มต้น เมื่อเปิดใช้การบันทึกข้อผิดพลาด ไฟล์ Manifest มีสิ่งต่อไปนี้
"exceptionLogging": "STACKDRIVER",
หากต้องการปิดการบันทึกข้อผิดพลาด ให้แทนที่
"exceptionLogging": "STACKDRIVER",
ที่มีบรรทัดต่อไปนี้ใน
ไฟล์ Manifest:
// Disable error logging
"exceptionLogging": "NONE"
หากต้องการเปิดการบันทึกข้อผิดพลาดอีกครั้ง ให้แทนที่ "exceptionLogging": "NONE"
ด้วย
"exceptionLogging": "STACKDRIVER",
ข้อควรพิจารณา
ขณะที่คุณดำเนินการกับบันทึกข้อผิดพลาดของส่วนเสริมในบันทึกของ Cloud โปรดสำรวจข้อควรพิจารณาต่อไปนี้
- ส่วนเสริมจะบันทึกเฉพาะข้อผิดพลาดในเครื่องมือสำรวจบันทึกเท่านั้น บันทึกประเภทอื่นๆ คือ ไม่ได้บันทึก
- ข้อความแสดงข้อผิดพลาดจะเขียนเป็นภาษาอังกฤษเสมอ
- Cloud Logging จะมีค่าใช้จ่าย ดูข้อมูลเพิ่มเติมเกี่ยวกับ Cloud Logging โปรดดูราคาที่หัวข้อราคาความสามารถในการสังเกตของ Google Cloud