نمایشگر مصرف (که از طریق Ingestion > History در مرکز اقدامات قابل دسترسی است) امکان مشاهده تقریباً بلادرنگ وضعیت، سلامت اعتبارسنجی و تاریخچه پردازش فیدهای مورد نظر را فراهم میکند.
از نمایشگر مصرف (Ingestion Viewer) برای ردیابی آپلودهای روزانه فید، نظارت بر سلامت مصرف، بررسی آمار خطای اعتبارسنجی در سطح آیتم و تأیید ورود فایلهای فید استفاده کنید.
نمای کلی
صفحه اصلی Ingestion Viewer گزارش وقایع هر فید POI دریافت شده توسط گوگل را به صورت معکوس و با ترتیب زمانی نمایش میدهد.
مراحل چرخه عمر مصرف
هر ارسال فید مراحل پردازش متوالی زیر را طی میکند:
- دریافت فایل: گوگل فایل فید را از طریق SFTP دریافت میکند.
- اعتبارسنجی فایل: سیستم، یکپارچگی فایل، خارج کردن از حالت فشرده و قالب کلی طرحواره را تأیید میکند.
- استخراج و اعتبارسنجی موجودیتها: این خط لوله، رکوردهای اقامتی تکی (
poi_id، آدرس، مختصات، محلیسازیها) را تجزیه کرده و از نظر نحو، کامل بودن و انطباق با سیاستها بررسی میکند. - تطبیق و تطبیق: موجودیتهای معتبر به موتور تطبیق گوگل منتقل میشوند تا با شناسههای مکان گوگل استاندارد برای ارائه خدمات مرتبط شوند.
- تولید گزارش: معیارهای خلاصه و تشخیص مشکلات گروهبندیشده در Ingestion Viewer منتشر میشوند.
پیمایش نمایشگر مصرف
برای مشاهده سابقه مصرف خوراک خود، مراحل زیر را انجام دهید:
- وارد مرکز اقدامات شوید.
- صفحهی «مصرف» > «تاریخچه» را باز کنید.
- با استفاده از کنترلهای ستون، جدول مصرف را فیلتر، مرتبسازی و مشاهده کنید.
ستونهای فهرست مصرف
جدول خلاصه اصلی، ستونهای زیر را برای هر اجرای مصرف ارائه میدهد:
| ستون | نوع داده | توضیحات |
|---|---|---|
| شناسه | رشته | شناسه منحصر به فرد برای اجرای مصرف. |
| زمان مصرف (UTC) | مهر زمانی | تاریخ و زمان (به UTC) که گوگل پردازش دریافت فید را آغاز کرده است. |
| نوع بلع | شمارشی | نوع جمعآوری دادهها (مثلاً، تغذیه). |
| نام | رشته | نام نوع مصرف خوراک. این google.lodging_vss خواهد بود. |
| وضعیت | ایالت | وضعیت کلی پردازش مصرف (مثلاً انجام شده، ناموفق). به تعاریف وضعیت مراجعه کنید. |
| رفتار بلع | شمارشی | تمام فیدهای POI اقامتگاه در حالت "دستهای" پردازش میشوند. |
| خطاها | عدد صحیح | تعداد کل مشکلات اعتبارسنجی در سطح خطای مسدودکننده شناسایی شد. |
| هشدارها | عدد صحیح | تعداد کل مشکلات سطح هشدار غیر مسدودکننده شناسایی شده. |
| اقلام | عدد صحیح | تعداد کل اقامتگاههای پردازششده در این دوره. |
تعاریف وضعیت
ستون وضعیت، وضعیت عملیاتی فعلی ارسال فید را نشان میدهد:
- انجام شد: فید با موفقیت دریافت، اعتبارسنجی و بدون خطای مهلک پردازش شد.
- ناموفق: عملیات بلع با خطاهای مهلک طرحواره، خرابی فایل یا خط لوله مواجه شد و نتوانست تکمیل شود.
- پردازش: گوگل به طور فعال در حال اعتبارسنجی، تطبیق و ذخیره دادههای فید است.
- رد شد: آپلود فید رد شد (برای مثال، اگر مهر زمان تولید قدیمیتر از فید پردازششده قبلی باشد).
مشاهده جزئیات بلع
برای باز کردن نمای جزئیات مصرف، روی هر ردیفی در جدول Ingestion Viewer کلیک کنید. این نما، کارتهای تشخیصی جامع و پنلهای توسعهای را برای رفع اشکال ارائه میدهد.
پنلهای جزئیات
صفحه جزئیات مصرف به چهار بخش قابل گسترش تقسیم شده است:
۱. اطلاعات اولیه
نمایش فرادادههای اصلی در مورد اجرای برنامه:
- زمان مصرف (UTC): مهر زمانی که گوگل شروع به مصرف کرد.
- نوع مصرف: خوراک دام.
- نام:
google.lodging_vss - رفتار بلع: دستهای.
- وضعیت: نشان وضعیت با کد رنگی (انجام شده، ناموفق، در حال پردازش، رد شده).
- زمان تولید شده (UTC): مهر زمانی که شریک، محتوای فید را تولید کرده است (در صورت اعلام در سرآیندهای فید).
۲. اعتبارسنجیها
تمام یافتههای اعتبارسنجی مشاهدهشده در طول مصرف را فهرست میکند:
- خطاهای فایل (کادر راهنما): اگر کل فایل فید با مشکل مواجه شود (برای مثال، به دلیل یک آرشیو غیرقابل خواندن یا سینتکس JSON ناقص)، یک کادر هشدار برجسته، پیام علت اصلی را نمایش میدهد.
- مشکلات موجودیت (جدول آکاردئونی): مشکلات اعتبارسنجی در سطح آیتم که بر اساس شدت و کد خطا گروهبندی شدهاند.
- کد خطا: شناسه خطای خاص (مانند
MISSING_REQUIRED_FIELD،INVALID_LATLNGیاSAFE_SEARCH_POLICY_VIOLATION_IMAGE). - اطلاعات مشکل: شرح تشخیصی که علت اصلی و فیلدهای آسیبدیده را توضیح میدهد.
- سوابق: تعداد کل داراییهای تحت تأثیر این مشکل.
- برای باز کردن شناسههای موجودیت نمونه (
poi_id) با لینکهای مستقیم برای بررسی ویژگیها در نمای موجودی، روی هر ردیف مسئله کلیک کنید.
- کد خطا: شناسه خطای خاص (مانند
۳. اقلام
کارتهای امتیازی دلتای موجودی در سطح کالا را برای دوره مصرف ارائه میدهد:
- مجموع: تعداد کل اقامتگاههای پردازششده.
- اضافه شده: تعداد هتلهای تازه کشف شده که به کاتالوگ شما اضافه شدهاند.
- تغییر یافته: تعداد املاک موجود که ویژگیهای آنها (مثلاً نام، آدرس، مختصات یا تصاویر) بهروزرسانی شده است.
- حذفشده: تعداد ویژگیهای حذفشده یا از قلمافتاده در مقایسه با خط مبنای فید قبلی.
۴. فایلها
نام فایل فید آپلود شده را نمایش میدهد:
- نام فایل: نام فایل فید (برای مثال،
lodging_feed.json.gz).
عیبیابی خطاهای بلع
هنگام عیبیابی فیدها در Ingestion Viewer، از دستورالعملهای زیر استفاده کنید:
| علامت | علت احتمالی | اقدام توصیه شده |
|---|---|---|
| وضعیت با خطای فایل ناموفق است | فایل فشرده ZIP/GZIP خراب، ساختار نادرست JSON یا عدم پشتیبانی از رمزگذاری فایل. | با استفاده از دستورالعملهای بستهبندی خوراک، مطمئن شوید که خوراک شما به درستی بستهبندی شده است. |
| تعداد خطاهای بالا در اعتبارسنجیها | فیلدهای الزامی طرحواره (مانند poi_id ، structured location.address یا مختصات WGS84) در رکوردها وجود ندارند. | آکاردئون Validations توسعهیافته را بررسی کنید تا poi_id های مشکلدار را شناسایی کنید، خطوط لوله تغذیه POI خود را اصلاح کنید و فید را دوباره وارد کنید. مشکلات مربوط به موجودیتهای منفرد را در نمای موجودی بررسی کنید. |
| صفر مورد پردازش شده | فایل Feed خالی است یا تجزیه آرایه JSON در سطح ریشه رکوردها با شکست مواجه شده است. | بررسی کنید که ساختار بستهبندی فید شما با مشخصات پیام VssPoi مطابقت داشته باشد. به دستورالعملهای بستهبندی فید مراجعه کنید. |