‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

יצירת מדדים של Gemini Code Assist

במאמר הזה מוסבר איך ליצור מדדים של Gemini Code Assist. לדוגמה, אתם יכולים ליצור מדדים שמדווחים על השימוש היומי הפעיל או על קבלת המלצות לקוד במגוון מוצרים של Google Cloud Google, כולל Cloud Logging,‏ Google Cloud CLI,‏ Cloud Monitoring ו-BigQuery.

אם אתם צריכים להפעיל את Gemini Code Assist ולראות את היומנים של ההנחיות, התשובות והמטא-נתונים, תוכלו לעיין במאמר בנושא הצגת היומנים של Gemini Code Assist.

מגבלות

הדף הזה מתייחס ספציפית ליצירת מדדים של אינטראקציות משתמשים עם Gemini Code Assist בסביבת פיתוח משולבת (IDE).

למידע על רישום מדדים ביומן עבור Gemini CLI, שדורש הגדרה של Open Telemetry, אפשר לעיין במאמר טלמטריה של Gemini CLI.
‫Gemini Code Assist ב-GitHub לא תומך בכניסה ל- Google Cloud.

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

מוודאים שהגדרתם את Gemini Code Assist בפרויקט.
מוודאים שהפעלתם את הרישום ביומן של Gemini Code Assist בפרויקט.
במסוף Google Cloud , מפעילים את Cloud Shell.

הפעלת Cloud Shell

בחלק התחתון של Google Cloud המסוף יתחיל סשן של Cloud Shell ותופיע הודעה של שורת הפקודה. Cloud Shell היא סביבת מעטפת שבה ה-CLI של Google Cloud מותקן ומוגדרים ערכים לפרויקט הקיים. הסשן יופעל תוך כמה שניות.

הצגת מספר המשתמשים הייחודיים

בהוראות הבאות מוסבר איך להשתמש ב-CLI של gcloud כדי להציג את מספר המשתמשים הייחודיים ב-Gemini Code Assist בפרק הזמן האחרון של 28 יום:

בסביבת מעטפת, מוודאים שעדכנתם את כל הרכיבים המותקנים של ה-CLI של gcloud לגרסה העדכנית:
```
gcloud components update
```

קריאת רשומות היומן של משתמשי Gemini Code Assist והשימוש שלהם:

gcloud logging read 'resource.type=cloudaicompanion.googleapis.com/Instance labels.product=~"code_assist"' \
--freshness 28d \
--project PROJECT_ID \
--format "csv(timestamp.date('%Y-%m-%d'),labels.user_id)"

מחליפים את PROJECT_ID במזהה הפרויקט ב- Google Cloud .

אפשר להשתמש בפקודת Unix‏ uniq כדי לזהות משתמשים באופן ייחודי על בסיס יומי.

הפלט אמור להיראות כך:

2024-10-30,user1@company.com
2024-10-29,user2@company.com
2024-10-29,user2@company.com
2024-10-29,user2@company.com
2024-10-29,user1@company.com
2024-10-28,user1@company.com

יצירת תרשים שמציג את השימוש היומי

בשלבים הבאים מוסבר איך להשתמש בכלי המעקב כדי ליצור גרפים של שימוש יומי שמציגים את המספר הכולל של משתמשים פעילים ב-Gemini Code Assist ביום ואת מספר הבקשות שלהם ביום.

יוצרים מדד מעקב מנתוני היומן שמתעד את מספר המשתמשים ב-Gemini Code Assist:
1. במסוף Google Cloud , נכנסים לדף Logs Explorer:
  כניסה אל Logs Explorer
  
  אם משתמשים בסרגל החיפוש כדי למצוא את הדף הזה, בוחרים בתוצאה שכותרת המשנה שלה היא Logging.
2. בחלונית השאילתה, מזינים את השאילתה הבאה ולוחצים על Run query:
```
 resource.type="cloudaicompanion.googleapis.com/Instance" AND labels.product="code_assist" AND jsonPayload.@type="type.googleapis.com/google.cloud.cloudaicompanion.logging.v1.ResponseLog"
```
  הערה: ערך ברירת המחדל של תקופת הזמן הוא השעה האחרונה, אבל אפשר להגדיר תקופת זמן ארוכה יותר (למשל 7 הימים האחרונים).
3. בסרגל הכלים, לוחצים על פעולות ואז על יצירת מדד.
  
  מופיעה תיבת הדו-שיח Create log-based metric.
4. מגדירים את פרטי המדד הבאים:
  - מוודאים שהאפשרות סוג המדד מוגדרת למונה.
  - נותנים למדד את השם code_assist_example.
  - מוודאים שהאפשרות Filter selection מוגדרת למיקום שבו היומנים מאוחסנים, כלומר Project או Bucket.
    
    מידע על יצירת מדדים של Monitoring מנתוני היומן זמין במאמר סקירה כללית של מדדים מבוססי-יומן.
5. לוחצים על יצירת מדד.
  
  יוצג באנר הצלחה עם הסבר על יצירת המדד.
6. בבאנר ההצלחה, לוחצים על View in Metrics explorer (הצגה בכלי לבחירת מדדים).
  
  Metrics Explorer נפתח ומוצג בו תרשים שהוגדר מראש.
  
  הערה: יכול להיות שיחלפו עד 10 דקות עד שהנתונים יופיעו בתרשים. מידע נוסף מופיע במאמר חסרים נתונים של יומנים במדד.
שמירת התרשים בלוח בקרה:
1. בסרגל הכלים, לוחצים על שמירת התרשים.
2. אופציונלי: מעדכנים את שם התרשים.
3. בתפריט מרכז הבקרה, בוחרים מרכז בקרה קיים בהתאמה אישית או יוצרים מרכז בקרה חדש.
4. לוחצים על שמירת התרשים.

ניתוח השימוש באמצעות BigQuery

בשלבים הבאים מוסבר איך להשתמש ב-BigQuery כדי לנתח את נתוני היומן.

יש שתי גישות שבהן אפשר להשתמש כדי לנתח את נתוני היומנים ב-BigQuery:

יוצרים sink ביומן ומייצאים את נתוני היומן למערך נתונים ב-BigQuery.
שדרגו את קטגוריית היומן שבה מאוחסנים נתוני היומנים כדי להשתמש ב-Observability Analytics, ואז צרו מערך נתונים מקושר ב-BigQuery.

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

בקטע הזה מוסבר איך ליצור sink ביומן כדי לייצא רשומות נבחרות ביומן ל-BigQuery, ומוצגת רשימה של שאילתות לדוגמה. אם אתם רוצים לקבל מידע נוסף על Observability Analytics, תוכלו לעיין במאמרים Query and analyze logs with Observability Analytics (שאילתות וניתוח יומנים באמצעות Observability Analytics) ו-Query a linked BigQuery dataset (שליחת שאילתות למערך נתונים מקושר של BigQuery).

יצירת sink ביומן

במסוף Google Cloud , עוברים לדף Log Router:
עוברים אל Log Router

אם משתמשים בסרגל החיפוש כדי למצוא את הדף הזה, בוחרים בתוצאה שכותרת המשנה שלה היא Logging.
בוחרים את Google Cloud הפרויקט שממנו מגיעים רשומות היומן שרוצים להפנות.
לוחצים על יצירת יעד.
בחלונית פרטי יעד, מזינים את הפרטים הבאים:
- בשדה Sink name (שם יעד), מציינים מזהה ליעד. אחרי שיוצרים את יעד הנתונים, אי אפשר לשנות את השם שלו, אבל אפשר למחוק אותו וליצור יעד נתונים חדש.
- בקטע Sink description (תיאור של יעד), מתארים את המטרה או את תרחיש השימוש של היעד.
בחלונית Sink destination (יעד Sink), מגדירים את הפרטים הבאים:
- בקטע Select sink service (בחירת שירות יעד), בוחרים באפשרות BigQuery dataset (מערך נתונים ב-BigQuery).
- בקטע בחירת מערך נתונים ב-BigQuery, יוצרים מערך נתונים חדש ב-BigQuery ונותנים לו את השם code_assist_bq.
פותחים את החלונית Choose logs to include in sink (בחירת יומנים שיכללו ב-sink), ובשדה Build inclusion filter (יצירת מסנן הכללה) מזינים את הערך הבא:
```
resource.type="cloudaicompanion.googleapis.com/Instance" AND labels.product="code_assist"
```
אופציונלי: כדי לוודא שהזנתם את המסנן הנכון, בוחרים באפשרות תצוגה מקדימה של היומנים. הכלי Logs Explorer ייפתח בכרטיסייה חדשה עם מסנן שאוכלס מראש.
לוחצים על Create sink (יצירת יעד).

נותנים ל-sink ביומן הרשאה לכתוב רשומות ביומן למערך הנתונים

אם יש לכם גישת בעלים למערך הנתונים של BigQuery,‏ Cloud Logging מעניק ל-sink ביומן את ההרשאות הנדרשות לכתיבת נתוני יומן.

אם אין לכם גישת בעלים או אם לא מופיעים רשומות במערך הנתונים, יכול להיות שאין ל-sink ביומן את ההרשאות הנדרשות. כדי לפתור את הבעיה, צריך לפעול לפי ההוראות במאמר הגדרת הרשאות ליעד.

שאילתות

אפשר להשתמש בשאילתות לדוגמה הבאות ב-BigQuery כדי ליצור נתונים ברמת המשתמש וברמה המצטברת לגבי שימוש פעיל יומי והצעות שנוצרו.

לפני שמשתמשים בשאילתות לדוגמה הבאות, צריך לקבל את הנתיב המלא של יעד חדש. כדי לקבל את הנתיב:

במסוף Google Cloud , עוברים לדף BigQuery.

כניסה ל-BigQuery
ברשימת המשאבים, מאתרים את מערך הנתונים שנקרא code_assist_bq. הנתונים האלה הם יעד הנתונים.
בוחרים את טבלת התשובות מתחת ל-code_assist_bq_dataset, לוחצים על הסמל ואז על העתקת המזהה כדי ליצור את מזהה מערך הנתונים. חשוב לשים לב למזהה הזה כדי להשתמש בו כמשתנה GENERATED_BIGQUERY_TABLE בקטעים הבאים.

רשימת משתמשים ספציפיים לפי יום

SELECT DISTINCT labels.user_id as user, DATE(timestamp) as use_date
FROM GENERATED_BIGQUERY_TABLE
ORDER BY use_date

מחליפים את GENERATED_BIGQUERY_TABLE בנתיב המוגדר במלואו של טבלת התשובות של BigQuery שרשמתם בשלבים הקודמים ליצירת sink.

רשימת משתמשים מצטברים לפי יום

SELECT COUNT(DISTINCT labels.user_id) as total_users, DATE(timestamp) as use_date
FROM GENERATED_BIGQUERY_TABLE
GROUP BY use_date
ORDER BY use_date

הצגת בקשות פרטניות לפי משתמש ביום

SELECT COUNT(*), DATE(timestamp) as use_date, labels.user_id as user
FROM GENERATED_BIGQUERY_TABLE
GROUP BY use_date, user
ORDER BY use_date

רשימת בקשות מצטברות ליום לפי תאריך

SELECT COUNT(*), DATE(timestamp) as use_date
FROM GENERATED_BIGQUERY_TABLE
GROUP BY use_date
ORDER BY use_date