هنگامی که یک افزونه Google Workspace منتشر شده خطایی را برمی‌گرداند، رابط افزونه یک پیام عمومی را برمی‌گرداند: «هنگام اجرای افزونه مشکلی پیش آمد». با این حال، این خطاها در Cloud Logs Explorer ثبت می شوند.
این راهنما نحوه پرس و جو کردن گزارش های خطای افزونه در Cloud Logs Explorer را شرح می دهد، بنابراین می توانید:
- بیاموزید که آیا کاربران با خطا مواجه می شوند.
- ببینید چند وقت یکبار خطاها اتفاق می‌افتند و کدام یک بیشتر هستند.
- پیام های خطای توصیفی را بخوانید که به شما در رفع آنها کمک می کند.
پیش نیازها
قبل از پرس و جو در گزارش های خطای افزونه:
- "Cloud Logging API" را در پروژه Google Cloud افزونه فعال کنید. برای فعال کردن API، به Create a Cloud project مراجعه کنید و API را فعال کنید .
- افزونه را در Google Workspace Marketplace منتشر کنید. برای انتشار یک افزونه در Marketplace، به انتشار یک برنامه مراجعه کنید.
گزارش های خطای افزونه را پرس و جو کنید
برای دریافت گزارش برای یک افزونه:
- کنسول Google Cloud را باز کنید.
- در کنار «Google Cloud Platform»، روی پیکان رو به پایین کلیک کنید و پروژه افزودنی را انتخاب کنید.
- در گوشه بالا سمت چپ، روی منو > ورود به سیستم کلیک کنید. Logs Explorer باز می شود.
برای لاگ های خطای افزونه، در Query builder عبارت زیر را وارد کنید:
severity>=ERROR protoPayload.serviceName="gsuiteaddons.googleapis.com"برای مشاهده خطاهای اخیر، روی اجرای پرس و جو کلیک کنید. یا برای دیدن خطاها در حین وقوع، روی گزارش‌های جریان کلیک کنید. گزارش‌های خطای افزونه‌ها در بخش «نتایج پرس و جو» ظاهر می‌شوند.
برای اطلاعات بیشتر در مورد Cloud Logs Explorer و نوشتن پرس و جوها، به موارد زیر مراجعه کنید:
فعال یا غیرفعال کردن ثبت خطا
به طور پیش فرض، ثبت خطا فعال است. هنگامی که ثبت خطا فعال است، فایل مانیفست دارای موارد زیر است:
"exceptionLogging": "STACKDRIVER",
برای غیرفعال کردن ثبت خطا، "exceptionLogging": "STACKDRIVER", را با خط زیر در فایل مانیفست جایگزین کنید:
// Disable error logging
"exceptionLogging": "NONE"
برای فعال کردن مجدد ثبت خطا، "exceptionLogging": "NONE" با "exceptionLogging": "STACKDRIVER", جایگزین کنید.
ملاحظات
هنگام کار با گزارش های خطای افزونه در Cloud Logs Explorer، به این نکات توجه داشته باشید:
- افزونه‌ها فقط خطاهای ورود به سیستم را در Logs Explorer دارند. سایر انواع گزارش ثبت نشده است.
- پیام های خطا همیشه به زبان انگلیسی نوشته می شوند.
- Cloud Logging هزینه دارد. برای اطلاعات بیشتر درباره قیمت‌گذاری Cloud Logging، به قیمت‌گذاری Google Cloud Observability مراجعه کنید.