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

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. اجرای پُرسمان در تجزیه‌وتحلیل گزارش‌ها.

  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