גישה ליומני שגיאות של מחבר Gemini Enterprise באמצעות Cloud Logging

‫Gemini Enterprise מספק ללקוחות Cloud Logging כדי לעקוב אחרי שגיאות ואזהרות כשמחברים את הנתונים שלהם ל-Gemini Enterprise.

במאמר הזה מוסבר איך לגשת ליומני שגיאות של מחבר מאוחד וליומני שגיאות של מחבר הטמעה ב-Gemini Enterprise באמצעות Cloud Logging.

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

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

קונספט	תיאור
יומני שגיאות של מחבר Gemini Enterprise	ב-Gemini Enterprise connector error logs מתועדות שגיאות וכשלים שמתרחשים כשמשלבים את Gemini Enterprise עם מקורות נתונים של צד שלישי, כמו Jira ו-Microsoft OneDrive. היומנים האלה כוללים בעיות בחיבור, בעיות בהמרת נתונים ושגיאות API.

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

לפני שאתם ניגשים ליומני השגיאות, חשוב לוודא שביצעתם את הפעולות הבאות:

• כדי להפעיל את הרישום ביומן, צריך להיות לכם תפקיד אדמין ב-IAM‏ (roles/discoveryengine.agentspaceAdmin) מסוג Gemini Enterprise Admin.

• כדי לגשת ל-Cloud Logging, צריך לקבל את תפקיד ה-IAM‏ Logs Viewer (roles/logging.viewer).

• יצרתם אפליקציית Gemini Enterprise. כדי ליצור אפליקציה, אפשר לעיין במאמר בנושא יצירת אפליקציה.

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

• הפעלתם את הגדרות ה-Observability כדי לראות את יומני השגיאות של המחבר המאוחד. מידע נוסף מופיע במאמר בנושא הפעלת הגדרות של יכולת תצפית.

גישה ליומני שגיאות של מחבר מאוחד

מונח חשוב: ב-Gemini Enterprise, אפשר להשתמש במונח אפליקציה לסירוגין עם המונח מנוע בהקשר של ממשקי API. מנוע Gemini Enterprise הוא מנוע חיפוש כללי שבו השדה app_type מוגדר לערך APP_TYPE_INTRANET.

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

1. נכנסים לדף Gemini Enterprise במסוף Google Cloud .

   ‫Gemini Enterprise

2. בתפריט הניווט, לוחצים על מאגרי נתונים.

3. בוחרים מאגר נתונים.

4. לוחצים על הצגת יומנים. ייפתח הדף Logs Explorer.

5. כדי לראות רק את היומנים של מחבר Gemini Enterprise, מזינים את השאילתה הבאה בשדה עורך השאילתות ולוחצים על Run Query:

    logName="projects/PROJECT_ID/logs/discoveryengine.googleapis.com%2Fconnector_activity"
    jsonPayload.LogMetadata.name="projects/PROJECT_ID/locations/LOCATION/collections/COLLECTION_ID/dataConnector"
   

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

   • ‫PROJECT_ID: מזהה הפרויקט.
   • ‫LOCATION: המיקום של מתקן הטעינה. לדוגמה, global.
   • ‫COLLECTION_ID: המזהה של האוסף שמכיל את המחבר, שהוא גם המזהה של מאגר הנתונים בGoogle Cloud מסוף.

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

גישה ליומני שגיאות של מחבר הטמעה

מונח חשוב: ב-Gemini Enterprise, אפשר להשתמש במונח אפליקציה לסירוגין עם המונח מנוע בהקשר של ממשקי API. מנוע Gemini Enterprise הוא מנוע חיפוש כללי שבו השדה app_type מוגדר לערך APP_TYPE_INTRANET.

כדי לראות את יומני השגיאות של מאגרי הנתונים שמקושרים ל-Gemini Enterprise באמצעות העברת נתונים, פועלים לפי השלבים הבאים:

1. נכנסים לדף Gemini Enterprise במסוף Google Cloud .

   ‫Gemini Enterprise

2. בתפריט הניווט, לוחצים על מאגרי נתונים.

3. בוחרים מאגר נתונים.

4. לוחצים על הצגת יומנים. ייפתח הדף Logs Explorer.

5. כברירת מחדל, בדף Logs Explorer מתבצע חיפוש של רשומות יומן במשאבים שמפורטים בהיקף היומן שמוגדר כברירת מחדל. כדי לסנן את היומנים של Gemini Enterprise, מבצעים אחת מהפעולות הבאות:

   • בוחרים באפשרות All Resources > Consumed API > Discovery Engine API (כל המשאבים > API בשימוש > Discovery Engine API) ואז לוחצים על Apply (החלה).

   • מזינים את השאילתה הבאה בסרגל השאילתות ולוחצים על Run Query:

     resource.type="consumed_api"
     resource.labels.service="discoveryengine.googleapis.com"
     

6. כדי לצמצם את היקף השאילתה, אפשר לסנן לפי מטא-נתונים של JSON. לדוגמה, כדי לשלוח שאילתה ליומנים של שיטת ImportDocuments, מבצעים אחת מהפעולות הבאות:

   • מזינים את הטקסט הבא בסרגל השאילתות:

     jsonPayload.context.reportLocation.functionName=~"ImportDocuments"
     

   • מרחיבים את המטא-נתונים בפורמט JSON ולוחצים כדי לסנן:

     

     איור 1. סינון באמצעות לחיצה על מטא-נתונים בפורמט JSON

7. ברוב המקרים, פרטים על האזהרות והשגיאות מופיעים בjsonPayload.message ובjsonPayload.status.

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