Gemini Enterprise מספק ללקוחות את Cloud Logging כדי לעקוב אחרי שגיאות ואזהרות כשהם מחברים את הנתונים שלהם ל-Gemini Enterprise.
במאמר הזה מוסבר איך לגשת ליומני השגיאות של מחברים מאוחדים ושל מחברי הטמעה ב-Gemini Enterprise באמצעות Cloud Logging.
מושגים מרכזיים
בקטע הזה נסביר על מושגי מפתח שקשורים לניטור ב-Gemini Enterprise.
| קונספט | תיאור |
|---|---|
| יומני שגיאות של מחבר Gemini Enterprise | ביומני השגיאות של המחבר של Gemini Enterprise מתועדות שגיאות ותקלות שמתרחשות במהלך השילוב של Gemini Enterprise עם מקורות נתונים של צד שלישי, כמו Jira ו-Microsoft OneDrive. היומנים האלה כוללים בעיות בחיבור, בעיות בהמרת נתונים ושגיאות API. |
לפני שמתחילים
לפני שאתם ניגשים ליומני השגיאות, חשוב לוודא שביצעתם את הפעולות הבאות:
כדי להפעיל את הרישום ביומן, צריך להיות לכם את התפקיד אדמין ב-Gemini Enterprise ב-IAM (
roles/discoveryengine.agentspaceAdmin).כדי לגשת ל-Cloud Logging, צריך את תפקיד ה-IAM צפייה ביומנים (
roles/logging.viewer).יצרתם אפליקציית Gemini Enterprise. כדי ליצור אפליקציה, עיינו במאמר יצירת אפליקציה.
לוודא שמאגרי הנתונים מוגדרים בצורה נכונה ושהם פעילים. מידע נוסף על הגדרת מאגרי נתונים זמין במאמרים קישור מקור נתונים של הנתונים בחשבון Google או קישור מקור נתונים של צד שלישי.
הפעלתם את הגדרות הניטור כדי לראות את יומני השגיאות של המחבר המשותף. מידע נוסף מופיע במאמר הפעלת הגדרות ניראות.
גישה ליומני השגיאות של המחבר המאוחזר
כדי לראות את יומני השגיאות של מאגרי הנתונים שמקושרים ל-Gemini Enterprise באמצעות איחוד נתונים:
במסוף Google Cloud , נכנסים לדף Gemini Enterprise.
בתפריט הניווט, לוחצים על מאגרי נתונים.
בוחרים את מאגר הנתונים הרצוי.
לוחצים על View Logs. הדף Logs Explorer ייפתח.
כדי לראות רק את היומנים של המחבר של 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 .
-
כדי לצמצם את היקף השאילתה, אפשר להשתמש במסנן. לדוגמה, לוחצים על All severities ובוחרים באפשרות Error and higher. למידע נוסף על חידוד השאילתות, ראו שאילתות לדוגמה.
גישה ליומני השגיאות של מחבר ההטמעה
כדי לראות את יומני השגיאות של מאגרי הנתונים שמחוברים ל-Gemini Enterprise באמצעות הטמעת נתונים:
במסוף Google Cloud , נכנסים לדף Gemini Enterprise.
בתפריט הניווט, לוחצים על מאגרי נתונים.
בוחרים את מאגר הנתונים הרצוי.
לוחצים על View Logs. הדף Logs Explorer ייפתח.
כברירת מחדל, בדף Logs Explorer מתבצע חיפוש של רשומות יומן במשאבים שמופיעים בהיקף היומן שמוגדר כברירת מחדל. כדי לסנן את היומנים של Gemini Enterprise, מבצעים אחת מהפעולות הבאות:
- בוחרים באפשרות All Resources > Consumed API > Discovery Engine API ולוחצים על Apply.
מזינים את השאילתה הבאה בסרגל השאילתות ולוחצים על Run Query:
resource.type="consumed_api" resource.labels.service="discoveryengine.googleapis.com"
כדי לצמצם את היקף השאילתה, אפשר לסנן לפי מטא-נתונים של JSON. לדוגמה, כדי לשלוח שאילתה ליומני ה-method
ImportDocuments, מבצעים אחת מהפעולות הבאות:מזינים את הטקסט הבא בסרגל השאילתות:
jsonPayload.context.reportLocation.functionName=~"ImportDocuments"מרחיבים את המטא-נתונים בפורמט JSON ולוחצים כדי לסנן:
איור 1. סינון בלחיצה על מטא-נתונים של JSON
ברוב האזהרות והשגיאות, הפרטים מופיעים ב-
jsonPayload.messageוב-jsonPayload.status.כדי לנתח את היומנים לעומק, אפשר להעביר אותם ל-sink ביומן כמו BigQuery. למידע נוסף, קראו את המאמר ניתוב יומנים ליעדים נתמכים במסמכי התיעוד של Google Cloud Observability.