راه‌اندازی هشدار پیشرفته برای کانال‌های اعلان سفارشی

‫Firebase دو گزینه برای پیکربندی هشدارها و ارسال آن‌ها به کانال‌های اعلان سفارشی ارائه می‌دهد.

• (توصیه‌شده) راه‌اندازی و ارسال هشدارهای سفارشی به کانال‌های اعلان سفارشی

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

• ارسال هشدارهای پیش‌فرض Crashlytics به کانال‌های اعلان سفارشی

  می‌توانید از Cloud Functions برای ارسال هشدارهای Crashlytics پیش‌فرض به کانال‌های اعلان سفارشی استفاده کنید.

---

(توصیه‌شده) هشدارهای سفارشی راه‌اندازی و به کانال‌های اعلان سفارشی ارسال کنید

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

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

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

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

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

پیش‌نیازها

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

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

3. کانال‌های اعلان را راه‌اندازی کنید.

راه‌اندازی خط‌مشی هشدار

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

به‌عنوان بخشی از اجرای پُرسمان‌ها، می‌توانید هشدار مبتنی بر گزارش یا هشدار مبتنی بر SQL راه‌اندازی کنید:

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

  1. اجرای پُرسمان در 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

---

ارسال هشدارهای پیش‌فرض Crashlytics به کانال‌های اعلان سفارشی

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

در این موارد، می‌توانید از Cloud Functions for Firebase برای ارسال این هشدارهای Crashlytics پیش‌فرض به کانال‌های اعلان سفارشی استفاده کنید. برای مثال، می‌توانید تابعی بنویسید که رویداد هشدار را برای هشدارهای سرعت ضبط کند و اطلاعات هشدار را در سرویس طرف سوم، مثل Discord، Slack، یا Jira پست کند.

با این سازوکار هشدار پیشرفته، می‌توانید اطلاعات ارسال‌شده به سرویس طرف سوم را نیز سفارشی‌سازی کنید. برای مثال، علاوه‌بر اطلاعات پیش‌فرض ارائه‌شده توسط Firebase، می‌توانید پیوندهای عمیق مفید به کنسول Firebase یا اطلاعات عیب‌یابی مختص شرکت را نیز اضافه کنید.

برای راه‌اندازی قابلیت‌های هشدار پیشرفته بااستفاده از Cloud Functions for Firebase، این مراحل را دنبال کنید:

1. راه‌اندازی «توابع ابری ویژه Firebase»، که شامل تکالیف زیر می‌شود:

   1. محیط توسعه‌ای برای Node.js یا Python راه‌اندازی کنید.
   2. «میانای خط فرمان» Firebase را نصب کنید و به سیستم آن وارد شوید.
   3. ‫Cloud Functions for Firebase را بااستفاده از Firebase CLI مقداردهی اولیه کنید.

2. تابعی بنویسید و پیاده‌سازی کنید که رویداد هشدار را از Crashlytics ضبط کند و بار رویداد را مدیریت کند (برای مثال، اطلاعات هشدار را در پیامی در Discord پست کند).

برای آشنایی با همه رویدادهای هشدار Crashlytics که می‌توانید ضبط کنید، به مستندات مرجع هشدارهای Crashlytics بروید.

درباره رسیدگی به هشدارهای Crashlytics بااستفاده از Cloud Functions for Firebase بیشتر بدانید