หมายเหตุ
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลอง ลงชื่อเข้าใช้หรือเปลี่ยนไดเรกทอรีได้
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลองเปลี่ยนไดเรกทอรีได้
บันทึกช่วยให้คุณเข้าใจว่าฟังก์ชันข้อมูลผู้ใช้ของคุณกําลังดําเนินการอย่างไร และวินิจฉัยปัญหาเมื่อฟังก์ชันไม่ทํางานตามที่คาดไว้ คุณสามารถดูบันทึกได้สองวิธี:
- ระหว่างการทดสอบ - ดูบันทึกแบบเรียลไทม์ในแผงทดสอบเมื่อทดสอบฟังก์ชันในโหมดพัฒนา
- หลังจากการเรียกใช้ - ดูบันทึกในอดีตสําหรับฟังก์ชันที่เผยแพร่ซึ่งถูกเรียกใช้
บทความนี้อธิบายวิธีการดูและใช้บันทึกเพื่อตรวจสอบการเรียกใช้ฟังก์ชันและแก้ไขปัญหา
ดูบันทึกระหว่างการทดสอบ
เมื่อคุณทดสอบฟังก์ชัน คุณจะเห็นบันทึกแบบเรียลไทม์ขณะที่ฟังก์ชันของคุณทํางาน:
- แผงทดสอบในโหมดพัฒนา - ดูบันทึกเมื่อทดสอบฟังก์ชันที่ไม่ได้เผยแพร่หรือเผยแพร่
- เรียกใช้แผงในโหมดเรียกใช้อย่างเดียว - ดูบันทึกเมื่อเรียกใช้ฟังก์ชันที่เผยแพร่
แผงทั้งสองจะแสดงเอาต์พุตบันทึกทันที ช่วยให้คุณดูรายละเอียดการดําเนินการและปัญหาการแก้ไขข้อบกพร่องที่เกิดขึ้นได้ สําหรับข้อมูลเพิ่มเติมเกี่ยวกับการทดสอบฟังก์ชัน โปรดดู ทดสอบฟังก์ชันข้อมูลผู้ใช้ของคุณ
ดูบันทึกในอดีตสําหรับฟังก์ชันที่เรียกใช้
หลังจากเรียกใช้ฟังก์ชันที่เผยแพร่แล้ว คุณจะดูบันทึกในอดีตเพื่อวิเคราะห์การดําเนินการที่ผ่านมาได้
วิธีเข้าถึงบันทึกในอดีต:
เปลี่ยนเป็น โหมดเรียกใช้เท่านั้น โดยใช้ตัวสลับโหมด
วางเมาส์เหนือชื่อฟังก์ชันในรายการฟังก์ชัน
เลือกไอคอนจุดไข่ปลา (...) จากนั้นเลือก ดูบันทึกประวัติ
ทําความเข้าใจมุมมองบันทึกในอดีต
มุมมองบันทึกในอดีตแสดงการเรียกใช้ล่าสุดสําหรับฟังก์ชันที่เลือก คุณสามารถดูรายการได้สูงสุด 50 รายการ และบันทึกจะถูกเก็บไว้เป็นเวลา 30 วัน เลือกลิงก์วันที่ในคอลัมน์ วันที่ (UTC) เพื่อดูบันทึกโดยละเอียดสําหรับการเรียกใช้เฉพาะ
บานหน้าต่าง บันทึกในอดีตทั้งหมด มีข้อมูลต่อไปนี้ต่อการเรียกใช้:
- Date (UTC) ประทับเวลาที่แสดงการเรียกใช้จุดเริ่มต้นของฟังก์ชัน เลือกลิงก์เพื่อตรวจสอบรายการบันทึกทั้งหมดสําหรับการเรียกใช้นั้น ซึ่งแสดงรายละเอียดของการเรียกใช้กับข้อความทั้งหมดที่บันทึกไว้โดยผู้ใช้หรือบริการ
- สถานะ ระบุว่าการเรียกสําเร็จหรือล้มเหลว
- Duration(ms) ระยะเวลาการดําเนินการของฟังก์ชันเป็นมิลลิวินาที
- รหัสการเรียกใช้ ID ของการเรียกใช้ฟังก์ชันเฉพาะนั้น รหัสการเรียกจะถูกส่งกลับเป็นส่วนหนึ่งของส่วนหัว HTTP หากมีปัญหาใด ๆ ผู้ใช้สามารถอ้างอิง ID การเรียกใช้นี้ในคําขอการสนับสนุนเพื่อดึงข้อมูลเพิ่มเติมเกี่ยวกับการเรียกใช้
ดูบันทึกโดยละเอียดสําหรับการเรียกใช้เฉพาะ
หลังจากที่คุณได้เปิดมุมมองบันทึกในอดีต (ตามที่อธิบายไว้ในส่วนก่อนหน้า) คุณสามารถดูรายละเอียดแนวลึกลงไปในการเรียกใช้แต่ละรายการได้ เมื่อคุณเลือกลิงก์การประทับเวลาในคอลัมน์ วันที่ (UTC) บานหน้าต่าง รายละเอียดการเรียกใช้ จะเปิดขึ้นเพื่อแสดงบันทึกทั้งหมดสําหรับการเรียกใช้นั้น คุณสามารถดู:
- บันทึกทั้งหมดที่เพิ่มในโค้ดฟังก์ชันของคุณโดยใช้
loggingโมดูล - บันทึกที่ระบบสร้างขึ้นเกี่ยวกับการทํางานของฟังก์ชัน
- ข้อผิดพลาดหรือข้อยกเว้นใดๆ ที่เกิดขึ้น
รายการบันทึกแต่ละรายการจะมีการประทับเวลา ข้อความบันทึก และระดับบันทึก (ข้อมูล คําเตือน ข้อผิดพลาด วิกฤต)
เพิ่มการบันทึกให้กับฟังก์ชันของคุณ
คุณสามารถเพิ่มคําสั่งบันทึกที่กําหนดเองให้กับฟังก์ชันของคุณโดยใช้โมดูลมาตรฐาน logging ของ Python บันทึกช่วยให้คุณติดตามพฤติกรรมของฟังก์ชัน ตรวจสอบการประมวลผลข้อมูล และวินิจฉัยปัญหา
นําเข้าโมดูลการบันทึก
ขั้นแรก ให้นําเข้า logging โมดูลในรหัสฟังก์ชันของคุณ:
import logging
หมายเหตุ
loggingโมดูลจะถูกนําเข้าตามค่าเริ่มต้นเมื่อคุณสร้างรายการฟังก์ชันข้อมูลผู้ใช้ใหม่ในพอร์ทัล Fabric หรือใช้ส่วนขยาย VS Code
ใช้ระดับบันทึกที่เหมาะสม
Python มีระดับบันทึกที่แตกต่างกันสําหรับสถานการณ์ที่แตกต่างกัน ใช้ระดับที่เหมาะสมเพื่อทําให้บันทึกของคุณมีความหมายมากขึ้น:
# INFO - Track normal function execution and key steps
logging.info('Processing started for customer ID: 12345')
logging.info('Successfully retrieved 150 records from database')
# WARNING - Log potentially problematic situations that don't prevent execution
logging.warning('API response time exceeded 2 seconds')
logging.warning('Using cached data because fresh data is unavailable')
# ERROR - Log errors that affect functionality but don't crash the function
logging.error('Failed to connect to external API: Connection timeout')
logging.error('Invalid data format in row 42')
# CRITICAL - Log severe errors that may cause function failure
logging.critical('Database connection lost')
logging.critical('Required configuration parameter missing')
แนวทางปฏิบัติแนะนําสําหรับการบันทึก
ปฏิบัติตามแนวทางปฏิบัติเหล่านี้เพื่อทําให้บันทึกของคุณมีประสิทธิภาพมากขึ้น
- บันทึกข้อมูลที่มีความหมาย - รวมรายละเอียดที่เกี่ยวข้อง เช่น รหัส จํานวน หรือค่าพารามิเตอร์ที่ช่วยวินิจฉัยปัญหา
- ใช้ระดับบันทึกที่เหมาะสม - อย่าบันทึกทุกอย่างเป็น INFO หรือ ERROR ใช้ระดับที่เหมาะสมกับสถานการณ์
- บันทึกที่จุดสําคัญ - เพิ่มบันทึกที่จุดเริ่มต้นของฟังก์ชัน ก่อนและหลังการเรียกภายนอก และเมื่อประมวลผลข้อมูล
- หลีกเลี่ยงการบันทึกข้อมูลที่ละเอียดอ่อน - อย่าบันทึกรหัสผ่าน โทเค็น ข้อมูลส่วนบุคคล หรือข้อมูลที่ละเอียดอ่อนอื่นๆ
- ทําให้ข้อความกระชับ - เขียนข้อความบันทึกสั้น ๆ ที่ชัดเจนและง่ายต่อการสแกน
- คํานึงถึงปริมาณ - การบันทึกที่มากเกินไปอาจส่งผลต่อประสิทธิภาพและถึงขีดจํากัดการนําเข้ารายวัน
สําหรับข้อมูลเพิ่มเติมเกี่ยวกับการเขียนโค้ดฟังก์ชัน โปรดดูแบบจําลองการเขียนโปรแกรม Python
ข้อจํากัดและการเก็บรักษาบันทึก
โปรดคํานึงถึงข้อจํากัดต่อไปนี้เมื่อทํางานกับบันทึก
- การเก็บรักษาบันทึก - บันทึกการเรียกใช้ในอดีตจะถูกเก็บไว้เป็นเวลา 30 วันตามค่าเริ่มต้น
- รายการที่มองเห็นได้ - มุมมองบันทึกในอดีตแสดงรายการได้สูงสุด 50 รายการต่อฟังก์ชัน
- ความพร้อมใช้งานของบันทึก - บันทึกการเรียกใช้อาจใช้เวลาสักครู่จึงจะปรากฏ รีเฟรชหน้าถ้าคุณไม่เห็นบันทึกล่าสุด
- ขีด จํากัด การนําเข้ารายวัน - 250 MB ต่อวัน ขีดจํากัดจะรีเซ็ตทุกวัน
- การสุ่มตัวอย่าง - อาจสุ่มตัวอย่างบันทึกเพื่อลดปริมาตรในขณะที่รักษาการวิเคราะห์ที่ถูกต้องทางสถิติ
- ประเภทบันทึกที่รองรับ - ข้อมูล ข้อผิดพลาด คําเตือน และการติดตาม
สําหรับข้อมูลขีดจํากัดบริการทั้งหมด โปรดดู รายละเอียดและข้อจํากัดของบริการ
เนื้อหาที่เกี่ยวข้อง
- ทดสอบฟังก์ชันข้อมูลผู้ใช้ของคุณ - เรียนรู้วิธีทดสอบฟังก์ชันและดูบันทึกแบบเรียลไทม์ในแผงทดสอบ
- โมเดลการเขียนโปรแกรม Python - ทําความเข้าใจวิธีการเขียนโค้ดฟังก์ชันและใช้โมดูลการบันทึก
- รายละเอียดและข้อจํากัดของบริการ - ตรวจสอบการเก็บรักษาบันทึกและขีดจํากัดของบริการ
- บทช่วยสอน: เรียกใช้ฟังก์ชันข้อมูลผู้ใช้จากแอปพลิเคชัน Python - เรียนรู้วิธีเรียกใช้ฟังก์ชันและใช้รหัสการเรียกใช้