บันทึกการตรวจสอบ

ในหน้านี้

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

ข้อมูลอ้างอิงโดยย่อ

ตำแหน่งที่พบ: Settings (ไอคอนรูปเฟือง มุมซ้ายล่าง) → บันทึกการตรวจสอบ

ผู้ที่ใช้งานได้: คุณต้องมีบทบาทที่รวมบันทึกการตรวจสอบและ Identity & Access Management ในองค์กรของคุณ เช่น Organisation Administrator ดูใครใช้บันทึกการตรวจสอบได้บ้าง

วัตถุประสงค์: ดูว่าใครทำอะไรใน Performance Hub และค้นหาสาเหตุที่คำขอล้มเหลว

แดชบอร์ดบันทึกการตรวจสอบ พร้อมปุ่ม Window ตัวเลขสำคัญห้ารายการ และแผนภูมิ Request Timelineแดชบอร์ดบันทึกการตรวจสอบ พร้อมปุ่ม Window ตัวเลขสำคัญห้ารายการ และแผนภูมิ Request Timeline

รูปที่ 1: แดชบอร์ดบันทึกการตรวจสอบ: ช่วงเวลา ตัวเลขสำคัญ และไทม์ไลน์คำขอ

สิ่งที่ถูกบันทึก

รายการบันทึกแต่ละรายการคือคำขอหนึ่งรายการที่ส่งไปยัง Performance Hub โดยแสดง:

  • ผู้ที่ส่งคำขอ: ที่อยู่อีเมลของผู้ใช้
  • ส่งมาจากที่ใด: ที่อยู่ IP และเบราว์เซอร์หรือเครื่องมือที่ส่งคำขอ
  • สิ่งที่ถูกเรียกใช้: เมธอด (เช่น GET สำหรับอ่าน หรือ POST สำหรับสร้าง) และเอนด์พอยต์ ซึ่งเป็นส่วนของ Performance Hub ที่คำขอนั้นส่งไปถึง เช่น /api/door-gate-access/doors/front-entrance/unlock
  • ผลลัพธ์: สถานะการตอบกลับ เช่น 200 สำหรับความสำเร็จ หรือ 403 เมื่อบุคคลนั้นไม่มีสิทธิ์
  • ระยะเวลาที่ใช้ เป็นมิลลิวินาที
  • แหล่งที่มา: ป้ายแหล่งที่มา เช่น web สำหรับบุคคลที่ใช้ Performance Hub หรือ api-key สำหรับการผสานรวม ดูป้ายแหล่งที่มา

สำหรับคำขอล่าสุด รายการบันทึกจะเก็บสิ่งที่ส่งไปและสิ่งที่ได้รับกลับมาด้วย ดูการอ่านรายการบันทึก

แท็บทั้งสอง

แท็บใช้ทำอะไร
Dashboardยอดรวม อัตราข้อผิดพลาด และแผนภูมิสำหรับช่วงเวลาที่เลือก พร้อมเอนด์พอยต์และผู้ใช้ที่มีคำขอมากที่สุด คลิกแผนภูมิหรือแถวเพื่อเปิดบันทึกที่ตรงกัน
Logsตัวคำขอเอง กรองและค้นหารายการ เปิดรายการบันทึกเพื่อดูรายละเอียด และส่งออกเป็น CSV

ใครใช้บันทึกการตรวจสอบได้บ้าง

คุณต้องมีบทบาทที่รวมบันทึกการตรวจสอบและ Identity & Access Management ในองค์กรของคุณ เช่น Organisation Administrator หากคุณไม่เห็น บันทึกการตรวจสอบ ในเมนูการตั้งค่า แสดงว่าบทบาทของคุณไม่ได้รวมไว้

  • องค์กรที่คุณเห็น: องค์กรที่บทบาทของคุณรวมทั้งบันทึกการตรวจสอบและ Identity & Access Management แท็บ Logs จะแสดงจำนวนองค์กร เช่น "Viewing logs for 1 organisation"
  • เทมเพลตบทบาท: เทมเพลต Organisation Administrator รวมบันทึกการตรวจสอบไว้ ส่วนเทมเพลต Site Manager และ Site Owner ไม่ได้รวมไว้ ดูเทมเพลตบทบาท
  • บทบาทที่กำหนดเอง: หากต้องการให้บทบาทที่กำหนดเองใช้บันทึกการตรวจสอบได้ ให้รวมทั้งบันทึกการตรวจสอบและ Identity & Access Management ไว้ในการเข้าถึงโมดูลของบทบาทนั้น ดูขอบเขตการเข้าถึงและการเข้าถึงโมดูล

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

ระยะเวลาการเก็บบันทึก

การเก็บรักษาบันทึกการตรวจสอบกำหนดระยะเวลาที่บันทึกการตรวจสอบจะถูกเก็บไว้ คือ 90 วันสำหรับรายการบันทึกแต่ละรายการ และ 7 วันสำหรับเพย์โหลดคำขอและการตอบกลับฉบับเต็ม

เมนู Range ในแท็บ Logs ระบุว่า:

"บันทึกการตรวจสอบจะถูกเก็บไว้เป็นเวลา 90 วัน ส่วนเพย์โหลดคำขอและคำตอบแบบเต็มจะถูกเก็บไว้เป็นเวลา 7 วัน หลังจากนั้นจะเหลือเพียงตัวอย่างสั้นๆ ต้องการประวัติที่ยาวนานกว่านี้ใช่ไหม ติดต่อฝ่ายสนับสนุน (มีค่าใช้จ่ายเพิ่มเติม)"

ดังนั้นคุณจึงดูย้อนหลังได้ 90 วัน ในช่วง 7 วันแรก รายการบันทึกจะเก็บคำขอและการตอบกลับฉบับเต็ม หลังจากนั้น เนื้อหาที่ยาวกว่าจะถูกตัดให้เหลือเพียงตัวอย่างสั้น ๆ ดูหลังจาก 7 วัน: ตัวอย่าง

สิ่งที่คุณทำได้

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