Nhật ký kiểm toán & Giám sát (Logging & Audit)

Trạng thái

Owner: Tech lead · Trạng thái: draft · Nguồn chuẩn: flezi.app.api.backend/app/middleware/logging.py, app/features/governance/

Tài liệu này giải thích cách hệ thống ghi nhận nhật ký hoạt động (application logs), nhật ký kiểm toán bảo mật (security audit trails) và theo dõi trạng thái hệ thống.

Các loại nhật ký được thu thập

1. Request & Access Logs: Ghi nhận toàn bộ HTTP request qua Backend kèm mã phản hồi, thời gian xử lý và correlation_id duy nhất xuyên suốt các dịch vụ.
2. Security Audit Logs: Ghi lại các thao tác thay đổi quyền hạn, tạo/sửa/xóa thành viên, đổi mật khẩu, gán policy, hoặc phê duyệt HITL.
3. AI Execution Traces: Lưu trữ tại MLflow Server, ghi nhận luồng thực thi LangGraph, các lần gọi công cụ và token tiêu thụ.

Nguyên tắc bảo mật trong Logging

• Masking dữ liệu nhạy cảm: Tuyệt đối không ghi thông tin thẻ, mật khẩu plain text, secret key hoặc token vào log file.
• Tính toàn vẹn: Log file được gửi tập trung về hệ thống lưu trữ tập trung có chính sách cấm chỉnh sửa (WORM - Write Once, Read Many).

Kiểm soát hiện có

• app/middleware/logging.py sử dụng thư viện loguru với định dạng JSON có cấu trúc.
• Gắn correlation_id cho mỗi request để dễ dàng truy vết sự cố xuyên suốt các microservices.

Bằng chứng (file / config)

• flezi.app.api.backend/app/middleware/logging.py
• flezi.app.api.backend/app/docs/CORRELATION_ID_SOLUTION.md

Hạn chế & roadmap

• Kết nối chuyển tiếp toàn bộ security log về hệ thống SIEM (như Microsoft Sentinel hoặc Splunk) của khách hàng theo thời gian thực.