Nhật ký kiểm toán

Nhật ký kiểm toán là bản ghi các yêu cầu được gửi đến Performance Hub trong tổ chức của bạn. Bản ghi này bao gồm các yêu cầu từ những người sử dụng Performance Hub trên trình duyệt hoặc ứng dụng, và từ các công cụ được kết nối như khóa API, AI agent được kết nối qua MCP và Model Router. Sử dụng tính năng này để trả lời các câu hỏi như ai đã mở khóa một cánh cửa, tại sao một thay đổi không được lưu hoặc khi nào một tích hợp ngừng hoạt động, dù địa điểm của bạn là văn phòng, cửa hàng, quán cà phê, địa điểm tổ chức sự kiện, phòng khám, khuôn viên trường hay phòng tập.

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

Đố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: Xem ai đã làm gì trong Performance Hub và tìm hiểu lý do một yêu cầu thất bại

Hình 1: Bảng điều khiển Nhật ký kiểm toán: khoảng thời gian, các số liệu chính và dòng thời gian yêu cầu

Những gì được ghi lại

Mỗi mục nhật ký là một yêu cầu được gửi đến Performance Hub. Mục nhật ký hiển thị:

• Ai đã gửi yêu cầu: địa chỉ email của người dùng.
• Từ đâu: địa chỉ IP, và trình duyệt hoặc công cụ đã gửi yêu cầu.
• Nội dung được gọi: phương thức (ví dụ GET để đọc hoặc POST để tạo) và endpoint, tức là phần của Performance Hub mà yêu cầu hướng đến, chẳng hạn /api/door-gate-access/doors/front-entrance/unlock.
• Kết quả: trạng thái phản hồi, ví dụ 200 khi thành công hoặc 403 khi người dùng không có quyền.
• Thời gian xử lý, tính bằng mili giây.
• Nguồn gốc: huy hiệu nguồn, chẳng hạn web cho người dùng Performance Hub hoặc api-key cho một tích hợp. Xem Huy hiệu nguồn.

Đối với các yêu cầu gần đây, mục nhật ký còn lưu nội dung đã gửi và nội dung được trả về. Xem Đọc một mục nhật ký.

Hai tab

Ai có thể sử dụng Nhật ký kiểm toán

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. Nếu bạn không thấy Nhật ký kiểm toán trong menu cài đặt, vai trò của bạn không bao gồm mô-đun này.

• Những tổ chức bạn thấy: các tổ chức mà vai trò của bạn bao gồm cả Nhật ký kiểm toán lẫn Identity & Access Management. Tab Logs cho biết số lượng, ví dụ "Viewing logs for 1 organisation".
• Mẫu vai trò: mẫu Organisation Administrator bao gồm Nhật ký kiểm toán. Các mẫu Site Manager và Site Owner không bao gồm mô-đun này. Xem Mẫu vai trò.
• Vai trò tùy chỉnh: để cho phép một vai trò tùy chỉnh sử dụng Nhật ký kiểm toán, hãy thêm cả Nhật ký kiểm toán lẫn Identity & Access Management vào phần truy cập mô-đun của vai trò đó. Xem Phạm vi truy cập và truy cập mô-đun.

Nhật ký kiểm toán hiển thị địa chỉ email, địa chỉ IP và nội dung mọi người đã gửi, vì vậy chỉ cấp quyền cho những người thực sự cần.

Thời gian lưu giữ nhật ký

Chính sách lưu giữ nhật ký kiểm toán quy định thời gian lưu giữ nhật ký kiểm toán: 90 ngày cho mỗi mục nhật ký và 7 ngày cho toàn bộ nội dung yêu cầu và phản hồi của mục đó.

Menu Range trên tab Logs ghi:

"Nhật ký kiểm toán được lưu giữ trong 90 ngày. Các payload yêu cầu và phản hồi đầy đủ được lưu giữ trong 7 ngày, sau đó chỉ còn lại bản xem trước ngắn gọn. Cần lịch sử lâu hơn? Hãy liên hệ với bộ phận Hỗ trợ (có thể áp dụng phí bổ sung)."

Như vậy, bạn có thể xem lại 90 ngày trước. Trong 7 ngày đầu, mục nhật ký lưu toàn bộ yêu cầu và phản hồi. Sau đó, các nội dung dài hơn sẽ được cắt ngắn thành bản xem trước. Xem Sau 7 ngày: bản xem trước.

Những việc bạn có thể làm

• Đọc bảng điều khiển: xem lưu lượng yêu cầu, tỷ lệ lỗi và các endpoint cũng như người dùng có nhiều yêu cầu nhất trong một khoảng thời gian.
• Tìm yêu cầu: lọc theo khoảng thời gian, địa chỉ email, địa chỉ IP, endpoint, tổ chức, cơ sở, phương thức và trạng thái, và chia sẻ chế độ xem đã lọc.
• Đọc một mục nhật ký: xem ai đã gửi yêu cầu, từ đâu, và nội dung đã gửi và được trả về. Đối với yêu cầu thất bại, nhận bản tóm tắt lỗi bằng ngôn ngữ dễ hiểu.
• Xuất nhật ký: tải xuống các nhật ký đã tải dưới dạng tệp CSV.
• Xem ví dụ điều tra: câu trả lời từng bước cho các câu hỏi thường gặp, chẳng hạn ai đã mở khóa một cánh cửa hoặc tại sao một tích hợp ngừng đồng bộ.
• Câu hỏi thường gặp

Trang liên quan

• Mẫu vai trò: những mẫu nào bao gồm Nhật ký kiểm toán
• Phạm vi truy cập và truy cập mô-đun: cấp Nhật ký kiểm toán cho một vai trò tùy chỉnh
• Door & Gate Access: Nhật ký truy cập: bản ghi riêng biệt về mọi lần thử mở khóa cửa ra vào và cổng