Nhật ký
Mô-đun «Nhật ký» trong Platform OneEntry cho phép các quản trị viên theo dõi cả hành động của các quản trị viên khác trong hệ thống cũng như hoạt động của API nội dung công khai. Mô-đun bao gồm bốn tab:
| Tab | Hiển thị thông tin |
|---|---|
| Nhật ký hành động của quản trị viên | Tất cả các hành động của quản trị viên trong hệ thống: tạo, sửa đổi, xóa thực thể. |
| Lưu lượng truy cập của quản trị viên | Phiên đăng nhập của các quản trị viên: khi nào họ đăng nhập, khi nào họ đăng xuất, từ thiết bị nào. |
| Thống kê API nội dung | Bộ đếm các lần gọi tất cả các điểm cuối công khai của trang web trong các khoảng thời gian khác nhau. |
| Lỗi API nội dung | Tất cả các phản hồi 4xx/5xx từ API công khai với chi ti ết yêu cầu và stack trace. |
Trong giao diện của mô-đun, các tab được đặt tên như sau: Nhật ký Quản trị viên, Nhật ký Truy cập vào Ứng dụng Quản trị viên, Thống kê API Nội dung, Lỗi API Nội dung.
Mỗi tab có sẵn dưới một quyền riêng biệt — xem Quyền cho nhật ký.
Nhật ký hành động của quản trị viên
Tab chính, hiển thị tất cả các hành động của quản trị viên trong hệ thống.
Các phần tử giao diện
Tab bao gồm hai khối:
- Bộ lọc
- Danh sách hành động
Bộ lọc
Để lọc các hành động, các trường sau đây có sẵn:
- Từ — trường văn bản để nhập ngày, bắt đầu từ đó cần lọc các hành động.
- Đến — trường văn bản để nhập ngày, kết thúc ở đó cần lọc các hành động.
Ngày có thể được nhập dưới dạng chuỗi theo định dạng ngày của khu vực của bạn, cũng như chọn ngày cần thiết bằng cách sử dụng lịch xuất hiện khi nhấp vào trường nhập ngày.
- ID Quản trị viên — trường số để nhập định danh duy nhất của quản trị viên.
- Hành động của người dùng — danh sách thả xuống các hành động của người dùng:
- Tạo
- Sửa đổi
- Xóa
- Trạng thái — danh sách thả xuống các trạng thái của hành động:
- Thành công
- Lỗi
- Tên mô-đun — danh sách thả xuống các tên mô-đun:
- Quản trị viên
- Bộ thuộc tính
- Sao lưu
- Quản lý khối
- Quản lý sự kiện
- Cài đặt chung
- Tải lên tệp
- Trình chỉnh sửa tệp
- Quản lý biểu mẫu
- Địa phương hóa
- Đánh dấu
- Menu
- Mô-đun
- Quản lý nội dung
- Sản phẩm
- Quản lý đơn hàng
- Cài đặt cơ bản
- Quản lý thanh toán
- Quản lý trạng thái sản phẩm
- NGƯỜI DÙNG
- Quản lý nhà cung cấp và người dùng xác thực
- Quản lý mẫu
- Quản lý mẫu xem trước
- ID Ghi chú — trường số để nhập định danh duy nhất của ghi chú.
Dưới khối bộ lọc có hai nút:
- Xóa dữ liệu — xóa các ghi chú nhật ký hành động của quản trị viên trong khoảng thời gian được chỉ định bởi các trường Từ / Đến (xem Xóa nhật ký thủ công).
- Đặt lại — đặt lại các bộ lọc đã áp dụng.
Danh sách hành động
Danh sách hành động được trình bày dưới dạng bảng gồm sáu cột:
- Hành động của người dùng
- Trạng thái
- Đăng nhập của người dùng
- Tên mô-đun
- ID Ghi chú
- Ngày và giờ
Đối với mỗi cột, có thể sắp xếp dữ liệu bằng cách nhấp vào tiêu đề cột. Nhấp lần đầu tiên sẽ sắp xếp theo thứ tự giảm dần, nhấp lần thứ hai sẽ sắp xếp theo thứ tự tăng dần, nhấp lần thứ ba sẽ đặt lại sắp xếp.
Kiểm toán khả năng hiển thị của khối
Mỗi chuyển đổi khả năng hiển thị của khối (chuyển đổi "hiện/không hiện" trong admin khối) sẽ tự động được ghi lại trong Nhật ký hành động của quản trị viên. Có thể thấy, quản trị viên nào và khi nào đã thay đổi trạng thái của một khối cụ thể.
Trong danh sách hành động, bản ghi như vậy thuộc về mô-đun Quản lý khối.
Lưu lượng truy cập của quản trị viên (Nhật ký Truy cập Quản trị viên)
Tab «Lưu lượng truy cập của quản trị viên» hiển thị mỗi lần đăng nhập và đăng xuất của quản trị viên trong hệ thống như một bản ghi riêng biệt. Qua đó có thể thấy ai và khi nào đã truy cập vào admin, điều này rất tiện lợi cho việc kiểm toán.
Các trường trong bảng
Bảng bao gồm sáu cột:
| Cột | Ý nghĩa |
|---|---|
| Đăng nhập | tên đăng nhập của quản trị viên |
| IP | địa chỉ IP mà quản trị viên đã đăng nhập |
| Thời gian đăng nhập | ngày và giờ đăng nhập |
| Thời gian đăng xuất | ngày và giờ đăng xuất (đối với phiên đang mở — để trống) |
| Thời gian | thời gian của phiên (đối với phiên đang hoạt động — từ đăng nhập đến thời điểm hiện tại) |
| Lý do | lý do đóng phiên: logout (tự nhấn "Đăng xuất") hoặc admin_revoked (quản trị viên khác đã buộc phải kết thúc phiên) |
Cũng như trong Nhật ký hành động của quản trị viên, bất kỳ cột nào cũng có thể được sắp xếp bằng cách nhấp vào tiêu đề của nó.
Hết hạn xác thực và việc gia hạn tự động không được ghi lại dưới dạng bản ghi riêng biệt. Phiên đã hết hạn được đánh dấu là đã đóng không ngay lập tức, mà khi không còn được sử dụng.
Bộ lọc
- Từ / đến — khoảng thời gian (các trường nhập ngày với lịch).
- ID Quản trị viên — trường số để lọc theo quản trị viên cụ thể.
- Trạng thái Phiên — danh sách thả xuống trạng thái phiên: Tất cả / Đang hoạt động / Đã đóng.
Nút "Xóa dữ liệu"
Xóa các bản ghi về các phiên trong khoảng thời gian được chỉ định bởi các trường Từ / Đến. Khi nhấp vào, một hộp thoại xác nhận sẽ mở ra:
Xác nhận hành động — Xóa tất cả các phiên đã đóng trong khoảng thời gian đã chỉ định? Hành động này không thể hoàn tác. Các phiên đang hoạt động sẽ vẫn còn.
Chỉ xóa các phiên đã đóng. Các phiên đang hoạt động (với xác thực đang mở) sẽ không bị xóa.
Thống kê API nội dung
Tab «Thống kê API nội dung» hiển thị bộ đếm các lần gọi tất cả các điểm cuối công khai của trang web trong các khoảng thời gian khác nhau — 1 giờ, 24 giờ, 7 ngày.
Hiển thị thông tin
- Danh sách tất cả các điểm cuối công khai (
GET /api/content/...) — được tạo tự động, không cần phải điền thủ công. - Bộ đếm bên cạnh mỗi điểm cuối — số lần nó được gọi trong khoảng thời gian đã chọn.
Các phần tử giao diện
- Khoảng thời gian — danh sách thả xuống khoảng thời gian: Giờ vừa qua / 24 Giờ vừa qua / 7 Ngày vừa qua (mặc định là 24 Giờ vừa qua).
- Làm mới — nút làm mới dữ liệu một cách cưỡng bức.
Dữ liệu được trình bày dưới dạng bảng gồm bốn cột:
| Cột | Ý nghĩa |
|---|---|
| Đường dẫn | đường dẫn của điểm cuối (/api/content/...) |
| Phương thức | phương thức HTTP (GET, POST, …) |
| Mô tả | mô tả ngắn gọn về điểm cuối |
| Yêu cầu | số lượng lần gọi trong khoảng thời gian đã chọn |
Ở đầu trang có một biểu ngữ thông tin Không áp dụng tự động xóa: thống kê được đọc theo thời gian thực và không được lưu trữ trong dự án, vì vậy không cần phải xóa nó, và thời gian lưu trữ dữ liệu trong admin không được cấu hình.
Nếu dữ liệu thống kê tạm thời không khả dụng, một cảnh báo sẽ xuất hiện trên bảng "Chỉ số tạm thời không khả dụng. Tất cả các điểm cu ối đều được hiển thị với số đếm bằng không." — danh sách các điểm cuối vẫn được hiển thị, nhưng với bộ đếm 0.
Thống kê được lưu trữ trong thời gian giới hạn, và thời gian lưu trữ trong admin không được cấu hình. Để phân tích trong khoảng thời gian dài hơn, hãy tự lưu trữ dữ liệu. Biểu ngữ thông tin ở đầu trang cảnh báo về điều này.
Tại sao cần thiết
Thông qua thống kê, có thể thấy các điểm cuối API nội dung nào được sử dụng và điểm nào không được gọi. Sự sụt giảm đột ngột trong số lần gọi một điểm cuối thường cho thấy có vấn đề trong ứng dụng khách.
Dữ liệu được làm mới không thường xuyên hơn một lần mỗi phút: nhấp lại vào Làm mới trong vòng 60 giây sẽ hiển thị cùng một giá trị.
Lỗi API nội dung
Tab «Lỗi API nội dung» hiển thị tất cả các phản hồi 4xx/5xx mà API công khai đã phát ra trong khoảng thời gian. Các nhà phát triển tích hợp ứng dụng khách với API nội dung có thể thấy lỗi của các yêu cầu của họ ngay trong admin.
Hiển thị thông tin
Mỗi bản ghi là một lỗi HTTP riêng biệt. Bảng bao gồm năm cột:
| Cột | Ý nghĩa |
|---|---|
| Thời gian | dấu thời gian của lỗi |
| Trạng thái | trạng thái HTTP (4xx / 5xx) |
| Phương thức | phương thức yêu cầu (GET, POST, …) |
| Đường dẫn | đường dẫn (/api/content/...) |
| Thông điệp | văn bản lỗi |
Nếu trong khoảng thời gian đã chọn không có lỗi nào, thay vì bảng sẽ hiển thị thông báo "Không có lỗi nào được ghi lại cho khoảng thời gian đã chọn".
Trường «Chi tiết» mở ra màn hình chi tiết với:
- Nội dung yêu cầu (không có bí mật — mật khẩu, mã thông báo, tiêu đề xác thực được che giấu)
- Query — các tham số của chuỗi yêu cầu
- Headers
- Stack trace — mở rộng (tối đa 8 KB)
Bộ lọc
- Từ / đến — khoảng thời gian (các trường nhập ngày với lịch).
- Trạng thái HTTP — danh sách thả xuống các trạng thái. Có thể chọn nhóm (4xx - Bên phía khách hàng, 5xx - Bên phía máy chủ) hoặc mã cụ thể: 400, 401, 403, 404, 422, 500, 502, 503.
- Đường dẫn — trường văn bản để lọc theo đường dẫn (ví dụ:
/api/content/blocks/*).
Nút "Xóa dữ liệu"
Xóa các bản ghi về lỗi trong khoảng thời gian được chỉ định bởi các trường Từ / Đến. Nếu không có khoảng thời gian được chỉ định — xóa tất cả các lỗi.
An toàn — ẩn dữ liệu nhạy cảm
Dữ liệu nhạy cảm trong các bản ghi lỗi sẽ tự động bị ẩn. Các trường password, token, authorization, api_key, x-app-token, cookie, set-cookie (không phân biệt chữ hoa chữ thường) sẽ được thay thế bằng ***. Các nội dung yêu cầu lớn sẽ bị cắt ngắn xuống 2 KB.
Xóa nhật ký thủ công
Các bản ghi nhật ký được xóa thủ công — trên mỗi tab lưu trữ bản ghi, có nút «Xóa dữ liệu»:
| Tab | Xóa cái gì |
|---|---|
| Nhật ký hành động của quản trị viên | các bản ghi hành động của quản trị viên trong khoảng thời gian đã chọn |
| Lưu lượng truy cập của quản trị viên | chỉ xóa các phiên đã đóng trong khoảng thời gian đã chọn |
| Lỗi API nội dung | các bản ghi lỗi trong khoảng thời gian đã chọn |
Khoảng thời gian xóa được chỉ định bởi các trường Từ / Đến trong bộ lọc của tab. Nếu không có khoảng thời gian được chỉ định — xóa tất cả các bản ghi của loại tương ứng. Trước khi xóa, luôn hiển thị hộp thoại xác nhận «Xác nhận hành động», thao tác này không thể hoàn tác.
Nút "Xóa dữ liệu" trên tab "Lưu lượng truy cập của quản trị viên" không xóa các phiên đang hoạt động của quản trị viên — ngay cả khi chỉ định khoảng thời gian chồng chéo với thời điểm hiện tại, phiên đang mở của đồng nghiệp đang làm việc sẽ không bị xóa. Chỉ xóa các phiên đã đóng.
Dữ liệu thống kê được đọc theo thời gian thực và không được lưu trữ trong dự án, vì vậy không có nút "Xóa dữ liệu" trên tab này — điều này được thông báo bởi biểu ngữ "Không áp dụng tự động xóa".
Quyền cho nhật ký
Mỗi tab của nhật ký có sẵn dưới một quyền riêng biệt trong cây quyền:
| Tab | Quyền |
|---|---|
| Nhật ký hành động của quản trị viên | journal.viewAdminActions |
| Lưu lượng truy cập của quản trị viên | journal.viewAdminAccess |
| Thống kê API nội dung | journal.viewContentApiStats |
| Lỗi API nội dung | journal.viewContentApiErrors |