تنظیم و ارسال هشدارهای سفارشی به کانال‌های اعلان سفارشی

فایربیس هشدارهای پیش‌فرض Crashlytics را ارائه می‌دهد (به صفحه مرور کلی هشدارها مراجعه کنید). با این حال، این هشدارهای پیش‌فرض و کانال‌های اعلان آنها ممکن است برای نیازهای شما کافی نباشند.

در این موارد، می‌توانید از Cloud Monitoring برای ارسال هشدارهای سفارشی به کانال‌های اعلان سفارشی بر اساس داده‌های Crashlytics (و به صورت اختیاری داده‌های جلسات Firebase) که به Cloud Logging صادر کرده‌اید، استفاده کنید.

برای استفاده از Cloud Monitoring برای هشدارهای سفارشی، شما یک سیاست هشداردهی تنظیم می‌کنید که شرایطی را که می‌خواهید تحت آن هشدار دریافت کنید و نحوه اطلاع‌رسانی را شرح می‌دهد.

برای مثال، اگر نرخ بدون خرابی شما از یک آستانه خاص پایین‌تر برود، Cloud Monitoring می‌تواند یک پیام هشدار سفارشی به یک آدرس ایمیل خاص ارسال کند یا آن را به یک سرویس شخص ثالث مانند Discord، Slack یا Jira ارسال کند. همچنین می‌توانید اطلاعات ارسال شده در هشدار را کاملاً سفارشی کنید، مانند افزودن لینک‌های مفید به کنسول Firebase یا اطلاعات عیب‌یابی خاص شرکت.

در مستندات Google Cloud ، درباره Cloud Monitoring و هشدارها ، از جمله قیمت‌گذاری، اطلاعات بیشتری کسب کنید.

پیش‌نیازها

1. مطمئن شوید که پروژه Firebase شما در طرح قیمت‌گذاری Blaze با پرداخت به ازای استفاده قرار دارد.

2. تنظیم خروجی گرفتن از داده‌های Crashlytics و (به صورت اختیاری) از داده‌های جلسات Firebase به Cloud Logging .

3. کانال‌های اطلاع‌رسانی را تنظیم کنید.

تنظیم سیاست هشداردهی

موارد زیر دستورالعمل‌های سطح بالا هستند؛ برای دستورالعمل‌های دقیق، به مستندات Google Cloud مراجعه کنید (برای مثال: ایجاد سیاست‌های هشداردهی با آستانه متریک یا استفاده از PromQL برای ایجاد سیاست‌های هشداردهی ).

به عنوان بخشی از اجرای کوئری‌ها، می‌توانید یک هشدار مبتنی بر لاگ یا یک هشدار مبتنی بر SQL تنظیم کنید:

• یک هشدار مبتنی بر گزارش تنظیم کنید:

  1. یک پرس‌وجو (query) را در Logs Explorer اجرا کنید.

  2. روی دکمه‌ی «افزودن هشدار» که ظاهر می‌شود کلیک کنید.

  3. برای افزودن هشدار مبتنی بر گزارش، دستورالعمل‌های روی صفحه را دنبال کنید.

• یک هشدار مبتنی بر SQL تنظیم کنید:

  1. یک کوئری در Logs Analytics اجرا کنید.

  2. روی دکمه‌ی «افزودن هشدار» که ظاهر می‌شود کلیک کنید.

  3. برای افزودن هشدار مبتنی بر SQL، دستورالعمل‌های روی صفحه را دنبال کنید.

از طرف دیگر، می‌توانید با استفاده از ابزار پیکربندی خط‌مشی در کنسول Google Cloud ، هشدارهایی را برای معیارهای مبتنی بر گزارش خود تنظیم کنید، جایی که می‌توانید یکی از گزینه‌های زیر را انتخاب کنید:

• سازنده : رابط کاربری کنسول، یک گردش کار هدایت‌شده برای ساخت سیاست هشداردهی ارائه می‌دهد.

• PromQL : شما یک پرس‌وجوی PromQL برای سیاست هشدار خود ارائه می‌دهید.

  مثال پرس و جوی PromQL

  برای مثال، فرض کنید دو معیار مبتنی بر لاگ برای داده‌های جلسات Crashlytics و Firebase خود ایجاد کرده‌اید:

  • یک معیار به نام firebase/crashlytics_events با برچسب errorType و به صورت زیر تعریف می‌شود:

    logName="projects/ PROJECT_ID /logs/firebasecrashlytics.googleapis.com%2Fevents"

  • معیار دیگری به نام firebase/session_events با برچسب eventType وجود دارد و به صورت زیر تعریف می‌شود:

    logName="projects/ PROJECT_ID /logs/firebasecrashlytics.googleapis.com%2Fsession_events"

  در اینجا یک مثال از پرس‌وجوی PromQL آورده شده است که از این معیارهای مبتنی بر لاگ برای هشدار دادن در صورت کاهش نرخ خرابی به زیر ۷۰٪ استفاده می‌کند:

  1 - (sum by (project_id) (rate({__name__="logging.googleapis.com/user/firebase/crashlytics_events", errorType="FATAL"}[5m])) /
  sum by (project_id) (rate({__name__="logging.googleapis.com/user/firebase/session_events", eventType="SESSION_START"}[5m]))
  ) < 0.7