הכלי Ingestion Viewer (אפשר לגשת אליו דרך Ingestion > History ב-Actions Center) מאפשר לראות כמעט בזמן אמת את הסטטוס, את תקינות האימות ואת היסטוריית העיבוד של פידים של נקודות עניין מקומיות.
בעזרת הכלי Ingestion Viewer אפשר לעקוב אחרי העלאות פידים יומיות, לבדוק את תקינות ההטמעה, לבדוק נתונים סטטיסטיים של שגיאות אימות ברמת הפריט ולוודא שקבצי הפיד הגיעו.
סקירה כללית
בדף הראשי של הכלי Ingestion Viewer מוצג יומן של כל פיד שמתקבל ב-Google, בסדר כרונולוגי הפוך.
שלבים במחזור החיים של הטמעת נתונים
כל פיד עובר את שלבי העיבוד הבאים:
- אחזור קובץ: Google מקבלת את קובץ הפיד באמצעות SFTP.
- אימות הקובץ: המערכת מאמתת את תקינות הקובץ, את הפריסה שלו ואת פורמט הסכימה הכולל.
- חילוץ ואימות של ישויות: הצינור מנתח רשומות מקומיות ספציפיות (
poi_id, כתובת, קואורדינטות, לוקליזציות) ובודק את התחביר, את השלמות ואת העמידה בדרישות המדיניות. - התאמה וקישור: ישויות תקינות מועברות למנוע ההתאמה של Google כדי לקשר אותן למזהי מקומות קנוניים ב-Google לצורך הצגה.
- יצירת דוח: מדדי סיכום ואבחון בעיות מקובצות מתפרסמים בכלי לבדיקת נתונים.
ניווט בכלי Ingestion Viewer
כדי לראות את היסטוריית הטמעת הפיד:
- נכנסים לActions Center.
- פותחים את הדף 'היסטוריה' בקטע 'העברה'.
- אפשר לסנן, למיין ולצפות בטבלת ההטמעה באמצעות אמצעי הבקרה של העמודות.
עמודות של רשימת ההטמעה
בטבלת הסיכום הראשית מוצגות העמודות הבאות לכל הרצת הטמעה:
| עמודה | סוג הנתונים | תיאור |
|---|---|---|
| מזהה | String
|
מזהה ייחודי של ההפעלה של תהליך ההטמעה. |
| השעה שבה הנתונים נבלעו (UTC) | Timestamp
|
התאריך והשעה (בפורמט UTC) שבהם Google התחילה לעבד את ההזנה. |
| סוג הטמעת הנתונים | Enum
|
סוג איסוף הנתונים (לדוגמה,
Feed). |
| שם | String
|
שם סוג ההעלאה של הפיד. הערך יהיה google.local_vss. |
| סטטוס | State
|
מצב העיבוד הכולל של ההעלאה (למשל, בוצעה, נכשלה). הגדרות הסטטוס |
| התנהגות הטמעת הנתונים | Enum
|
כל הפידים של נקודות העניין המקומיות מעובדים במצב Batch. |
| שגיאות | Integer
|
המספר הכולל של בעיות אימות ברמת שגיאה שזוהו. |
| אזהרות | Integer
|
המספר הכולל של בעיות לא חוסמות ברמת האזהרה שזוהו. |
| פריטים | Integer
|
המספר הכולל של נכסים מקומיים שעברו עיבוד בתהליך ההעברה הזה. |
הגדרות סטטוס
בעמודה סטטוס מוצג המצב התפעולי הנוכחי של שליחת פיד:
- הושלם (
STATUS_COMPLETE): הפיד נקלט, אומת ועבר עיבוד בהצלחה ללא שגיאות קריטיות. - נכשל (
STATUS_FAILED): תהליך ההטמעה נתקל בשגיאות קריטיות בסכימה, בקובץ פגום או בצינור עיבוד הנתונים, ולא הצליח להסתיים. - בעיבוד (
STATUS_PROCESSING): Google מאמתת, מתאימה ומאחסנת את נתוני הפיד. - דילוג (
NOT_STARTED): המערכת דילגה על העלאת הפיד (לדוגמה, אם חותמת הזמן של היצירה ישנה יותר מפיד שעבר עיבוד בעבר).
תצוגת פרטי הטמעה
כדי לפתוח את התצוגה של פרטי ההעברה, לוחצים על שורה כלשהי בטבלה של הכלי לבדיקת העברה. בתצוגה הזו יש כרטיסי אבחון מקיפים ולוחות הרחבה לניפוי באגים.
חלוניות פרטים
הדף 'פרטי ההעברה' מחולק לארבעה קטעים שאפשר להרחיב:
1. מידע בסיסי
מוצגים מטא-נתונים מרכזיים לגבי הרצת הביצוע:
- הזמן שבו המערכת קלטה את הנתונים (UTC): חותמת הזמן שבה Google התחילה את הקליטה.
- סוג ההטמעה:
Feed. - שם:
google.local_vss - התנהגות ההטמעה:
Batch - סטטוס: תג סטטוס עם קידוד צבעים (
Done,Failed,Processing,Skipped).
2. פורמטים מאושרים
רשימה של כל הממצאים שזוהו במהלך האימות בזמן ההטמעה:
- שגיאות בקובץ (תיבת הסבר): אם כל קובץ הפיד נכשל (לדוגמה, בגלל ארכיון שלא ניתן לקריאה או תחביר JSON פגום), תוצג תיבת הסבר בולטת עם הודעה על סיבת השורש.
- בעיות בישות
(טבלת אקורדיון): בעיות אימות ברמת הפריט שמקובצות לפי חומרה וקוד שגיאה.
- קוד הבעיה: מזהה שגיאה ספציפי (למשל
INVALID_ATTRIBUTE_VALUE,MISSING_RECOMMENDED_FIELDאוSAFE_SEARCH_POLICY_VIOLATION_TEXT). - פרטי הבעיה: תיאור אבחוני שמסביר את שורש הבעיה ואת השדות המושפעים.
- רשומות: המספר הכולל של ישויות הנכס שהושפעו מהבעיה הזו.
- לוחצים על שורה של בעיה כלשהי כדי להרחיב את מזהי הישויות לדוגמה (
poi_id) עם קישורים ישירים לבדיקת המאפיינים בכלי לבדיקת מלאי שטחי הפרסום.
- קוד הבעיה: מזהה שגיאה ספציפי (למשל
3. פריטים
מספק לוחות בקרה עם נתוני דלתא של מלאי שטחי פרסום ברמת הפריט עבור הרצת ההטמעה:
- סה"כ: המספר הכולל של נכסים מקומיים שעברו עיבוד.
- נוספו: מספר הדפים העסקיים החדשים שנוספו לקטלוג.
- השתנה: מספר הנכסים הקיימים שהמאפיינים שלהם (לדוגמה, שם, כתובת, קואורדינטות או תמונות) עודכנו.
- הוסרו: מספר הנכסים שהושמטו או שהוסרו בהשוואה לנתוני הבסיס הקודמים של הפיד.
4. קבצים
השם של קובץ הפיד שהועלה:
- שם הקובץ: שם קובץ הפיד (לדוגמה,
local_feed.json.gz).
פתרון בעיות שקשורות לטמעת נתונים
כשמנסים לפתור בעיות בפידים בכלי לבדיקת הטמעת נתונים, חשוב לפעול לפי ההנחיות הבאות:
| תיאור הבעיה | סיבה אפשרית | הפעולה המומלצת |
|---|---|---|
הסטטוס הוא
Failed עם
שגיאה בקובץ
|
ארכיון ZIP/GZIP פגום, תחביר JSON לא תקין או קידוד קבצים לא נתמך. | מוודאים שהפיד ארוז בצורה נכונה באמצעות הנחיות לאריזת פידים. |
ערך גבוה
Errors
במספר
האימותים
|
שדות חובה בסכימה (כמו poi_id, location.address או קואורדינטות WGS84) חסרים ברשומות. |
בודקים את האימותים באקורדיון המורחב כדי לזהות את poi_ids הבעייתיים, מתקנים את פייפליינים של פיד נקודות העניין ומייבאים מחדש את הפיד.
|
Zero
Items
processed
|
קובץ הפיד ריק או שהרשומות נכשלו בניתוח של מערך JSON ברמת הבסיס. | בודקים שמבנה העטיפה של הפיד תואם למפרט ההודעות של VssPoi. אפשר לעיין בהנחיות לאריזת פידים.
|