פעילות ויומנים
בדף זה
שתי כרטיסיות משמשות לניטור: Activity (ניתוח נתונים מצטבר) ו-Logs (תיעוד הביקורת לכל בקשה). שתיהן מכסות כל מפתח API וכל שירות מחובר, ושתיהן מתעדות מטא-נתונים בלבד — תוכן ההנחיות והתגובות לעולם אינו נשמר.
הכרטיסייה Activity
ל-Activity יש ארבע תצוגות — Overview, Trends, Performance, Explore — וגם לחצן Export. כל התצוגות חולקות את פקדי הכותרת: סינון לפי Key / agent, סינון לפי Model, ובורר Range (Last 24 hours, Last 7/30/90 days, Year, All time או Custom range).
סקירה כללית
איור 1: כותרת Activity (כרטיסיות התצוגה, המסננים, הטווח ו-Export) וכרטיסי ה-KPI
כרטיסי ה-KPI, כל אחד עם השוואה לתקופה הקודמת ("vs prev" / "No prior data"):
| KPI | משמעות |
|---|---|
| Spend this period | "Total spend over the selected date range." — עם העלות הממוצעת לבקשה. |
| Requests | מספר הבקשות. |
| Token volume | סך הטוקנים. |
| Error rate | "Share of requests in this period that returned an error." |
איור 2: Top API keys & agents ו-Top sources
Top API keys & agents מדרג את המפתחות והשירותים המחוברים לפי הוצאה, ו-Top sources מפצל את השימוש בין מפתחות API, סוכנים ו-Workflows.
מתחתם, שלושה תרשימים מפרטים את השימוש לפי מודל ולפי סוג טוקן.
איור 3: Usage by model: ההוצאה לאורך זמן עבור כל מודל
איור 4: Request volume by model
איור 5: Token breakdown (טוקני הנחיה, השלמה והסקה)
כאשר חל שמירה במטמון של הנחיות, כרטיס Prompt token caching מציג את Cache hit rate — "Share of prompt tokens served from the provider prompt cache." — ואת נפחי הטוקנים שנשמרו במטמון לעומת אלה שלא.
איור 6: Prompt token caching
מגמות
איור 7: Trends: מודלים לאורך זמן עם רשימת Trending; מתג המדד (Tokens, Spend, Requests) נמצא בפינה הימנית העליונה
Trends מציג תנועה: כל מודל (וכל מפתח/סוכן, בחלק משלו) מוצג בתרשים לאורך זמן, עם רשימת Trending של הפריטים שעלו — כולל תג New לפריטים שלא היה להם שימוש בתקופה הקודמת.
ביצועים
איור 8: Performance: מדדי KPI של זמן השהיה, תפוקה ושגיאות, עם Average latency over time ו-Errors over time
| KPI | משמעות |
|---|---|
| Median latency | "Median (p50) end-to-end request duration over the selected range." |
| p95 latency | "95th-percentile request duration — the slow tail most users feel." |
| Avg time to first token | "Average delay before the first streamed token (streaming requests only)." |
| Throughput | "Average output generation speed across requests." (tok/s) |
| Error rate / Total errors | שגיאות בתקופה שנבחרה. |
איור 9: Reliability & performance by model, עם Top failing models ו-Top failing keys & agents
הטבלה לפי מודל (בקשות, שיעור שגיאות, זמן השהיה ממוצע ו-p95, תפוקה, הוצאה) היא הדרך המהירה ביותר לזהות מודל שמתנהג בצורה חריגה; רשימות הישויות הנכשלות מצביעות ישירות על מה שצריך לבדוק. כשאין כשלים יופיע "No errors in this period".
חקור
איור 10: Explore: טבלת ציר על השימוש שלכם עם Metric, Group by, Then by ו-Show top
Explore היא טבלת ציר חופשית: בחרו Metric (לדוגמה Spend), Group by (Model, API key / agent, Source, Provider, Status), אפשר לקנן רמה נוספת עם Then by, והגבילו את הרשימה עם Show top. התוצאה היא פירוט מדורג עם Value ו-% of Total. פעולות השורה מאפשרות לכם Apply filters based on this model (או מפתח/סוכן) ולעבור אל View in logs.
ייצוא נתוני פעילות
לחצו על Export כדי לפתוח את תיבת הדו-שיח של הייצוא:
איור 11: Export activity data: מה לייצא, טווח תאריכים, מסננים ועמודות
- מה לייצא: Raw requests (שורת CSV אחת לכל בקשה) או סיכום — Summary by model, Summary by key & agent, Summary by source, Summary by period.
- טווח תאריכים ומסננים: הטווח והמסננים של התצוגה הנוכחית מועברים לתיבת הדו-שיח וניתן לשנות אותם. תיבת הדו-שיח מציגה את מספר השורות המשוער ("approx. … requests"); ייצוא גולמי מוגבל ל-25,000 שורות ("export is capped at 25,000" מופיע כשהטווח חורג מכך).
- עמודות: בייצוא גולמי, בחרו מתוך Time (UTC), Request ID, Model, Provider, Status, Key / agent, Key hash, Source, End user, Prompt/Completion/Total/Cached/Reasoning tokens, Spend (USD), Duration (ms), TTFT (ms), Tokens/sec, Cache hit, Zero completion ו-IP — עם Select all / Clear all.
הכרטיסייה Logs
הכרטיסייה Logs היא תיעוד הביקורת, בקשה אחר בקשה.
איור 12: Logs: חיפוש, מסננים, רענון חי וטבלת הבקשות
- חיפוש ("Search request ID, key, model…") ומסננים עבור Status (Success / Failed / All), Key / agent, Model ו-Provider.
- הגדרות Range קבועות מראש: Last 15 minutes, Last hour, Last 24 hours (ברירת המחדל), Last 7 days ו-Last 30 days, או בחירת תאריכים מותאמים אישית.
- Live נמצא ליד הטווח ומרענן את הטבלה אוטומטית: בחרו Off, 10s, 30s (ברירת המחדל) או 60s. ספירה לאחור מציגה מתי יתבצע הרענון הבא, ו-Refresh now מרענן מיד. Live מוסתר כשטווח מותאם אישית מסתיים בעבר.
איור 13: הפקד Live: רענון Off, 10s, 30s או 60s, ליד בורר הטווח
- ההיסטוגרמה מציגה את נפח הבקשות לאורך הטווח (שגיאות מודגשות); גררו כדי לבחור אזור בה ולצמצם את הטבלה לחלון הזמן הזה ("Showing logs for …", עם Clear selection).
- Export פותח את Export request logs: בחרו בקשות גולמיות או סיכום, את טווח התאריכים, המסננים (Key / agent, Model, Provider, Status — וגם טקסט החיפוש הנוכחי שלכם) ובייצוא גולמי, גם את העמודות.
עבור סיכומים, תיבת הדו-שיח מציינת: "Summaries cover whole days, so a sub-day or graph selection is widened to full days." ו-"The search text is not applied to summaries."
כל שורה מציגה תאריך, מזהה בקשה, מודל, ספק, טוקני קלט ופלט, סוכן / מפתח, מהירות (tok/s), עלות וסטטוס (success / failure). תג No charge מסמן תגובות שנכשלו או ריקות שלא עלו דבר. תג cached על מספר טוקני הקלט מציין טוקנים שהוגשו ממטמון ההנחיות, והכותרת התחתונה מציגה "Showing … of …". תוצאה ריקה מציגה "No requests yet." או "No requests match your filters."
פרטי בקשה
לחצו על שורה כדי לפתוח את המגירה Request details:
איור 14: Request details: מטא-נתונים, מספרי טוקנים ועלות
| חלק | שדות |
|---|---|
| Request | Request ID (ניתן להעתקה), Time, Status, Model (המודל ששירת את הבקשה), Requested model (לדוגמה auto כשה-Auto Router בחר את המודל), Provider, IP address, Cache hit, Latency, Time to first token, ו-API base (השרת במעלה הזרם) כשהוא מתועד. |
| Tokens | Prompt tokens, Completion tokens, Total tokens, Speed — וגם Cached tokens (קריאה/כתיבה) ו-Reasoning tokens כשהם קיימים. |
| Cost | העלות המדויקת של הבקשה. |
| Source | Key / Agent (איזה מפתח API או סוכן ביצע את הקריאה) ו-End user (מזהה משתמש הקצה, אם הגורם הקורא סיפק אותו). |
בכוונה, אין בשום מקום ביומנים תוכן של הנחיות או תגובות.