גישה למדדים

במאמר הזה מוסבר איך לגשת למדדים שנוצרו על ידי אפליקציית Gemini Enterprise. המדדים האלה מספקים תובנות לגבי הביצועים והתקינות של האפליקציה.

אפשר להציג את נתוני הטלמטריה של המדדים באמצעות Metrics Explorer או ישירות בסוכנים בודדים באמצעות הכרטיסייה Observability של הסוכן.

מושגים מרכזיים

בקטע הזה נסביר על מושגים מרכזיים שקשורים ליכולת הצפייה ב-Gemini Enterprise.

קונספט תיאור
מדדים מדדים הם מדידות מספריות שהמערכות אוספות לאורך זמן. המדידות האלה מייצגות את הביצועים, את השימוש במשאבים או את ההתנהגות של מערכת. מהנדסים משתמשים במדדים כדי לעקוב אחרי תקינות המערכת, לזהות מגמות ולהפעיל התראות.
מדדים ברמת הסוכן מדדים שמודדים את הפעילות של סוכן ספציפי, כמו הסשנים, תחלופת המסרים והפעלות הכלים שלו. הם מפורטים בסוג המשאב Gemini Enterprise Agent, והם נאספים רק כשהגדרת הנראות Enable instrumentation of OpenTelemetry traces and logs מופעלת עבור הסוכן הזה.
מדדים ברמת האפליקציה מדדים שמודדים את כל התנועה לאפליקציה ולא לסוכן יחיד, כמו מספר הבקשות והחביון מקצה לקצה. הם מופיעים בקטע Gemini Enterprise Engine בסוג המשאב, כאשר Engine הוא שם ה-API של אפליקציית Gemini Enterprise. הנתונים האלה נאספים ללא קשר להגדרות הנראות.

לפני שמתחילים

חשוב לוודא שיש לכם את הפריטים הבאים:

  • התפקיד אדמין של Gemini Enterprise או התפקיד Google Cloud משתמש של Gemini Enterprise במסוף.

  • אפליקציית Gemini Enterprise קיימת. מידע על יצירת אפליקציה חדשה זמין במאמר יצירת אפליקציה.

  • כדי לגשת אל Metrics Explorer, צריך להיות לכם התפקיד צפייה ב-Monitoring (roles/monitoring.viewer).

  • מפעילים את הגדרת הנראות Enable instrumentation of OpenTelemetry traces and logs (הפעלת מכשור של מעקבים ויומנים של OpenTelemetry). בהתאם לסוג הסוכן, מפעילים את ההגדרה הזו בהגדרות ברמת האפליקציה (עבור סוכן Core Assistant) או בכרטיסייה Configuration של הסוכן (עבור סוכנים שנוצרו על ידי עובדים בכלי לתכנון סוכנים ועבור סוכני Deep Research). מידע נוסף מופיע במאמר בנושא ניהול הגדרות של יכולת תצפית. ההגדרה הזו נדרשת למדדים בהיקף הסוכן. המדדים בהיקף האפליקציה, שמפורטים בקטע Gemini Enterprise Engine, נאספים בלי זה.

שמירת נתונים

המדדים שנוצרו על ידי אפליקציית Gemini Enterprise מאוחסנים ב-Cloud Monitoring בפרויקט Google Cloud , והשמירה שלהם מתבצעת בהתאם למדיניות של Cloud Monitoring. מדדים של Gemini Enterprise מתפרסמים עם הקידומת discoveryengine.googleapis.com/, והם נכללים ברמה 'כל שאר המדדיםGoogle Cloud '. כברירת מחדל, הם נשמרים למשך 6 שבועות. נתונים ישנים יותר מתקופת השמירה נמחקים באופן אוטומטי. כדי לראות את ערכי השמירה המוסמכים והעדכניים ביותר, אפשר לעיין במאמר בנושא שמירת נתונים במסמכי המכסות והמגבלות של Cloud Monitoring.

גישה למדדים ב-Metrics Explorer

כדי לגשת למדדים:

  1. נכנסים לדף Metrics Explorer במסוף Google Cloud .

    לדף Metrics Explorer

  2. בוחרים את הפרויקט Google Cloud שבו נוצרה אפליקציית Gemini Enterprise.

  3. לוחצים על Select a metric (בחירת מדד) כדי לפתוח את סרגל החיפוש.

  4. בסרגל החיפוש, מחפשים את המדדים הבאים:

    שם המדד תיאור
    Gemini Enterprise Agent - Gemini Enterprise Agent Session Count מספר הסשנים שטופלו על ידי סוכן Gemini Enterprise.
    Gemini Enterprise Agent - Gemini Enterprise Agent Tool Count מספר הפעמים שבהן סוכן Gemini Enterprise הפעיל כלים.
    Gemini Enterprise Agent - Gemini Enterprise Agent Turn Count מספר התורות בשיחה בסשנים של סוכן Gemini Enterprise.
    Gemini Enterprise Agent - Gemini Enterprise Agent Total Latency החביון הכולל של התשובות מסוכן Gemini Enterprise.
    Gemini Enterprise Agent - Gemini Enterprise Agent Tool Total Latency החביון הכולל שנוצר כתוצאה מהפעלות של כלים בסוכן Gemini Enterprise.
    Gemini Enterprise DataConnector - Gemini Enterprise DataConnector Request Count המספר הכולל של הבקשות שנשלחו למחברי הנתונים של Gemini Enterprise (נקראים גם מאגרי נתונים במסוף Google Cloud ).
    ‫Gemini Enterprise DataConnector – Gemini Enterprise DataConnector זמני האחזור של הבקשות ‫(Beta) זמן האחזור של בקשות שנשלחות למחברים של נתונים ב-Gemini Enterprise (נקראים גם מאגרי נתונים במסוף Google Cloud ) במילישניות.
    Gemini Enterprise Engine - Gemini Enterprise Engine Request Count המספר הכולל של בקשות שהתקבלו באפליקציית Gemini Enterprise, בכל התנועה לאפליקציה ולא רק מסוכן יחיד. פירוט לפי שיטת API, קוד תגובה קנוני של gRPC , סיווג קוד התגובה, סוג השאילתה והמודל.
    Gemini Enterprise Engine - Gemini Enterprise Engine Request Total Latency הפילוג של זמן האחזור של בקשות מקצה לקצה באפליקציית Gemini Enterprise. נרשם לכל בקשה, כולל בקשות שמחזירות שגיאה.
    Gemini Enterprise Engine – זמן האחזור של Gemini Enterprise Engine עד לקבלת התשובה הראשונה הפיזור של זמן האחזור בין קבלת בקשה לבין סטרימינג של טוקן התשובה הראשון. הערך הזה מתועד רק לבקשות שמניבות לפחות טוקן תשובה אחד.
    ‫Gemini Enterprise Engine – זמן ההמתנה עד לטוקן הראשון של Gemini Enterprise Engine התפלגות זמן האחזור בין קבלת בקשה לבין סטרימינג של הטוקן הראשון, בין אם הטוקן הזה הוא חלק מתהליך החשיבה של המודל או תשובה סופית. הנתון הזה נרשם רק עבור בקשות שמפיקות לפחות אסימון אחד בסטרימינג.

  5. בוחרים את המדד שרוצים לחקור ולוחצים על אישור.

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

    צילום מסך של Metrics Explorer במסוף Google Cloud , שבו מוצגים מדדים של סוכן Gemini Enterprise.

גישה למדדים של סוכנים

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

כדי לגשת למדדים של סוכן:

  1. במסוף Google Cloud , עוברים לאפליקציה ולוחצים על Agents (סוכנים).
  2. בוחרים את הסוכן שרוצים לבדוק ולוחצים על הכרטיסייה Observability (יכולת צפייה).

בכרטיסייה Observability (יכולת תצפית) מוצגים נתוני טלמטריה תפעוליים מרכזיים, שמחולקים לשתי תצוגות: Overview (סקירה כללית) ו-Tools (כלים).

מדדים בדף הסקירה הכללית

בתצוגה הזו יש מרכז שליטה עם סיכום של נתוני סשן סטנדרטיים ונתוני תקינות של סוכנים, כולל:

  • סשנים: סה"כ מספר הסשנים של המשתמשים.
  • משך הזמן הממוצע לסשן: משך הזמן הממוצע שחלף במהלך סשן.
  • הפעלות של סוכן: מספר הפעמים הכולל שבוצעו קריאות לסוכן.
  • זמן הטעינה של הסוכן: זמן הטעינה לאורך זמן ומדדים ספציפיים.
  • תנועה של סוכנים: נפח הבקשות הנכנסות.
  • שיעור השגיאות של הסוכן: אחוז ההפעלות של הסוכן שנכשלו.

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

מדדים של כלים

בתצוגה הזו מתמקדים בשימוש בכלי ובזמן האחזור של כלים שמחוברים לסוכן, כולל:

  • סה"כ קריאות: מספר הבקשות להפעלת הכלי.
  • משך P95 לפי כלי: חביון הביצועים באחוזון ה-95, מסווג לפי כלי.
  • מספר השיחות לפי כלי: המספר הכולל של השיחות חלקי מספר הכלים השונים.
  • שיעור השגיאות לפי כלי: שיעור הכשלים בהרצות לפי כלי.
  • שיעור האינטראקציות שלא הפעילו כלי: השיעור שבו אינטראקציות לא הפעילו כלי.

המאמרים הבאים