ดูบันทึกข้อผิดพลาดของไซต์

ผู้ดูแลระบบเว็บไซต์และนักพัฒนาใช้ Power Pages เพื่อสร้างเว็บไซต์สำหรับลูกค้าของตน นักพัฒนามักดีบักปัญหาขณะพัฒนาเว็บไซต์ เพื่อช่วยในการดีบัก คุณสามารถเข้าถึงไฟล์บันทึกข้อผิดพลาดโดยละเอียดสำหรับปัญหาต่าง ๆ บนเว็บไซต์ของคุณ มีหลายวิธีที่คุณสามารถเรียกดูไฟล์บันทึกข้อผิดพลาดสำหรับเว็บไซต์ของคุณ

เคล็ดลับ

หากต้องการเรียนรู้เกี่ยวกับบทบาทที่จำเป็นในการดำเนินงานในบทความนี้ โปรดอ่าน บทบาทผู้ดูแลระบบที่จำเป็นสำหรับงานการดูแลระบบพอร์ทัล

ข้อผิดพลาดแบบกำหนดเอง

ถ้าเกิดข้อยกเว้นฝั่งเซิร์ฟเวอร์ใดๆ ในเว็บไซต์ของคุณ หน้าข้อผิดพลาดแบบกำหนดเองที่มีข้อความข้อผิดพลาดที่ผู้ใช้เข้าใจง่ายจะถูกแสดงโดยค่าเริ่มต้น เมื่อต้องการกำหนดค่าข้อความแสดงข้อผิดพลาด ดู แสดงข้อความข้อผิดพลาดแบบกำหนดเอง

อย่างไรก็ตาม จะดีกว่าถ้าดู ASP.NET ซึ่งแสดงรายละเอียดในหน้าแสดงข้อผิดพลาด หรือที่เรียกอีกอย่างหนึ่งว่า Yellow Screen of Death (YSOD) เพื่อวัตถุประสงค์ในการตรวจแก้จุดบกพร่อง หน้าแสดงข้อผิดพลาดโดยละเอียดช่วยให้คุณสามารถรับกองซ้อนแบบเต็มรูปแบบของข้อผิดพลาดของเซิร์ฟเวอร์

เมื่อต้องการเปิดใช้งาน YSOD คุณต้อง ปิดใช้งานข้อผิดพลาดแบบกำหนดเอง บนเว็บไซต์ของคุณ

หมายเหตุ

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

ข้อมูลเพิ่มเติมเกี่ยวกับข้อผิดพลาดแบบกำหนดเอง: การแสดงเพจแสดงข้อผิดพลาดแบบกำหนดเอง

ปิดใช้งานข้อผิดพลาดแบบกำหนดเอง

คุณสามารถปิดใช้งานข้อผิดพลาดแบบกำหนดเองบนเว็บไซต์ Power Pages เพื่อแสดงข้อความข้อยกเว้นโดยละเอียด ถ้าข้อยกเว้นฝั่งเซิร์ฟเวอร์ใดๆ เกิดขึ้นในเว็บไซต์ของคุณ

1. เปิด ศูนย์จัดการ Power Platform

2. ใต้ส่วน ทรัพยากร ให้เลือก ไซต์ Power Pages

3. เลือกเว็บไซต์ของคุณ

4. จากเมนู การดำเนินการของไซต์ ให้เลือก ปิดใช้งานข้อผิดพลาดแบบกำหนดเอง

5. เลือก ปิดใช้งาน ในข้อความการยืนยัน ในขณะที่ข้อผิดพลาดแบบกำหนดเองถูกปิดการใช้งาน เว็บไซต์จะรีสตาร์ทและจะไม่สามารถใช้งานได้

เปิดใช้งานข้อผิดพลาดแบบกำหนดเอง

คุณสามารถเปิดใช้งานข้อผิดพลาดแบบกำหนดเองบนเว็บไซต์เพื่อแสดงเพจที่ดูเป็นมืออาชีพแทน YSOD หน้านี้แสดงข้อมูลที่มีความหมาย ถ้าข้อยกเว้นใดๆ เกิดขึ้นในแอพลิเคชัน

1. เปิด ศูนย์จัดการ Power Platform

2. ใต้ส่วน ทรัพยากร ให้เลือก ไซต์ Power Pages

3. เลือกเว็บไซต์ของคุณ

4. จากเมนู การดำเนินการของไซต์ ให้เลือก เปิดใช้งานข้อผิดพลาดแบบกำหนดเอง

5. เลือก เปิดใช้งาน ในข้อความการยืนยัน ในขณะที่ข้อผิดพลาดแบบกำหนดเองถูกเปิดใช้งาน เว็บไซต์จะรีสตาร์ทและจะไม่สามารถใช้งานได้

หมายเหตุ

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

แสดงข้อความข้อผิดพลาดแบบกำหนดเอง

คุณสามารถกำหนดค่าเว็บไซต์ของคุณเพื่อแสดงข้อผิดพลาดแบบกำหนดเองที่ดูเป็นมืออาชีพแทนที่จะเป็นข้อผิดพลาดทั่วไป

เมื่อต้องการกำหนดความผิดพลาดแบบกำหนดเอง ใช้ snippet เนื้อหา Portal Generic Error เนื้อหาที่กำหนดไว้ในส่วนย่อยนี้จะปรากฏบนหน้าแสดงข้อผิดพลาด ส่วนย่อยเนื้อหานี้ไม่พร้อมใช้งานแบบสำเร็จรูป และคุณต้องสร้าง ส่วนย่อยเนื้อหา ชนิด สามารถเป็น ข้อความ หรือ HTML ได้ เมื่อต้องการสร้างหรือแก้ไขการ snippet เนื้อหา ดูกำหนดเนื้อหาโดยการใช้ส่วนย่อยของโค้ดเนื้อหา

หมายเหตุ

ถ้ามีการบันทึกรหัสแบบไม่ตายตัวในส่วนย่อยเนื้อหาจะถูกข้ามและไม่ถูกแสดง

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

<Content Snippet>
<Error ID >
<Date and time>
<Portal ID>

ข้อความต่อไปนี้เป็นตัวอย่างของข้อความแสดงข้อผิดพลาดแบบกำหนดเอง โดยใช้ส่วนย่อยเนื้อหาของชนิด HTML:

This is a custom error, file a support ticket with screenshot of error by clicking here

หมายเหตุ

ถ้าเว็บไซต์ไม่สามารถเรียกใช้ส่วนย่อยเนื้อหาได้เนื่องจากไม่สามารถเชื่อมต่อไปยัง Microsoft Dataverse หรือถ้าส่วนย่อยไม่มีอยู่ใน Dataverse ข้อผิดพลาดจะปรากฏขึ้น

เข้าถึงล็อกข้อผิดพลาดของเว็บไซต์

หลังจากการพัฒนาและการเผยแพร่เว็บไซต์ คุณยังจำเป็นต้องสามารถเข้าถึงล็อกเว็บไซต์ได้ เพื่อดีบักปัญหาที่รายงานโดยผู้ใช้ของคุณ ในการเข้าถึงบันทึก ให้กำหนดค่าเว็บไซต์ของคุณเพื่อส่งข้อผิดพลาดของแอปพลิเคชันทั้งหมดไปยังบัญชีที่เก็บข้อมูล Azure Blob ที่คุณเป็นเจ้าของ โดยการเข้าถึงไฟล์บันทึกข้อผิดพลาดของเว็บไซต์ ผู้ใช้สามารถตอบสนองต่อแบบสอบถามของลูกค้าได้อย่างมีประสิทธิภาพ เนื่องจากคุณมีรายละเอียดของปัญหา เพื่อใส่บันทึกข้อผิดพลาดของเว็บไซต์ไว้ในที่เก็บข้อมูล Azure Blob ของคุณ คุณต้องเปิดใช้งานบันทึกการวินิจฉัยจากศูนย์จัดการ Power Platform

หมายเหตุ

ถ้าคุณเปลี่ยนอินสแตนซ์ Dataverse ที่เชื่อมต่อกับเว็บไซต์ของคุณ บันทึกการวินิจฉัยจะถูกปิดใช้งาน คุณต้องเปิดใช้งานบันทึกการวินิจฉัยอีกครั้ง

เปิดใช้งานการบันทึกการวินิจฉัย

1. เปิด ศูนย์จัดการ Power Platform

2. ใต้ส่วน ทรัพยากร ให้เลือก ไซต์ Power Pages

3. เลือกเว็บไซต์ของคุณ

4. จากเมนู การดำเนินการของไซต์ ให้เลือก เปิดใช้งานบันทึกการวินิจฉัย

5. แผงด้านข้างที่ชื่อ เปิดใช้งานการบันทึกการวินิจฉัย จะปรากฏขึ้น ป้อนค่าต่อไปนี้:

   • เลือกระยะเวลาการเก็บรักษา: ระยะเวลาการเก็บล็อกข้อผิดพลาดพอร์ทัลในที่เก็บ blob แฟ้มบันทึกข้อผิดพลาดจะถูกลบออก หลังจากระยะเวลาที่เลือก คุณสามารถเลือกค่าอย่างใดอย่างหนึ่งต่อไปนี้:

     • หนึ่งวัน

     • เจ็ดวัน

     • 30 วัน

     • 60 วัน

     • 90 วัน

     • 180 วัน

     • ทุกครั้ง

       โดยค่าเริ่มต้น ระยะเวลาการเก็บรักษาคือ 30 วัน

     หมายเหตุ

     ปัจจุบัน UI จะแสดงเฉพาะระยะเวลาการเก็บข้อมูลเริ่มต้นที่ 30 วัน การเปลี่ยนแปลงระยะเวลาการเก็บข้อมูลจะไม่ปรากฏใน UI

   • สตริงการเชื่อมต่อของบริการที่เก็บ Azure Blob: URL ของบริการที่เก็บ Azure Blob ในการเก็บไฟล์บันทึกข้อผิดพลาดของเว็บไซต์ ความยาวสูงสุดของ URL คือ 2048 อักขระ ถ้า URL มีความยาวเกินกว่า 2048 อักขระ ข้อความแสดงข้อผิดพลาดจะปรากฏขึ้น ข้อมูลเพิ่มเติมเกี่ยวกับสตริงการเชื่อมต่อ: กำหนดค่าสตริงการเชื่อมต่อของที่จัดเก็บ Azure

6. เลือก เปิดใช้งาน

เมื่อมีการกำหนดค่าบันทึกการวินิจฉัย คอนเทนเนอร์ blob ของ บันทึกการตรวจวัดระยะไกล ใหม่ จะถูกสร้างขึ้นในบัญชีจัดเก็บ Azure ของคุณ และไฟล์บันทึกจะถูกเขียนลงในไฟล์ blob ซึ่งเก็บไว้ในคอนเทนเนอร์ การจับภาพหน้าจอต่อไปนี้แสดงคอนเทนเนอร์ blob บันทึกการตรวจวัดระยะไกล ใน Azure Storage Explorer:

เมื่อบันทึกการวินิจฉัยถูกเปิดใช้งานเรียบร้อยแล้ว การดำเนินการต่อไปนี้จะพร้อมใช้งานจากเมนู การดำเนินการของไซต์:

• ปิดใช้งานการบันทึกการวินิจฉัย: ช่วยให้คุณสามารถปิดใช้งานการกำหนดค่าการบันทึกการวินิจฉัยสำหรับพอร์ทัลได้
• ปรับปรุงการกำหนดค่าการบันทึกการวินิจฉัย: ช่วยให้คุณสามารถปรับปรุง หรือลบบันทึกการกำหนดค่าการบันทึกการวินิจฉัยสำหรับพอร์ทัลได้

ปรับปรุงการบันทึกการวินิจฉัย

1. เปิด ศูนย์จัดการ Power Platform

2. ใต้ส่วน ทรัพยากร ให้เลือก ไซต์ Power Pages

3. เลือกเว็บไซต์ของคุณ

4. จากเมนู การดำเนินการของไซต์ ให้เลือก อัปเดตการกำหนดค่าการบันทึกการวินิจฉัย

5. ในแผงอัปเดตการกำหนดค่าการบันทึกการวินิจฉัย ป้อนค่าต่อไปนี้:

   • คุณต้องการปรับปรุงสตริงการเชื่อมต่อของบริการ Azure Blob Storage ใช่หรือไม่: อนุญาตให้คุณสามารถระบุว่าจะปรับปรุงสตริงการเชื่อมต่อของบริการ Azure Blob Storage หรือไม่ ตัวเลือกนี้จะไม่ได้รับการเลือกตามค่าเริ่มต้น

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

     • หนึ่งวัน
     • เจ็ดวัน
     • 30 วัน
     • 60 วัน
     • 90 วัน
     • 180 วัน
     • ทุกครั้ง

     โดยค่าเริ่มต้น ระยะเวลาการเก็บรักษาคือ 30 วัน

   • สตริงการเชื่อมต่อของบริการที่เก็บ Azure Blob: URL ของบริการที่เก็บ Azure Blob ในการเก็บไฟล์บันทึกข้อผิดพลาดของเว็บไซต์ ความยาวสูงสุดของ URL อาจเป็น 2048 อักขระ ถ้า URL มีความยาวเกินกว่า 2048 อักขระ ข้อความแสดงข้อผิดพลาดจะปรากฏขึ้น ฟิลด์นี้จะแสดงขึ้นเฉพาะเมื่อมีการเลือกกล่องกาเครื่องหมาย คุณต้องการปรับปรุงสตริงการเชื่อมต่อของ Azure Blob Storage หรือไม่? ข้อมูลเพิ่มเติมเกี่ยวกับสตริงการเชื่อมต่อ: กำหนดค่าสตริงการเชื่อมต่อของที่จัดเก็บ Azure

ปิดใช้งานการบันทึกการวินิจฉัย

1. เปิด ศูนย์จัดการ Power Platform

2. ใต้ส่วน ทรัพยากร ให้เลือก ไซต์ Power Pages

3. เลือกเว็บไซต์ของคุณ

4. จากเมนู การดำเนินการของไซต์ ให้เลือก ปิดใช้งานการบันทึกการวินิจฉัย

5. เลือก ปิดใช้งาน ในข้อความการยืนยัน

แสดงข้อผิดพลาดปลั๊กอิน

สถานการณ์อื่นที่มักจะเกิดขึ้นในขณะที่ทำการพัฒนาเว็บไซต์คือ ข้อผิดพลาดที่สร้างขึ้นโดยปลั๊กอินแบบกำหนดเองและตรรกะทางธุรกิจที่เขียนในสภาพแวดล้อม Dataverse ของคุณ ข้อผิดพลาดเหล่านี้โดยทั่วไปจะสามารถเข้าถึงโดย การปิดการใช้งานข้อผิดพลาดแบบกำหนดเอง หรือ การเปิดใช้งานการบันทึกการวินิจฉัย ในบางกรณี จะเร็วกว่าในการแสดงข้อผิดพลาดเหล่านี้โดยตรงบนเว็บไซต์เพื่อให้วิเคราะห์ปัญหาได้เร็วขึ้น คุณสามารถทำงานนี้ได้โดยกำหนดค่าเว็บไซต์ของคุณให้แสดงข้อผิดพลาดปลั๊กอินแบบกำหนดเองจาก Dataverse บนหน้าเว็บของคุณได้

เมื่อต้องการแสดงข้อผิดพลาดของปลั๊กอินแบบกำหนดเอง ให้สร้าง การตั้งค่าไซต์Site/EnableCustomPluginError และตั้งค่าให้เป็น จริง ข้อผิดพลาดปลั๊กอินแบบกำหนดเองจะถูกแสดงบนหน้าจอแทนที่จะเป็นข้อผิดพลาดทั่วไป ข้อผิดพลาดจะแสดงเฉพาะส่วนข้อความของข้อผิดพลาดปลั๊กอิน และไม่แสดงการติดตามสแต็คที่สมบูรณ์

รายการต่อไปนี้คือหน้าจอที่จะปรากฏข้อผิดพลาดปลั๊กอินแบบกำหนดเอง:

• รายการ
  • การเรียกเรกคอร์ด
• ฟอร์มพื้นฐาน
  • ดึงข้อมูล
  • สร้าง/ปรับปรุง เป็นต้น
• ฟอร์มแบบหลายขั้นตอน
  • Retrieve
  • สร้าง/ปรับปรุง เป็นต้น

ถ้าไม่มีการตั้งค่าไซต์ จากนั้นจะถือเป็นเท็จโดยค่าเริ่มต้นและข้อผิดพลาดปลั๊กอินจะไม่แสดง

ดูข้อผิดพลาดฝั่งเซิร์ฟเวอร์ในส่วนขยาย DevTools

คุณสามารถดูข้อความแสดงข้อผิดพลาดฝั่งเซิร์ฟเวอร์และวิธีแก้ปัญหาที่อาจเป็นไปได้โดยใช้ ส่วนขยาย Power Pages DevTools นอกจากนี้คุณยังสามารถแก้ไขโค้ดฝั่งเซิร์ฟเวอร์ได้โดยการบันทึกข้อความที่กำหนดเอง เรียนรู้เพิ่มเติมใน ส่วนขยาย Power Pages DevTools: บันทึกข้อความที่กำหนดเองด้วย Liquid