Tìm yêu cầu

Trên trang này

Tab Logs liệt kê các yêu cầu được thực hiện trong tổ chức của bạn, mới nhất trước. Sử dụng các bộ lọc ở phía trên để thu hẹp danh sách xuống một người, một địa chỉ IP, một phần của Performance Hub hoặc một loại kết quả, sau đó nhấp vào một yêu cầu để xem chi tiết.

Tham khảo nhanh

Vị trí: Settings (biểu tượng bánh răng, góc dưới bên trái) → Nhật ký kiểm toán → Logs

Đối tượng: Bạn cần một vai trò bao gồm Nhật ký kiểm toán và Identity & Access Management trong tổ chức của bạn, chẳng hạn Organisation Administrator. Xem Ai có thể sử dụng Nhật ký kiểm toán.

Mục đích: Tìm các yêu cầu đằng sau một câu hỏi, chẳng hạn ai đã thay đổi một nội dung hoặc tại sao một thao tác thất bại

Tab Logs, với thanh bộ lọc ở phía trên, danh sách yêu cầu ở bên trái và chi tiết của yêu cầu đã chọn ở bên phải

Hình 1: Tab Logs: các bộ lọc ở phía trên, các yêu cầu khớp ở bên trái và yêu cầu đã chọn ở bên phải

Tab Logs

Thanh bộ lọc: các bộ lọc ở phía trên, với Live, nút làm mới và Xuất CSV ở bên phải.
Danh sách: các yêu cầu khớp, mới nhất trước. Phía trên danh sách là dòng "Viewing logs for 1 organisation" (hoặc số tổ chức mà bạn có thể xem). Mỗi hàng hiển thị mã trạng thái, phương thức, huy hiệu nguồn, ngày và giờ, endpoint, địa chỉ email của người dùng và thời gian phản hồi tính bằng mili giây.
Chi tiết: yêu cầu bạn đã chọn. Xem Đọc một mục nhật ký.

Danh sách tải thêm yêu cầu khi bạn cuộn. Ở cuối danh sách, hệ thống hiển thị số yêu cầu khớp, ví dụ "End of results · 5 logs".

Lọc danh sách

Nhấp vào một bộ lọc trên thanh bộ lọc, ví dụ Endpoint.
Chọn một tùy chọn hoặc nhập một giá trị. Ví dụ: nhập /api/door-gate-access/* vào Endpoint và nhấp Apply.
Bộ lọc hiển thị giá trị bạn đã chọn và danh sách được cập nhật. Thêm bộ lọc khác để thu hẹp thêm: một yêu cầu phải khớp với mọi bộ lọc mới được hiển thị.
Để xóa một bộ lọc, nhấp vào dấu × trên bộ lọc đó. Để xóa tất cả, nhấp Clear, nút này xuất hiện khi có bất kỳ bộ lọc nào được đặt.

Hình 2: Thanh bộ lọc: Range, Email, IP, Endpoint, Org, Cơ sở, Method và Status, tiếp theo là Live, nút làm mới và Xuất CSV

Bộ lọc	Nội dung khớp
Range	Thời điểm yêu cầu được thực hiện. Mặc định là Last 24 hours. Xem Range.
Email	Địa chỉ email đầy đủ của người dùng, ví dụ `priya.shah@example.com`. Bộ lọc có thể gợi ý địa chỉ khi bạn nhập.
IP	Địa chỉ IP đầy đủ mà yêu cầu được gửi từ đó, ví dụ `203.0.113.140`
Endpoint	Phần của Performance Hub mà yêu cầu hướng đến. Bất kỳ phần nào của đường dẫn đều khớp, và bạn có thể dùng ký tự đại diện `*`. Xem Endpoint và ký tự đại diện.
Org	Một tổ chức, hoặc Any org. Hiển thị khi bạn có quyền truy cập ít nhất một tổ chức.
Cơ sở	Một cơ sở, hoặc Bất kỳ cơ sở nào. Hiển thị khi bạn có quyền truy cập ít nhất một cơ sở.
Method	GET, POST, PUT, PATCH hoặc DELETE
Status	Trạng thái phản hồi. Xem Status.

Email và IP cần giá trị đầy đủ

Email và IP chỉ tìm các kết quả khớp chính xác. Nhập toàn bộ địa chỉ email, chẳng hạn ruby.castellano@example.com, hoặc toàn bộ địa chỉ IP. Một phần của địa chỉ, chẳng hạn ruby hoặc 203.0.113, sẽ không tìm thấy gì.

Để tìm một người khi không có địa chỉ đầy đủ, hãy dùng Top Users trên bảng điều khiển, hoặc mở một trong các yêu cầu của người đó và sao chép địa chỉ từ trường User.

Khoảng thời gian

Nhấp Range để chọn khoảng thời gian cần xem lại.

Giá trị đặt sẵn: Last 15 minutes, Last hour, Last 12 hours, Last 24 hours, Last 7 days, Last 30 days và Last 90 days.
Ngày: chọn ngày bắt đầu và ngày kết thúc trên lịch hai tháng, sau đó nhấp Apply. Nhấp Cancel để đóng menu mà không thay đổi khoảng thời gian. Không thể chọn các ngày cách đây hơn 90 ngày.

Ghi chú ở cuối menu cho biết thời gian lưu giữ nhật ký: "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)."

Hình 3: Range: chọn một giá trị đặt sẵn hoặc chọn ngày trên lịch. Ghi chú cho biết thời gian lưu giữ nhật ký

Endpoint và ký tự đại diện

Endpoint là đường dẫn mà yêu cầu được gửi đến, chẳng hạn /api/door-gate-access/doors/front-entrance/unlock. Endpoint cho bạn biết yêu cầu hướng đến phần nào của Performance Hub.

Không có *, bất kỳ phần nào của đường dẫn đều khớp. Ví dụ: unlock tìm mọi yêu cầu có "unlock" trong đường dẫn.
Có *, mọi đoạn nằm giữa các dấu sao phải xuất hiện trong đường dẫn. Ví dụ: /api/door-gate-access/* tìm mọi yêu cầu Door & Gate Access, và /partner/v1/* tìm mọi yêu cầu từ một tích hợp sử dụng Partner API.

Bộ lọc Endpoint đang mở, với /api/door-gate-access/* đã được nhập cùng các nút Cancel và Apply

Hình 4: Endpoint chấp nhận ký tự đại diện *, ví dụ để tìm mọi yêu cầu liên quan đến cửa

Tab Logs được lọc theo /api/door-gate-access/*, liệt kê năm yêu cầu liên quan đến cửa với yêu cầu đầu tiên đang mở

Hình 5: Danh sách sau khi lọc theo mẫu endpoint

Không chắc nên dùng endpoint nào? Hãy mở một yêu cầu mà bạn biết, chẳng hạn một cánh cửa do chính bạn mở khóa, và sao chép phần đầu endpoint của yêu cầu đó từ phần chi tiết.

Trạng thái

Nhấp Status để lọc theo trạng thái phản hồi. Nhập vào Search… để tìm nhanh một trạng thái, ví dụ "403". Chọn Any để hiển thị mọi trạng thái.

Các trạng thái được liệt kê kèm tên, chẳng hạn 200 OK, 201 Created, 400 Bad Request, 401 Unauthorised, 403 Forbidden, 404 Not Found, 409 Conflict, 429 Too Many Requests, 500 Server Error và 503 Service Unavailable. Xem Mã trạng thái để biết ý nghĩa của từng mã.

Hình 6: Lọc theo trạng thái phản hồi

Live và làm mới

Trên tab Logs, Live mặc định ở trạng thái Off, vì vậy danh sách giữ nguyên trong khi bạn điều tra. Bật tính năng này và chọn tần suất làm mới danh sách để theo dõi các yêu cầu mới đến. Nhấp vào nút làm mới (hai mũi tên vòng tròn) để tải lại danh sách một lần.

Các bộ lọc của bạn được lưu trong địa chỉ trang. Đánh dấu trang để quay lại cùng chế độ xem, hoặc gửi địa chỉ cho đồng nghiệp. Họ sẽ thấy cùng danh sách đã lọc nếu có quyền truy cập Nhật ký kiểm toán và cùng tổ chức.

Ví dụ: một địa chỉ kết thúc bằng /audit-logs/logs?email=priya.shah%40example.com mở danh sách được lọc theo người đó, và một địa chỉ kết thúc bằng /audit-logs/logs?endpoint=%2Fapi%2Fdoor-gate-access%2F* mở mọi yêu cầu liên quan đến cửa.

Di chuyển trong danh sách

Nhấp vào một yêu cầu để mở chi tiết ở bên phải.
Dùng phím mũi tên lên và xuống để chuyển đến yêu cầu trước hoặc tiếp theo trong danh sách.
Trên màn hình hẹp, phần chi tiết mở đè lên danh sách. Nhấp nút đóng để quay lại danh sách.

Không có kết quả

Nếu không có kết quả nào khớp, danh sách hiển thị "No logs match these filters" và "Try widening the time range or clearing a filter."

Tab Logs với bộ lọc Email đã được đặt, hiển thị No logs match these filters

Hình 7: Không có yêu cầu nào khớp: mở rộng khoảng thời gian hoặc xóa một bộ lọc

Để tìm nội dung bạn cần:

Chọn một Range dài hơn, chẳng hạn Last 7 days.
Kiểm tra để chắc chắn Email và IP chứa địa chỉ đầy đủ. Một phần của địa chỉ sẽ không tìm thấy gì.
Xóa từng bộ lọc bằng dấu × của bộ lọc đó, hoặc nhấp Clear.

Đọc một mục nhật ký: nội dung hiển thị của mỗi yêu cầu
Xuất nhật ký: tải danh sách xuống dưới dạng tệp CSV
Ví dụ điều tra: bộ lọc cho các câu hỏi thường gặp
Bảng điều khiển: nhấp vào một biểu đồ để mở các nhật ký tương ứng