הכרטיסייה Request logs ב-
Developer Hub מציגה את
תעבורת ה-API /v1 של הארגון שלכם: נתונים סטטיסטיים מסכמים ל-24 השעות האחרונות —
מספר הבקשות, שיעור השגיאות והבקשות שהוגבל קצבן — מעל יומן הניתן לחיפוש
של בקשות בודדות.
מה נרשם בכל רשומה
טבלת היומן מציגה לכל קריאה את השעה, שיטת ה-HTTP, הנתיב, סטטוס התגובה, החלטת המדיניות, זמן ההשהיה ומזהה הבקשה. פתיחת רשומה מציגה את
הפרטים המלאים, כולל חשבון השירות ומפתח ה-API שבאמצעותם בוצעה הקריאה,
כתובת ה-IP של המקור וההרשאות שהיו בתוקף.
החלטת המדיניות מציינת כיצד טופלה הבקשה:
- Allowed — הבקשה אומתה ואושרה.
- Denied — הבקשה נדחתה, לדוגמה משום שלמפתח לא הייתה ההרשאה
הנדרשת, שתוקפו פג או שהוא נשלל.
- Rate limited — הבקשה חרגה ממכסת בקשות ונדחתה
עם
429. ראו מגבלות קצב.
סינון וחיפוש
ניתן לצמצם את היומן לפי חשבון שירות, מפתח API, שיטת HTTP, קבוצת סטטוס
(2xx–5xx), החלטת מדיניות, טווח זמן או קידומת נתיב (לדוגמה
/v1/entities).
מעקב אחר שגיאה לפי מזהה בקשה
כל תגובת API כוללת כותרת Request-Id, וכל גוף שגיאה
כולל את אותו ערך בשדה request_id שלו. הדביקו את הערך הזה בחיפוש ביומן הבקשות
כדי לעבור ישירות לרשומה התואמת ולראות בדיוק
כיצד טופלה הבקשה.
כאשר מערכת משולבת מדווחת על שגיאה, בקשו את request_id מתגובת
השגיאה. זו הדרך המהירה ביותר לעבור מהתסמין בצד הלקוח אל
הרשומה המהימנה של מה שקרה — וזה הערך שיש לצרף בעת פנייה
לתמיכה של Living Security.
איתור בעיות מוקדם
- עלייה בשיעור השגיאות מעידה בדרך כלל על מפתח שתוקפו פג, שנשלל או שאיבד
הרשאה שהוא זקוק לה — סננו לפי החלטה כדי לאתר את האישור הכושל.
- עלייה במספר הבקשות שהוגבל קצבן מעידה על עומס יתר של עומס עבודה; ראו
מגבלות קצב לאסטרטגיות החלקה.
- תעבורה מחשבון שירות שאמור להיות לא פעיל היא אות לבדוק
אם האישורים שלו נמצאים במקום שבו אתם סבורים שהם נמצאים — ולהשבית את החשבון
בזמן החקירה.
