פתרון בעיות

אין הפעלות בענן

לוח בקרה
CLI

פתח את Administration → Keys והאשר שמפתח המכונה פעיל ויש לו events:add. לאחר מכן פתח את Observe → Events, הרחב את טווח הזמן וטהר את מסננים הסביבה וסוכן. אם קיימות אירועים, חפש את מזהה ההפעלה ובדוק את Observe → Sessions לקבוצה. אם אין אירועים, בצע אבחון של ה-daemon של Failproof מ-CLI.

זרם ה-Events הכמי עם המסננים העיקריים שלו גלויים ואירועי סוכן אחרונים שמגיעים.

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

אשר שהלכידה מופעלת, שלמפתח המוגדר יש events:add, וש-dashboard filter תואם את הסביבה שפולטת.

אירועי Python SDK נשארים בדיסק

לוח בקרה
CLI

טהר מסננים ב-Observe → Events וחפש את מזהה ההפעלה של ה-SDK. אם שום דבר לא מופיע, בדוק את ה-SDK spool ו-daemon של Failproof במכונת המקור.

failproofai config --status
failproofai flush --wait

אשר שתהליך הסוכן מגדיר AGENTEYE_SPOOL_TO_FAILPROOFAI=1 וש-$FAILPROOFAI_HOME/custom-agents, אחרת ~/.failproofai/custom-agents, קיים לפני הפעלת ה-SDK.

המכונה לא מקבלת מדיניויות

לוח בקרה
CLI

פתח את Admin → enforcement, בחר את המכונה והשווה בין הגרסאות שלה שהוקצו, דווח והקודמות. אשר שטווח ההפצה כולל את המכונה ולמפתחה יש policies:pull. הערה יכולה לעבוד גם כאשר מסירת המדיניות לא עובדת.

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

אשר שמזהה המכונה ותווית תואמים את יעד ה-dashboard. התחבר מחדש עם מפתח המסוגל למדיניות אם האישור הקיים מעניק רק הערה של אירועים.

פעולה חסומה מכיוון שה-daemon אינו זמין

לוח בקרה
CLI

פתח את Admin → enforcement ובדוק את זמן האחרון שנראתה המכונה וגרסה דווח. אם המכונה ישנה, התייחס לזה כבעיית daemon מקומית. אל תחלש את המדיניות המפותחת רק כדי לעקוף daemon אינו זמין.

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

הפעל מחדש או עדכן את failproofaid; הפעל מחדש את ההגדרות כאשר גרסאות פרוטוקול ה-CLI ו-daemon שונות. נתיב ה-daemon המוגדר נכשל בתכנון סגור.

מדיניות מותאמת אישית לא נטענת

לוח בקרה
CLI

עבור מדיניות שנכתבה בענן, פתח את Admin → policy editor, בחר את הטיוטה וסקור שגיאות אימות לפני פרסום. עבור מדיניות מקומית, השתמש ב-CLI לאימות, ופתח את Observe → policy לאחר פעולת בדיקה כדי להשתמע בהחלטות.

אשר שם הקובץ מסתיים ב-policies.js, policies.mjs, או policies.ts, המודול קורא ל-customPolicies.add(...), והיבואים מתפזרים מקובץ המדיניות.

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

ביקורת משכנעת לא תוצאות

לוח בקרה
CLI

פתח את Analyze → audits, בחר את ההפעלה וודא אם ניתוח מודל רץ. לאחר מכן השווה את הטווח והחלון שלו עם Observe → sessions ופתח עקבות מייצגים מאוכלוסיית זו.תוצאה אפסית היא משמעותית רק כאשר הניתוח רץ בהצלחה. אם הניתוח דולג או נכשל, ההפעלה לא מייצרת ממצאים ושומרת על החלון שלא נותחה לפעולה בעתיד. אם ניתוח מודל אינו מופעל, הביקורת גם לא מייצרת ממצאים מכיוון שסריקת הרגלים ו-PII רושמות קבוע אך כבר לא מעלות ממצאים.

טופס הביקורת שבו סביבה, סוכן, קצב ותופעה חלון סיקור מגדירים את אוכלוסיית ההפעלה.

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>

אם ההפעלה נשארה בתור, חכה לקיבולת audit-agent או בקש מ-deployment operator לבדוק את צי הביקורת. ביקורת בתור ניסיונות; היא לא מדלגת מיד.

הערכות מקוונות לא רצות באופן אוטומטי

לוח בקרה
CLI

פתח הפעלה שהושלמה וודא אם הערכה ידנית מצליחה. ענן Cloud המצוי כרגע אין שליטה בנקודת קצה של פולט בלוח הבקרה; מפעיל השרת חייב להגדיר אותה.

אמת את מעריך עצמו, ואז בדוק מצבי הערכה אחרונים:

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

ב-Cloud שעות עצמיות, אשר שEVALUATOR_ENDPOINT נוכח בשרת ו-EVALUATOR_TOKEN תואם את המעריך. הערכה אוטומטית אינה מופעלת כאשר נקודת הקצה חסרה.

אימות CLI בענן מיעד את הארגון הלא נכון

לוח בקרה
CLI

השתמש בבורר הארגון והשתכנע בסלאג וההרשאות הצפויים לפני השוואה של תוצאות עם CLI.

fp whoami
fp orgs current
fp orgs perms

במצב מפתח API, ציין fp --org <slug> --api-key <key> ... או הגדר AGENTEYE_ORG. מצב ארגון הפעלה אדם שנשמר בכוונה מתעלם בבקשות מפתח API.

מדיניות חוסמת עבודה תקפה

לוח בקרה
CLI

פתח את Observe → policy, שמור על ההחלטה ההפעלה המקושרת, וזהה את מצב חיובי כוזב. לאחר מכן פתח את Admin → enforcement והחזר את המכונות המושפעות לגרסה הקודמת. צור גרסה צרה יותר ב-Policy editor, בדוק אותה בטווח קטן, והרחב רק לאחר שעבודה תקפה מצליחה.

חזרה של Cloud הוא רק לוח בקרה. השהיית הפעלה מקומית לא משבית מדיניויות מנוהלות בענן. אם לוח הבקרה אינו זמין, תפוס את מצב המכונה וההצטיידות ותרחקת גישה לוח בקרה ולא חזור על פעולה החסומה.

failproofai config --status

Connect your agents

Reference

HTTP API