Audit
Có hai nhật ký độc lập: nhật ký của Tara và nhật ký Guardrails trên máy bạn. Trang này nói mỗi nhật ký ghi gì, ai đọc được và secret được che thế nào.
Nhật ký của Tara
Với mỗi thay đổi quan trọng, Tara ghi một bản ghi trong cùng giao dịch với thay đổi đó. Nhờ vậy thay đổi đã thành công thì chắc chắn có bản ghi. Nhật ký phủ năm nhóm sự kiện: duyệt (duyệt, trả lại kèm lý do), vòng đời version (phát hành, ngừng hỗ trợ, thu hồi), vai trò (cấp và thu hồi), báo cáo (tài nguyên nghi vấn và cách xử lý), và kênh thông báo (đặt, sửa, xóa kênh của tổ chức). Mỗi bản ghi nêu ai làm, lúc nào, với tài nguyên nào, thuộc tổ chức nào, và lý do nếu có.
Xem nhật ký
Trên Portal, bạn mở phần cài đặt của tổ chức rồi chọn Audit log (nhật ký). Bằng Phillip, bạn dùng lệnh ph tara audit.
ph tara audit --since 7d
ph tara audit --action version.yank --org acme
ph tara audit --actor <login> --resource ten-tai-nguyen --limit 50 --json| Tùy chọn | Ý nghĩa |
|---|---|
--since, --until | Khoảng thời gian, dạng 7d hoặc 2026-10-01 |
--actor | Người thực hiện |
--action | Đúng một sự kiện, hoặc cả nhóm như version |
--resource, --org | Lọc theo tài nguyên, tổ chức |
--limit, --json | Số bản ghi, định dạng máy đọc |
Kết quả được phân trang, mới nhất ở trước.
Ai đọc được nhật ký?
Owner và Admin của một tổ chức xem được sự kiện của tổ chức đó, và không ai xem được nhật ký của tổ chức khác. Nhật ký chỉ mở qua phiên đăng nhập, token API không đọc được.
Secret được che ra sao?
Nhật ký không lộ secret. Lý do do người nhập tay bị che những chuỗi giống token, khóa hay mật khẩu, cả lúc ghi lẫn lúc đọc, và chỉ một danh sách khóa chi tiết định trước mới được hiển thị. Dù vậy bạn đừng dán thông tin nhạy cảm vào ô lý do.
Nhật ký Guardrails trên máy
Hook server Guardrails ghi mỗi quyết định (chặn, hỏi lại, che, ghi nhận) vào một tệp JSONL trên máy bạn. Trên macOS, tệp nằm ở ~/Library/Application Support/AI-Forge/audit.jsonl và xoay vòng khi đạt 50 MB.
Mỗi bản ghi gồm thời điểm, sự kiện, mã phiên, thư mục, nhánh, mã task, quyết định, mã các luật quyết định, luật được miễn trừ, policy đang áp, và phần nội dung đã che. Nội dung được che bằng mọi luật che của policy, nên secret gốc không nằm trong tệp. Nếu chưa nạp được policy thì nội dung không được lưu, vì chưa có luật nào để che.
Bạn xem nhật ký của chính mình bằng hai lệnh sau.
ph guardrails audit --days 7
ph guardrails audit --rule <mã-luật> --samples 5Lệnh thứ hai hiện các mẫu ngữ cảnh đã che quanh những lần một luật khớp, rất tiện khi bạn nghi luật chặn nhầm. Sau đó bạn gửi phản hồi bằng ph guardrails feedback.
Phần gửi về Ryoma
Mỗi quyết định Guardrails còn tạo một sự kiện chỉ có metadata, gửi về Ryoma qua đường telemetry. Sự kiện gồm mã luật, quyết định, mức độ, policy, phiên, repo, mã task và tên tool, không có nội dung. Nếu Ryoma chưa nhận được, Phillip giữ sự kiện trong bộ nhớ, có giới hạn, và gửi lại sau.
Collector của Ryoma chỉ ghi lại một phần của các trường này, xem Dữ liệu thu thập để biết chính xác trường nào được lưu.
Kho audit chi tiết tắt mặc định
Ryoma có thể giữ một kho audit chi tiết, đã che, cho Security. Kho giữ có thời hạn và chỉ Owner và Admin đọc được. Kho này tắt mặc định ở cả hai đầu: máy người dùng phải cài với tùy chọn gửi audit, và Ryoma phải bật nhận. Chỉ nên bật sau khi bộ phận pháp chế duyệt phạm vi ghi. Nếu Owner hoặc Admin chưa công bố việc bật thì nhật ký Guardrails chỉ nằm trên máy bạn.