نمایشگر مصرف (که از طریق Ingestion > History در مرکز اقدامات قابل دسترسی است) امکان مشاهده تقریباً بلادرنگ وضعیت، سلامت اعتبارسنجی و تاریخچه پردازش فیدهای محلی مورد نظر را فراهم می‌کند.
از نمایشگر مصرف (Ingestion Viewer) برای ردیابی آپلودهای روزانه فید، نظارت بر سلامت مصرف، بررسی آمار خطای اعتبارسنجی در سطح آیتم و تأیید ورود فایل‌های فید استفاده کنید.
نمای کلی
صفحه اصلی Ingestion Viewer گزارش زمانی معکوس از هر فید دریافتی توسط گوگل را نمایش می‌دهد.
مراحل چرخه عمر مصرف
هر ارسال فید مراحل پردازش متوالی زیر را طی می‌کند:
- دریافت فایل: گوگل فایل فید را با استفاده از SFTP دریافت می‌کند.
- اعتبارسنجی فایل: سیستم، یکپارچگی فایل، خارج کردن از حالت فشرده و قالب کلی طرحواره را تأیید می‌کند.
- استخراج و اعتبارسنجی موجودیت‌ها: این خط لوله، رکوردهای محلی منفرد (
poi_id، آدرس، مختصات، محلی‌سازی‌ها) را تجزیه کرده و از نظر نحو، کامل بودن و انطباق با سیاست‌ها بررسی می‌کند. - تطبیق و تطبیق: موجودیت‌های معتبر به موتور تطبیق گوگل منتقل می‌شوند تا با شناسه‌های مکان گوگل استاندارد برای ارائه خدمات مرتبط شوند.
- تولید گزارش: معیارهای خلاصه و تشخیص مشکلات گروه‌بندی‌شده در Ingestion Viewer منتشر می‌شوند.
پیمایش نمایشگر مصرف
برای مشاهده سابقه مصرف خوراک خود، مراحل زیر را انجام دهید:
- وارد مرکز عملیات شوید.
- صفحه‌ی «مصرف» > «تاریخچه» را باز کنید.
- با استفاده از کنترل‌های ستون، جدول مصرف را فیلتر، مرتب‌سازی و مشاهده کنید.
ستون‌های فهرست مصرف
جدول خلاصه اصلی، ستون‌های زیر را برای هر اجرای مصرف ارائه می‌دهد:
| ستون | نوع داده | توضیحات |
|---|---|---|
| شناسه | String | شناسه منحصر به فرد برای اجرای مصرف. |
| زمان مصرف (UTC) | Timestamp | تاریخ و زمان (به UTC) که گوگل پردازش دریافت فید را آغاز کرده است. |
| نوع بلع | Enum | نوع جمع‌آوری داده‌ها (مثلاً، Feed ). |
| نام | String | نامی برای نوع مصرف خوراک. این google.local_vss خواهد بود. |
| وضعیت | State | وضعیت کلی پردازش مصرف (مثلاً انجام شده، ناموفق). به تعاریف وضعیت مراجعه کنید. |
| رفتار بلع | Enum | تمام فیدهای POI محلی در حالت Batch پردازش می‌شوند. |
| خطاها | Integer | تعداد کل مشکلات اعتبارسنجی در سطح خطای مسدودکننده شناسایی شد. |
| هشدارها | Integer | تعداد کل مشکلات سطح هشدار غیر مسدودکننده شناسایی شده. |
| اقلام | Integer | تعداد کل املاک محلی پردازش شده در این مطالعه. |
تعاریف وضعیت
ستون وضعیت، وضعیت عملیاتی فعلی ارسال فید را نشان می‌دهد:
- انجام شد (
STATUS_COMPLETE): فید با موفقیت دریافت، اعتبارسنجی و بدون خطای مهلک پردازش شد. - ناموفق (
STATUS_FAILED): فرآیند مصرف با خطاهای مهلک طرحواره، خرابی فایل یا خط لوله مواجه شد و نتوانست تکمیل شود. - در حال پردازش (
STATUS_PROCESSING): گوگل به طور فعال در حال اعتبارسنجی، تطبیق و ذخیره داده‌های فید است. - رد شد (
NOT_STARTED): آپلود فید رد شد (برای مثال، اگر مهر زمانی تولید قدیمی‌تر از فید پردازش‌شده قبلی باشد).
مشاهده جزئیات بلع
برای باز کردن نمای جزئیات مصرف، روی هر ردیفی در جدول Ingestion Viewer کلیک کنید. این نما، کارت‌های تشخیصی جامع و پنل‌های توسعه‌ای را برای رفع اشکال ارائه می‌دهد.
پنل‌های جزئیات
صفحه جزئیات مصرف به چهار بخش قابل گسترش تقسیم شده است:
۱. اطلاعات اولیه
نمایش فراداده‌های اصلی در مورد اجرای برنامه:
- زمان مصرف (UTC): مهر زمانی که گوگل شروع به مصرف کرد.
- نوع مصرف:
Feed. - نام:
google.local_vss - رفتار بلع:
Batch - وضعیت: نشان وضعیت با کد رنگی (
Done،Failed،Processing،Skipped).
۲. اعتبارسنجی‌ها
تمام یافته‌های اعتبارسنجی مشاهده‌شده در طول مصرف را فهرست می‌کند:
- خطاهای فایل (کادر راهنما): اگر کل فایل فید با مشکل مواجه شود (برای مثال، به دلیل یک آرشیو غیرقابل خواندن یا سینتکس JSON ناقص)، یک کادر هشدار برجسته، پیام علت اصلی را نمایش می‌دهد.
- مشکلات موجودیت (جدول آکاردئونی): مشکلات اعتبارسنجی در سطح آیتم که بر اساس شدت و کد خطا گروه‌بندی شده‌اند.
- کد خطا: شناسه خطای خاص (مانند
INVALID_ATTRIBUTE_VALUE،MISSING_RECOMMENDED_FIELDیاSAFE_SEARCH_POLICY_VIOLATION_TEXT). - اطلاعات مشکل: شرح تشخیصی که علت اصلی و فیلدهای آسیب‌دیده را توضیح می‌دهد.
- سوابق: تعداد کل دارایی‌های تحت تأثیر این مشکل.
- برای باز کردن شناسه‌های موجودیت نمونه (
poi_id) با لینک‌های مستقیم برای بررسی ویژگی‌ها در نمایشگر موجودی ، روی هر ردیف مسئله کلیک کنید.
- کد خطا: شناسه خطای خاص (مانند
۳. اقلام
کارت‌های امتیازی دلتای موجودی در سطح کالا را برای دوره مصرف ارائه می‌دهد:
- مجموع: تعداد کل املاک محلی پردازش شده.
- اضافه شده: تعداد فهرست‌های کسب‌وکارهای تازه کشف‌شده که به کاتالوگ شما اضافه شده‌اند.
- تغییر یافته: تعداد املاک موجود که ویژگی‌های آنها (مثلاً نام، آدرس، مختصات یا تصاویر) به‌روزرسانی شده است.
- حذف‌شده: تعداد ویژگی‌های حذف‌شده یا از قلم‌افتاده در مقایسه با خط مبنای فید قبلی.
۴. فایل‌ها
نام فایل فید آپلود شده را نمایش می‌دهد:
- نام فایل: نام فایل فید (برای مثال،
local_feed.json.gz).
عیب‌یابی خطاهای بلع
هنگام عیب‌یابی فیدها در Ingestion Viewer، از دستورالعمل‌های زیر استفاده کنید:
| علامت | علت احتمالی | اقدام توصیه شده |
|---|---|---|
وضعیت با خطای فایل Failed است | فایل فشرده ZIP/GZIP خراب، ساختار نادرست JSON یا عدم پشتیبانی از رمزگذاری فایل. | با استفاده از دستورالعمل‌های بسته‌بندی خوراک، مطمئن شوید که خوراک شما به درستی بسته‌بندی شده است. |
تعداد Errors بالا در اعتبارسنجی‌ها | فیلدهای الزامی طرحواره (مانند poi_id ، structured location.address یا مختصات WGS84) در رکوردها وجود ندارند. | آکاردئون Validations توسعه‌یافته را بررسی کنید تا poi_id های مشکل‌دار را شناسایی کنید، خطوط لوله تغذیه POI خود را اصلاح کنید و فید را دوباره وارد کنید. |
صفر Items پردازش شده | فایل Feed خالی است یا تجزیه آرایه JSON در سطح ریشه رکوردها با شکست مواجه شده است. | بررسی کنید که ساختار بسته‌بندی فید شما با مشخصات پیام VssPoi مطابقت داشته باشد. به دستورالعمل‌های بسته‌بندی فید مراجعه کنید. |