گزارش های خطای پرس و جو برای افزونه های Google Workspace

هنگامی که یک افزونه Google Workspace منتشر شده خطایی را برمی‌گرداند، رابط افزونه یک پیام عمومی را برمی‌گرداند: «هنگام اجرای افزونه مشکلی پیش آمد». با این حال، این خطاها در Cloud Logs Explorer ثبت می شوند.

این راهنما نحوه پرس و جو کردن گزارش های خطای افزونه در Cloud Logs Explorer را شرح می دهد، بنابراین می توانید:

  • بیاموزید که آیا کاربران با خطا مواجه می شوند.
  • ببینید چند وقت یکبار خطاها اتفاق می‌افتند و کدام یک بیشتر هستند.
  • پیام های خطای توصیفی را بخوانید که به شما در رفع آنها کمک می کند.

پیش نیازها

قبل از پرس و جو در گزارش های خطای افزونه:

گزارش های خطای افزونه را پرس و جو کنید

برای دریافت گزارش برای یک افزونه:

  1. کنسول Google Cloud را باز کنید.
  2. در کنار «Google Cloud Platform»، روی پیکان رو به پایین کلیک کنید و پروژه افزودنی را انتخاب کنید.
  3. در گوشه بالا سمت چپ، روی منو > ورود به سیستم کلیک کنید. Logs Explorer باز می شود.
  4. برای لاگ های خطای افزونه، در Query builder عبارت زیر را وارد کنید:

    severity>=ERROR
    protoPayload.serviceName="gsuiteaddons.googleapis.com"
    
  5. برای مشاهده خطاهای اخیر، روی اجرای پرس و جو کلیک کنید. یا برای دیدن خطاها در حین وقوع، روی گزارش‌های جریان کلیک کنید. گزارش‌های خطای افزونه‌ها در بخش «نتایج پرس و جو» ظاهر می‌شوند.

برای اطلاعات بیشتر در مورد 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 مراجعه کنید.