บันทึก: การบิลด์และคำขอเข้าเว็บไซต์ของคุณ
บันทึกบอกคุณว่าเกิดอะไรขึ้นและเมื่อใด ทั้งการสร้างและการเผยแพร่ทุกครั้งของโปรเจกต์ และทุกคำขอที่รันโค้ดของเว็บไซต์เองในช่วงหนึ่งวันที่ผ่านมา ใช้บันทึกเพื่อหาสาเหตุที่แบบฟอร์ม งานตามกำหนดเวลา หรือหน้าใดหน้าหนึ่งทำงานไม่ถูกต้อง
บันทึกสองประเภท
| ดู | สิ่งที่แสดง | ย้อนหลังไปนานเท่าไร |
|---|---|---|
| Builds | ทุกการสร้าง การเปลี่ยนแปลง และการเผยแพร่ในโปรเจกต์นี้ พร้อมขั้นตอนที่แต่ละรายการผ่านมา | 40 รายการล่าสุด |
| Requests | คำขอและข้อผิดพลาดของเว็บไซต์ เรียงจากใหม่สุด | 24 ชั่วโมงที่ผ่านมา ครั้งละไม่เกิน 100 รายการ |
งานตามกำหนดเวลาและ webhook มีบันทึกของตัวเองเก็บไว้สามสิบวัน: Runs ใน งานตามกำหนดเวลา และ Deliveries ใน Webhooks ข้อความที่ส่งผ่านฟอร์มของคุณเก็บไว้ที่ Settings, Forms
การสร้าง
แต่ละรายการบอกว่ามีการร้องขออะไร (ตามถ้อยคำของคำขอ) ใครเป็นผู้ขอ เมื่อใด และใช้เวลานานเท่าใด หากไม่มีบุคคลใดเริ่ม จะระบุว่า Briks ทางขวาคือสถานะของรายการ:
| สถานะ | ความหมาย |
|---|---|
| Waiting | รอคิวหลังงานอื่น |
| Running | กำลังดำเนินการอยู่ตอนนี้ |
| Done | เสร็จสิ้น |
| Failed | การทำงานหยุดก่อนถึงตอนจบ |
| Stopped | ถูกหยุดก่อนที่จะเสร็จสิ้น |
คลิกรายการเพื่อดูขั้นตอน พร้อมเวลาที่เกิดขึ้นในแต่ละขั้นตอน ขั้นตอนที่เกิดข้อผิดพลาดจะแสดงเป็นสีแดง รายการที่ล้มเหลวจะลงท้ายด้วย: It did not finish. Nothing on the live site changed, and no credits were charged for it.
หากต้องการดูงานเดียวกันนี้ขณะที่กำลังทำ โดยมีพรีวิวอยู่ข้างกัน ให้ใช้สตูดิโอ: ดู การดูขั้นตอนการสร้าง
คำขอ
Requests แสดงการเรียกที่รันโค้ดของเว็บไซต์คุณเอง ได้แก่เส้นทาง /api และการเข้าชมหน้าเว็บขณะที่การทดสอบ A/B แบ่งผู้เข้าชมออกเป็นสองเวอร์ชัน หน้าเว็บทั่วไป รูปภาพ และไฟล์จะถูกส่งออกไปตามที่เป็นอยู่ จึงไม่แสดงในรายการนี้ ข้อความที่ส่งผ่านแบบฟอร์มติดต่อก็ไม่แสดงเช่นกัน เพราะข้อความเหล่านี้ไปถึง Briks โดยตรง ไม่ได้ผ่านโค้ดของเว็บไซต์คุณ
แต่ละบรรทัดแสดงเวลา เมธอดและพาธ (GET คือการขอข้อมูล POST คือการส่งข้อมูล) เวลาที่ใช้เป็นมิลลิวินาที และสถานะที่เว็บไซต์ตอบกลับ หรือไม่มีการตอบกลับ บรรทัดที่โค้ดของเว็บไซต์คุณเขียนขึ้นเองจะแสดงข้อความและระดับ เช่น error หรือ warning คลิกที่บรรทัดเพื่อดูข้อความฉบับเต็ม วันที่ และไอดีของคำขอ
| สถานะ | ความหมาย |
|---|---|
| 2xx เช่น 200 | สำเร็จแล้ว |
| 4xx เช่น 400 หรือ 404 | คำขอถูกปฏิเสธ: มีบางอย่างขาดหายหรือไม่ถูกต้องในคำขอ หรือไม่มีสิ่งใดอยู่ที่เส้นทางนั้น |
| 5xx เช่น 500 | โค้ดของเว็บไซต์ล้มเหลวขณะตอบกลับ |
ตัวกรอง
| ตัวกรอง | ตัวเลือก | ใช้เพื่อ |
|---|---|---|
| Search | คำใดก็ได้: เส้นทาง ข้อความ หรือรหัสคำขอ | ค้นหาเส้นทางเดียวหรือข้อผิดพลาดเดียว |
| Level | All levels, Errors, Warnings | แสดงเฉพาะปัญหาที่โค้ดรายงานมา |
| Status | Any status, Succeeded, 4xx, 5xx | แสดงเฉพาะคำขอที่ถูกปฏิเสธหรือล้มเหลว |
ตั้งค่าแล้วกด Show ที่อยู่ของหน้าจะเก็บค่าเหล่านั้นไว้ จึงบุ๊กมาร์กมุมมองที่กรองแล้วได้ No requests in the last day หมายความว่าไม่มีสิ่งใดรันโค้ดของเว็บไซต์ในรอบ 24 ชั่วโมง หากหน้าแสดง Logs cannot be read right now ให้ลองอีกครั้งในอีกหนึ่งนาที
วินิจฉัยแบบฟอร์มที่ใช้งานไม่ได้
มองหารายการ
ที่ไหน: Settings, Forms
ข้อความทุกข้อความที่ผู้เข้าชมส่งมาจะถูกเก็บไว้ที่นี่ โดยแสดง 100 รายการล่าสุดบนหน้าจอ แต่ละรายการแสดงเวลาที่ส่งมาและมาจากหน้าใด จากนั้นเป็น emailed, not emailed หรือ preview
หากขึ้นว่าพรีวิว
ที่ไหน: Settings, Forms
ยังไม่ได้เผยแพร่เว็บไซต์เป็นเวอร์ชันใช้งานจริง ข้อมูลที่ส่งเข้ามาจึงถูกเก็บไว้แต่ไม่ส่งทางอีเมล ดูได้ที่ เผยแพร่เป็นเวอร์ชันใช้งานจริง
หากแสดงว่าส่งอีเมลแล้วแต่ไม่มีอะไรมาถึง
ที่ไหน: Your inbox
ข้อมูลที่ส่งเข้ามาจะไปถึงผู้ที่สร้างโปรเจกต์ หรือถึง Owner คนแรกของเวิร์กสเปซ หากผู้สร้างได้ออกไปแล้ว โปรดตรวจสอบกล่องจดหมายนั้น รวมถึงโฟลเดอร์สแปมด้วย
ถ้าไม่มีอยู่เลย
ที่ไหน: The live site
ข้อความไม่ถึง Briks ลองส่งข้อความด้วยตัวเอง หากฟอร์มตอบว่าส่งข้อความจากที่นี่มากเกินไป แสดงว่าถึงขีดจำกัดแล้ว: ได้สูงสุด 5 ข้อความต่อผู้เยี่ยมชมหนึ่งคนใน 10 นาที และสูงสุด 300 ข้อความต่อวันสำหรับเว็บไซต์
หากเครื่องมืออื่นควรได้รับสิ่งนี้
ที่ไหน: Settings, Webhooks, Deliveries
ตั้ง Status เป็น Failed แล้วกด Show เปิดรายการส่งเพื่ออ่านสิ่งที่เครื่องมืออีกฝั่งตอบกลับ จากนั้นกด Send again เมื่อแก้ไขแล้ว
วิเคราะห์งานตามกำหนดเวลาที่ล้มเหลว
อ่านการรัน
ที่ไหน: Settings, Scheduled tasks, Runs
เปิดการรันที่ล้มเหลว จะเห็นสิ่งที่ที่อยู่นั้นตอบกลับ เช่น ตอบ 500 และส่วนต้นของคำตอบ
หาข้อผิดพลาด
ที่ไหน: Settings, Logs, Requests
หากงานเรียกเส้นทางบนเว็บไซต์ของคุณ ให้ค้นหาพาธของเส้นทางนั้น เช่น
/api/daily-summaryแล้วตั้ง Level เป็น Errors ข้อความจะบอกว่าโค้ดผิดพลาดตรงไหนขอให้แก้ไข
ที่ไหน: Studio
วางข้อผิดพลาดลงในแชตของสตูดิโอพร้อมประโยคเกี่ยวกับงานนั้น: เส้นทางสรุปประจำวันล้มเหลวด้วยข้อผิดพลาดนี้ทุกเช้า ดู การแก้ไข
ลองอีกครั้ง
ที่ไหน: Settings, Scheduled tasks
หลังจากเผยแพร่การแก้ไขแล้ว ให้เปิดจุดสามจุดของงานแล้วเลือก Run now ผลลัพธ์จะแสดงทันที
การรันที่ถูกทำเครื่องหมาย Skipped ไม่ได้ล้มเหลว: การเรียกของโปรเจกต์ในวันนั้นถูกใช้หมดแล้ว การรันจะเริ่มอีกครั้งหลังเที่ยงคืน UTC ขีดจำกัดของแพ็กเกจอยู่ในหน้า งานตามกำหนดเวลา
วินิจฉัยหน้าเว็บที่โหลดช้า
Requests จับเวลาทุกอย่างที่รันโค้ดของเว็บไซต์ จึงเป็นที่ที่ควรดูเมื่อหน้าที่โหลดเนื้อหาจากเส้นทางของเว็บไซต์ช้า แอปและแดชบอร์ดมักทำงานแบบนี้
เปิดหน้าและจดเวลาไว้
ที่ไหน: The live site
โหลดหน้าที่ช้าด้วยตัวเองหนึ่งครั้ง เพื่อให้คำขอของหน้านั้นอยู่ในกลุ่มล่าสุด
ดูช่วงเวลา
ที่ไหน: Settings, Logs, Requests
ดูมิลลิวินาทีข้างแต่ละคำขอที่เกิดขึ้นในเวลานั้น หากเส้นทางหนึ่งใช้เวลาหลายวินาทีขณะที่เส้นทางอื่นใช้เพียงไม่กี่ร้อยมิลลิวินาที เส้นทางนั้นคือสาเหตุ
จำกัดให้แคบลง
ที่ไหน: Settings, Logs, Requests
ค้นหาเส้นทางของ route นั้นเพื่อดูว่าช้าตลอดหรือช้าเป็นบางครั้ง และมี Warnings หรือ Errors ปรากฏข้างกันหรือไม่
ขอให้แก้ไข
ที่ไหน: Studio
บอกสตูดิโอว่าเส้นทางไหนช้าและช้าแค่ไหน พร้อมหน้าที่เส้นทางนั้นให้บริการ
หากไม่พบสิ่งที่ช้า ความล่าช้าไม่ได้อยู่ในโค้ดของเว็บไซต์คุณ หน้า รูปภาพ และไฟล์ถูกส่งไปตามที่เป็นอยู่ จึงควรดูสิ่งที่หน้านั้นมี เช่น รูปภาพขนาดใหญ่หรือวิดีโอ แล้วอธิบายในสตูดิโอว่าส่วนไหนรู้สึกช้า
ตัวอย่างจริง: แอปจองที่หยุดบันทึกข้อมูล
ไม่มีการจองใหม่เข้ามาตั้งแต่เช้า ทั้งที่โทรศัพท์ดังไม่หยุดจากคนที่บอกว่าแบบฟอร์มไม่ทำงาน
ใน Requests เมื่อตั้ง Status เป็น 5xx ทุก POST /api/bookings ตั้งแต่ 9:12 ตอบกลับ 500 บรรทัดข้อผิดพลาดที่อยู่ข้างกันระบุว่าขาดช่องที่จำเป็น
ตั้งแต่เช้านี้ ทุกการจองล้มเหลวด้วยข้อผิดพลาด 500 ที่ /api/bookings ล็อกระบุว่าไม่พบช่องขนาดสัตว์เลี้ยง เราลบช่องนั้นออกจากฟอร์มเมื่อวานนี้
เผยแพร่การเปลี่ยนแปลงแล้ว และการจองถัดไปใน Requests ตอบกลับ 200