Khắc phục sự cố

Không có phiên nào xuất hiện trong Cloud

Dashboard
CLI

Mở Administration → Keys và xác nhận khóa máy đang hoạt động và có events:add. Sau đó mở Observe → Events, mở rộng khoảng thời gian và xóa các bộ lọc môi trường và tác nhân. Nếu có sự kiện, hãy tìm kiếm ID phiên và sau đó kiểm tra Observe → Sessions để nhóm. Nếu không có sự kiện nào, hãy chẩn đoán daemon Failproof từ CLI.

Luồng Events trực tiếp với các bộ lọc chính và sự kiện tác nhân gần đây.

failproofai config --status
failproofai flush --wait --timeout 60
fp list envs
fp events --since 24h --limit 20
fp sessions --since 24h --limit 20

Xác nhận rằng capture đã bật, khóa được cấu hình có events:add, và bộ lọc dashboard phù hợp với môi trường được phát ra.

Sự kiện Python SDK vẫn nằm trên đĩa

Dashboard
CLI

Xóa các bộ lọc trong Observe → Events và tìm kiếm ID phiên SDK chính xác. Nếu không có gì xuất hiện, hãy kiểm tra spool SDK và daemon Failproof trên máy nguồn.

failproofai config --status
failproofai flush --wait

Xác nhận daemon đang chạy và được kết nối — SDK spool bất kể có hoặc không. Thư mục spool không cần phải tồn tại trước (writer tạo nó), và không có biến môi trường nào chọn nó: $FAILPROOFAI_HOME/custom-agents, nếu không thì ~/.failproofai/custom-agents là root duy nhất, và configure(base_dir=...) là override duy nhất. Nếu quá trình bị SIGKILL hoặc OOM-killed, bất kỳ thứ gì vẫn còn trong hàng đợi đều bị mất — hãy xử lý SIGTERM để giới hạn điều đó.

Máy không nhận chính sách

Dashboard
CLI

Mở Admin → enforcement, chọn máy và so sánh các phiên bản được gán, báo cáo và trước đó. Xác nhận phạm vi triển khai bao gồm máy và khóa của nó có policies:pull. Ingest có thể hoạt động ngay cả khi chính sách không được gửi.

failproofai config --status
failproofai update
failproofai config --status

Xác nhận ID máy và nhãn khớp với mục tiêu dashboard. Kết nối lại với khóa có khả năng chính sách nếu thông tin xác thực hiện tại chỉ cấp quyền ingest sự kiện.

Một hành động bị từ chối vì daemon không khả dụng

Dashboard
CLI

Mở Admin → enforcement và kiểm tra thời gian lần cuối cùng thấy máy và phiên bản báo cáo. Nếu máy đã lỗi thời, coi đó là vấn đề daemon cục bộ. Không làm yếu chính sách triển khai chỉ để vượt qua daemon không khả dụng.

failproofai config --status
failproofai update
failproofai config
failproofai config --status

Khởi động lại hoặc cập nhật failproofaid; chạy lại cấu hình khi phiên bản giao thức CLI và daemon khác nhau. Đường dẫn daemon được cấu hình không thành công theo thiết kế.

Chính sách tùy chỉnh không tải

Dashboard
CLI

Đối với chính sách do Cloud tạo, mở Admin → policy editor, chọn bản nháp và xem lỗi xác thực trước khi xuất bản. Đối với chính sách cục bộ, hãy sử dụng CLI để xác thực nó, sau đó mở Observe → policy sau một hành động kiểm tra để xác nhận quyết định đến.

Xác nhận tên tệp kết thúc bằng policies.js, policies.mjs hoặc policies.ts, module gọi customPolicies.add(...), và các import được giải quyết từ tệp chính sách.

failproofai policies --install --custom ./checkout.policies.ts
failproofai policies

Một audit không trả về phát hiện nào

Dashboard
CLI

Mở Analyze → audits, chọn lần chạy và kiểm tra xem phân tích mô hình đã chạy hay chưa. Sau đó so sánh phạm vi và cửa sổ của nó với Observe → sessions và mở các trace đại diện từ quần thể đó.Kết quả bằng không chỉ có ý nghĩa khi phân tích chạy thành công. Nếu phân tích bị bỏ qua hoặc thất bại, lần chạy không tạo phát hiện nào và giữ cửa sổ chưa được phân tích mở cho lần chạy thành công trong tương lai. Nếu phân tích mô hình bị vô hiệu hóa, audit cũng không tạo phát hiện nào vì lệnh credential xác định và quét PII chỉ ghi thống kê nhưng không còn tạo phát hiện.

Biểu mẫu audit với môi trường, tác nhân, tần suất và cửa sổ quét xác định quần thể phiên.

fp audits show <audit-name>
fp audits runs <audit-name>
fp sessions --since 24h --env production
fp audits context-show <audit-name>
fp audits run <audit-name>
fp audits findings --audit <audit-name>

Nếu lần chạy vẫn nằm trong hàng đợi, hãy chờ dung lượng audit-agent hoặc yêu cầu toán tử triển khai kiểm tra fleet audit. Một audit trong hàng đợi sẽ thử lại; nó không bị bỏ qua ngay lập tức.

Đánh giá trực tuyến không chạy tự động

Dashboard
CLI

Mở một phiên đã hoàn thành và kiểm tra xem đánh giá thủ công có thành công không. Cloud được lưu trữ hiện tại không có kiểm soát điểm cuối evaluator trong dashboard; toán tử máy chủ phải cấu hình nó.

Xác minh evaluator chính nó, sau đó kiểm tra các trạng thái đánh giá gần đây:

curl https://evaluator.example.com/health
fp evals --since 1h

Trên Cloud tự lưu trữ, xác nhận EVALUATOR_ENDPOINT có trên máy chủ và EVALUATOR_TOKEN khớp với evaluator. Đánh giá tự động bị vô hiệu hóa khi điểm cuối không có.

Xác thực CLI Cloud nhắm đến tổ chức sai

Dashboard
CLI

Sử dụng công tắc tổ chức và xác nhận slug và quyền dự kiến trước khi so sánh kết quả với CLI.

fp whoami
fp orgs current
fp orgs perms

Ở chế độ API-key, chỉ định fp --org <slug> --api-key <key> ... hoặc đặt AGENTEYE_ORG. Trạng thái tổ chức phiên con người được lưu có ý định bị bỏ qua cho các yêu cầu API-key.

Chính sách chặn công việc hợp lệ

Dashboard
CLI

Mở Observe → policy, bảo toàn quyết định và phiên liên kết, và xác định điều kiện dương tính giả. Sau đó mở Admin → enforcement và quay lại các máy bị ảnh hưởng về phiên bản trước. Tạo phiên bản hẹp hơn trong Policy editor, kiểm tra nó trên phạm vi nhỏ và chỉ mở rộng sau khi công việc hợp lệ thành công.

Quay lại triển khai Cloud chỉ có dashboard. Tạm dừng phiên cục bộ không vô hiệu hóa các chính sách được quản lý bởi Cloud. Nếu dashboard không có sẵn, hãy chụp trạng thái máy và triển khai và khôi phục quyền truy cập dashboard thay vì thử lại hành động bị chặn.

failproofai config --status

Connect your agents

Reference

Khắc phục sự cố