การค้นหาคำขอ

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

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

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

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

วัตถุประสงค์: ค้นหาคำขอที่อยู่เบื้องหลังคำถาม เช่น ใครเปลี่ยนแปลงบางอย่าง หรือเหตุใดบางอย่างจึงล้มเหลว

รูปที่ 1: แท็บ Logs: ตัวกรองด้านบน คำขอที่ตรงกันทางซ้าย และคำขอที่เลือกทางขวา

แท็บ Logs

• แถบตัวกรอง: ตัวกรองด้านบน พร้อม Live ปุ่มรีเฟรช และ ส่งออก CSV ทางขวา
• รายการ: คำขอที่ตรงกัน เรียงจากใหม่ล่าสุด ด้านบนรายการจะแสดง "Viewing logs for 1 organisation" (หรือจำนวนองค์กรที่คุณเห็นได้) แต่ละแถวแสดงรหัสสถานะ เมธอด ป้ายแหล่งที่มา วันที่และเวลา เอนด์พอยต์ ที่อยู่อีเมลของผู้ใช้ และเวลาตอบสนองเป็นมิลลิวินาที
• รายละเอียด: คำขอที่คุณเลือก ดูการอ่านรายการบันทึก

รายการจะโหลดคำขอเพิ่มเติมเมื่อคุณเลื่อนลง ที่ท้ายรายการจะแสดงจำนวนคำขอที่ตรงกัน เช่น "End of results · 5 logs"

กรองรายการ

1. คลิกตัวกรองในแถบตัวกรอง เช่น Endpoint
2. เลือกตัวเลือก หรือพิมพ์ค่า ตัวอย่างเช่น พิมพ์ /api/door-gate-access/* ใน Endpoint แล้วคลิก Apply
3. ตัวกรองจะแสดงค่าที่คุณเลือก และรายการจะอัปเดต เพิ่มตัวกรองอื่นเพื่อจำกัดรายการให้แคบลง: คำขอต้องตรงกับตัวกรองทุกตัวจึงจะปรากฏ
4. หากต้องการลบตัวกรองหนึ่งตัว ให้คลิก × บนตัวกรองนั้น หากต้องการลบทั้งหมด ให้คลิก Clear ซึ่งจะปรากฏเมื่อมีการตั้งค่าตัวกรองใดก็ตาม

รูปที่ 2: แถบตัวกรอง: Range, Email, IP, Endpoint, Org, สถานที่, Method และ Status ตามด้วย Live ปุ่มรีเฟรช และส่งออก CSV

Email และ IP ต้องใช้ค่าแบบเต็ม

Email และ IP ค้นหาได้เฉพาะค่าที่ตรงกันทุกตัวอักษร พิมพ์ที่อยู่อีเมลแบบเต็ม เช่น ruby.castellano@example.com หรือที่อยู่ IP แบบเต็ม การพิมพ์เพียงบางส่วนของที่อยู่ เช่น ruby หรือ 203.0.113 จะไม่พบผลลัพธ์ใด

หากต้องการค้นหาบุคคลโดยไม่ทราบที่อยู่แบบเต็ม ให้ใช้ Top Users บนแดชบอร์ด หรือเปิดคำขอรายการหนึ่งของบุคคลนั้นแล้วคัดลอกที่อยู่จากช่อง User

ช่วง

คลิก Range เพื่อเลือกระยะเวลาย้อนหลังที่ต้องการดู

• ค่าที่ตั้งไว้ล่วงหน้า: Last 15 minutes, Last hour, Last 12 hours, Last 24 hours, Last 7 days, Last 30 days และ Last 90 days
• วันที่: เลือกวันที่เริ่มต้นและวันที่สิ้นสุดบนปฏิทินสองเดือน แล้วคลิก Apply คลิก Cancel เพื่อปิดเมนูโดยไม่เปลี่ยนช่วงเวลา วันที่ที่เก่ากว่า 90 วันจะเลือกไม่ได้

หมายเหตุที่ด้านล่างของเมนูระบุระยะเวลาการเก็บบันทึก: "Audit logs are kept for 90 days. Full request and response payloads are kept for 7 days, after which a short preview remains. Need a longer history? Contact Support (additional charges apply)."

รูปที่ 3: Range: เลือกค่าที่ตั้งไว้ล่วงหน้าหรือวันที่บนปฏิทิน หมายเหตุแสดงระยะเวลาการเก็บบันทึก

เอนด์พอยต์และไวลด์การ์ด

เอนด์พอยต์คือพาธที่คำขอถูกส่งไป เช่น /api/door-gate-access/doors/front-entrance/unlock ซึ่งบอกให้ทราบว่าคำขอนั้นส่งไปยังส่วนใดของ Performance Hub

• หากไม่มี * ส่วนใดของพาธก็ตรงกันได้ ตัวอย่างเช่น unlock จะพบคำขอทุกรายการที่มีคำว่า "unlock" ในพาธ
• หากมี * ทุกส่วนที่อยู่ระหว่างเครื่องหมายดอกจันต้องปรากฏในพาธ ตัวอย่างเช่น /api/door-gate-access/* จะพบคำขอ Door & Gate Access ทุกรายการ และ /partner/v1/* จะพบคำขอทุกรายการจากการผสานรวมที่ใช้ Partner API

รูปที่ 4: Endpoint รองรับไวลด์การ์ด * เช่น คำขอเกี่ยวกับประตูทุกรายการ

รูปที่ 5: รายการหลังจากกรองด้วยรูปแบบเอนด์พอยต์

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

สถานะ

คลิก Status เพื่อกรองตามสถานะการตอบกลับ พิมพ์ใน Search… เพื่อค้นหาสถานะอย่างรวดเร็ว เช่น "403" เลือก Any เพื่อแสดงทุกสถานะ

สถานะจะแสดงพร้อมชื่อ เช่น 200 OK, 201 Created, 400 Bad Request, 401 Unauthorised, 403 Forbidden, 404 Not Found, 409 Conflict, 429 Too Many Requests, 500 Server Error และ 503 Service Unavailable ดูความหมายได้ที่รหัสสถานะ

รูปที่ 6: กรองตามสถานะการตอบกลับ

Live และการรีเฟรช

ในแท็บ Logs ค่าเริ่มต้นของ Live คือ Off รายการจึงไม่เปลี่ยนแปลงขณะที่คุณตรวจสอบ เปิดใช้งานและเลือกความถี่ในการรีเฟรชรายการเพื่อดูคำขอใหม่ที่เข้ามา คลิกปุ่มรีเฟรช (ลูกศรวงกลม) เพื่อโหลดรายการใหม่หนึ่งครั้ง

แชร์หรือบุ๊กมาร์กมุมมองที่กรองแล้ว

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

ตัวอย่างเช่น ที่อยู่ที่ลงท้ายด้วย /audit-logs/logs?email=priya.shah%40example.com จะเปิดรายการที่กรองเฉพาะบุคคลนั้น และที่อยู่ที่ลงท้ายด้วย /audit-logs/logs?endpoint=%2Fapi%2Fdoor-gate-access%2F* จะเปิดคำขอเกี่ยวกับประตูทุกรายการ

การเลื่อนดูรายการ

• คลิกคำขอเพื่อเปิดรายละเอียดทางขวา
• ใช้ปุ่มลูกศร ขึ้น และ ลง เพื่อไปยังคำขอก่อนหน้าหรือถัดไปในรายการ
• บนหน้าจอแคบ รายละเอียดจะเปิดซ้อนทับรายการ คลิกปุ่มปิดเพื่อกลับไปยังรายการ

ไม่มีผลลัพธ์

หากไม่มีรายการที่ตรงกัน รายการจะแสดงข้อความ "No logs match these filters" และ "Try widening the time range or clearing a filter."

รูปที่ 7: ไม่มีคำขอที่ตรงกัน: ขยายช่วงเวลาหรือล้างตัวกรอง

วิธีค้นหาสิ่งที่คุณต้องการ:

• เลือก Range ที่ยาวขึ้น เช่น Last 7 days
• ตรวจสอบว่า Email และ IP มีที่อยู่แบบเต็ม การพิมพ์เพียงบางส่วนจะไม่พบผลลัพธ์ใด
• ลบตัวกรองทีละตัวด้วย × หรือคลิก Clear

หน้าที่เกี่ยวข้อง

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