هنگامی که یک برافزای منتشر شده 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 مراجعه کنید.