Đọc một mục nhật ký

Trên trang này

Nhấp vào một yêu cầu trong danh sách trên tab Logs để mở chi tiết của yêu cầu đó ở bên phải. Phần chi tiết cho biết yêu cầu được thực hiện khi nào, ai đã gửi và từ đâu, nội dung nào đã được gửi và nội dung nào được trả về. Đối với yêu cầu thất bại, bạn cũng có thể yêu cầu bản tóm tắt lỗi bằng ngôn ngữ dễ hiểu.

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, sau đó nhấp vào một yêu cầu

Đố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 chính xác những gì đã xảy ra trong một yêu cầu

Mở một mục nhật ký

  1. Trên tab Logs, lọc danh sách để chỉ còn các yêu cầu bạn cần.
  2. Nhấp vào một yêu cầu. Chi tiết của yêu cầu mở ra ở bên phải và yêu cầu được đánh dấu trong danh sách.
  3. Dùng phím mũi tên lên và xuống để duyệt qua danh sách mà không rời khỏi phần chi tiết.

Phần đầu của chi tiết nhắc lại trạng thái, phương thức, huy hiệu nguồn và endpoint.

Chi tiết của một mục nhật ký: dấu thời gian, thời gian phản hồi, ID yêu cầu, địa chỉ IP, người dùng, referer, user agent, cơ sở và tổ chức, tiếp theo là nội dung yêu cầu và phản hồiChi tiết của một mục nhật ký: dấu thời gian, thời gian phản hồi, ID yêu cầu, địa chỉ IP, người dùng, referer, user agent, cơ sở và tổ chức, tiếp theo là nội dung yêu cầu và phản hồi

Hình 1: Một mục nhật ký: thời điểm diễn ra, người gửi, nguồn gửi, cùng nội dung yêu cầu và phản hồi

Các trường

Các trường được hiển thị bằng chữ in hoa trong Performance Hub, theo thứ tự sau:

TrườngNội dung hiển thị
TimestampNgày và giờ của yêu cầu
Response TimeThời gian Performance Hub cần để phản hồi, tính bằng mili giây
Request IDID duy nhất của yêu cầu này. Nhấp nút sao chép để sao chép ID, ví dụ để cung cấp cho bộ phận Hỗ trợ.
IP AddressĐịa chỉ IP mà yêu cầu được gửi từ đó
UserĐịa chỉ email của người đã gửi yêu cầu
RefererTrang mà yêu cầu được gửi từ đó, nếu có
User AgentTrình duyệt, ứng dụng hoặc công cụ đã gửi yêu cầu
Cơ sởCơ sở mà yêu cầu hướng đến, theo dạng "Tên (id)", ví dụ Lower Manhattan và ID cơ sở của nó
OrganisationTổ chức, theo dạng "Tên (id)"

Yêu cầu và phản hồi

Bên dưới các trường là nội dung của yêu cầu, nếu có:

PhầnNội dung hiển thị
Request POST BodyNội dung đã gửi, ví dụ lý do được đưa ra khi mở khóa cửa hoặc giờ hoạt động mới của một cơ sở. Tiêu đề hiển thị "Request POST Body" cho mọi phương thức có gửi nội dung.
Response BodyNội dung Performance Hub trả về, bao gồm mọi thông báo lỗi
Query ParametersCác tùy chọn được thêm vào yêu cầu, chẳng hạn số trang hoặc một cơ sở

Nhấp Copy section (biểu tượng sao chép ở góc trên bên phải của một phần) để sao chép nội dung của phần đó, ví dụ để dán vào một yêu cầu hỗ trợ.

Nếu một yêu cầu không có nội dung nào để hiển thị, phần chi tiết ghi "No request/response payloads recorded for this entry." Nhiều yêu cầu GET, vốn chỉ đọc thông tin, không có nội dung yêu cầu.

Tóm tắt lỗi AI

Đối với yêu cầu thất bại, có trạng thái từ 400 trở lên, phần chi tiết bao gồm mục AI Error Summary.

  1. Nhấp Generate summary.
  2. Đọc bản tóm tắt. Bản tóm tắt giải thích bằng ngôn ngữ dễ hiểu điều gì đã xảy ra và cần làm gì tiếp theo.

AI Error Summary cho một yêu cầu 403, giải thích rằng người thực hiện thay đổi không có quyền gán vai trò đóAI Error Summary cho một yêu cầu 403, giải thích rằng người thực hiện thay đổi không có quyền gán vai trò đó

Hình 2: Đối với yêu cầu thất bại, Generate summary giải thích lỗi bằng ngôn ngữ dễ hiểu

  • Bản tóm tắt chỉ được tạo khi bạn nhấp Generate summary. Sau khi một bản tóm tắt đã được tạo, bản tóm tắt đó có thể hiển thị nhãn cached.
  • Bản tóm tắt do AI tạo và có thể sai. Hãy đối chiếu với Response Body, nơi chứa thông báo mà Performance Hub thực sự trả về.
  • Nếu không thể tạo bản tóm tắt, một cảnh báo sẽ đề nghị bạn thử lại sau. Trong thời gian đó, hãy đọc Response Body.

Sau 7 ngày: bản xem trước

Toàn bộ nội dung yêu cầu và phản hồi được lưu giữ trong 7 ngày. Sau đó, các nội dung dài hơn được cắt ngắn thành bản xem trước, và phần chi tiết ghi "Full request and response payloads are kept for 7 days. Showing a preview for this log." Các nội dung ngắn vừa với bản xem trước vẫn được giữ nguyên đầy đủ.

Phần còn lại của mục nhật ký, chẳng hạn ai đã gửi yêu cầu, thời điểm gửi và kết quả, được lưu giữ trong 90 ngày.

Một mục nhật ký cũ hơn 7 ngày, với thông báo bản xem trước và nội dung yêu cầu, phản hồi đã được rút gọnMột mục nhật ký cũ hơn 7 ngày, với thông báo bản xem trước và nội dung yêu cầu, phản hồi đã được rút gọn

Hình 3: Sau 7 ngày, chỉ còn lại bản xem trước ngắn của yêu cầu và phản hồi

Nếu sau này bạn có thể cần toàn bộ nội dung, hãy mở yêu cầu và dùng Copy section trong vòng 7 ngày. Một tệp xuất CSV không bao gồm nội dung yêu cầu và phản hồi.

Mã trạng thái

Trạng thái là thông tin đầu tiên trên mỗi hàng. Chữ số đầu tiên cho bạn biết loại kết quả:

Trạng tháiÝ nghĩaVí dụ
2xxThành công200 OK, 201 Created
3xxChuyển hướng: yêu cầu đã được gửi đến nơi khác301 Moved
4xxYêu cầu có vấn đề, ví dụ không có quyền hoặc dữ liệu đầu vào không hợp lệ400 Bad Request (một giá trị không hợp lệ), 401 Unauthorised (chưa đăng nhập), 403 Forbidden (không có quyền), 404 Not Found, 409 Conflict (yêu cầu xung đột với trạng thái hiện tại, chẳng hạn cửa đang ở chế độ bảo trì), 429 Too Many Requests (quá nhiều yêu cầu trong thời gian ngắn)
5xxLỗi máy chủ500 Server Error, 502 Bad Gateway, 503 Service Unavailable

Huy hiệu nguồn

Mỗi yêu cầu có một huy hiệu nguồn cho biết yêu cầu đến từ đâu:

Huy hiệuNguồn gửi yêu cầu
webNgười dùng sử dụng Performance Hub trên trình duyệt hoặc ứng dụng
api-keyMột tích hợp sử dụng khóa API, chẳng hạn hệ thống đặt chỗ hoặc hệ thống hội viên. Xem Xác thực Partner API.
mcpMột AI agent hoặc ứng dụng AI được kết nối qua MCP. Xem Sử dụng với AI.
model-routerModel Router
websocketMột kết nối trực tiếp, chẳng hạn cập nhật theo thời gian thực
guest-tokenMột liên kết khách

Các huy hiệu khác cũng có thể xuất hiện.